|
This help topic is a step-by-step instruction of how you use Object Shopping to transfer a set of objects that form a functional whole.
In practice, this type of transfer is typically performed multiple times. Each time there are changes to your Business Area or Business Object, you repeat the transfer action so that the same changes are made in the target repository.
You indicate that objects form a functional whole by including them in the same container object: a Business Area, Business Object, Rule Set or Note Set.
As an example of a set of related objects, in this help topic, a Business Area is transferred.
| 1. | In the repository from which you want to export, make sure all the objects that you want to transfer are directly or indirectly contained by the Business Area. |
| For a clear understanding of how Business Areas contain objects, that may in turn contain other objects, go to the help topics on inclusion rules. |
| NOTE: You can create a Business Area named ALL that contains all the other Business Areas, or that otherwise contains all the objects in your repository. This way, you can use these step-by-step instructions to create a copy of your entire repository. |
|
| 1. | In the repository from which you want to export, from the USoft Definer main menu, choose Teamwork, Object Shopping, Definitions. |
| The Export Definitions window or tab opens. |
| 2. | In the Export field, type a name for the export, for example: MY_EXPORT. |
| 3. | In the Default Filename field, type a default filepath for the export file, for example: c:\temp\my-export.xml. |
| 4. | Click the Business Area tab. Using the lookup button, identify the Business Area that you want to transfer, or make a list of multiple Business Areas that you want to transfer in one go. |
|
| 1. | Press the Create File button in the top right corner. |
| The Create Export File dialog opens. See that you are about to export the specified business area(s) to the filepath you specified and that the export will be in XML format. |
| The export file is created in the location specified. It contains the Business Area(s) specified and all the objects directly or indirectly contained by this (these) Business Area(s). |
| You can open the file and inspect the contents you are about to transfer. |
|
| 1. | In the repository where you want to import the specified business area(s), open USoft Definer. |
| 2. | Open SQL Command by choosing Tools, SQL Command from the main menu or by clicking the SQL Command icon in the ribbon bar. |
| 3. | Type the following script: |
invoke xml.import with
select '<filepath>'
| where <filepath> points to the export file you want to import, for example: |
invoke xml.import with
select 'c:\temp\my-export.xml'
| 4. | Press the Execute button. |
| All the objects in the export file are added to the target repository. For each object that already exists by the same name in the target repository, content will be merged. |
|
See Also
Object Shopping
Quick Walk-Through: Shopping an individual object
Object shopping via the clipboard (copy-paste)
|
