Exporting object definitions, views, and applications

Exporting definitions to a file is the first step in moving object definitions from one server to another. You can export multiple object types at a time.

 To export object definitions

1. In Developer Studio select File > Export.
   
2. Expand Developer Studio in the tree.
3. Select Object Definitions, and click Next.
4. Select the server from which to export objects, and click Next.
5. In the Export Objects dialog box, click Add to open the Add Items dialog box.
   
6. Perform the following actions:
   1. (Optional) In the Filtering Options area, use any of these methods to narrow the list of objects in the list:
   2. To find an object, enter the first few characters of its name in the Name field. For example, to find a form called Class Cost, enter "cla" or "class."
      • To show only the objects for a specific application, select an application from the Applications drop-down list.
      • To display specific types of objects, Use the Object Category check boxes to select categories. To select all categories, click Select All.
      • To find a specific object after you filter the list, enter the first few characters of an object name in the Locate field above the object list.
7. To sort the list of objects by name or type, click a column header.
   For example, to sort the objects by name, click the Name column header. By default, items are sorted in ascending order. To sort by descending order, click the column heading again.
8. Select the objects to export. (Use the CTRL or SHIFT key to select more than one object.)
9. From the Add Items with Related Properties drop-down list, select an option:
   • Object Only
   • Directly Related Objects
   • All Related Objects

   • Content
      The Directly Related option limits the scope of server objects when exporting shared workflow to a definition file. This option defines new rules for each workflow object, establishing parameters that restrict the objects that are related to include only the associations defined by the new rules for each type of workflow.
      The Content option is applicable only to container objects: applications, guides, and packing lists. If you select only Container object types in the Filtering Options, the Content option is displayed in the list. Selecting Content exports only the object in the container. The container and related objects are not exported.
     You can change the Related property for an object after you add it to the Export wizard page.

     The following table outlines how each object definition is exported with the Directly Related option.
     
     Items exported with Directly Related option

     The [liveData] macro is a standalone macro and it cannot be used inline. Click on this message for details.
     This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

     The All Related option moves an object and any objects that are related to it.
      The following table outlines how object definitions are exported with the All Related option.

     
      Items exported with All Related option

     The [liveData] macro is a standalone macro and it cannot be used inline. Click on this message for details.
     This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

     If you enabled Record Object Relationship on the Configuration tab of the AR System Administration: Server Information form, Developer Studio uses that data to find the related objects. See Setting-administrative-options.

     Tip

     When you export a large number of forms with many related objects, the export operation might time out and return an error. To avoid the time-out, export the forms and objects in two or more operations.

     
     

10. Click OK to close the Add Items dialog box. 
    The following dialog box appears.
    
11. To add more objects, click Add, and repeat steps 5 through 8.
12. To remove objects from the list or to change the Related property for objects, select the objects in the list and use the command buttons.
13. When the list is correct, click Next to select export options.
    
14. In the To File field of the Options page, verify the directory and file name for the object or objects being exported. Make any corrections necessary.
15. (Optional) Select the Save as Related Working List check box, and enter a name for the new working list. Related lists can be created from AR System Navigator by right-clicking the Working Lists node and selecting New Related List from the context menu.

16. Click Finish.
     The export begins. A progress bar appears as objects are exported. When the export is finished, the Progress tab displays an Export Complete message.

    Exporting .def files cleans up only known names on the AR System server. For example, if you log on to ServerA, the export cleans up all names found with ServerA. Your computer might not know ServerA and ServerA.domain.com are the same, so it does not clean up the fully qualified name or an alias name. Also, table fields and active links can point to other servers to gather data. Exporting with server independent does not clean up those names.

To export view definitions

1. In Developer Studio select File > Export.

   Warning

   After initiating an export operation, do not cancel it. The AR System server does not support the cancel option for exports, so attempting it might corrupt your files.

2. Expand Developer Studio in the tree.
3. Click View Definitions, and click Next.
4. Select the server containing the view or views to export, and click Next.
5. In the Export Views dialog box, click Add to select views to export.
   
6. In the View Selector dialog box, click Add to display a list of available views.
   
7. (Optional) Perform any of the following actions to filter the list of views available for exporting:
   • To find a view in the list, enter the first few characters of its name in the Name field. For example, to find a form called Application View, enter app or application in the Name field.
   • To show only views for a specific form, select a form from the Forms drop-down list.
   • To find a specific view after you filter the list, enter the first few characters of its name in the Name field above the view list.
   • You can sort the views in the list by name or type by clicking a column header. For example, to sort the views by name, click the Name column header.
8. Click the views to export.
9. In the To File field of the Export Views dialog box, enter the path for the directory to which to export the view.
10. Click Finish.
11. To export more views, click Add, and repeat steps 6 through 9. Otherwise, click Next.
     The export starts and a progress bar appears. When the export is finished, a Completed message appears.

 To export applications

1. Select File > Export.

   Warning

   After initiating an export operation, do not cancel it. The AR System server does not support the cancel option for exports, so attempting it might corrupt your files.

2. Expand Developer Studio in the tree.
3. Select Application, and click Next.
4. Select the server that contains the application or applications to export, and click Next.
   The Application Selection page lists the applications available for export from the selected server. You can sort the list by clicking a column header. For example, to sort applications by type, click the Type column heading. By default, items are sorted in ascending order. To sort by descending order, click the column header again.
   
5. Select the application or applications to export.
6. In the To File field, enter a path for the directory to which to export the application, and click Next.
7. In the Save As dialog box, select a destination directory and enter a file name for the application being exported, and click Finish.