Importing object definitions
This section describes how to import object definitions to a server. You can overwrite existing forms without deleting existing data or breaking links to workflow, and you can also import data along with a specified form.
When importing object definitions from files, remember the following points:
- You must first create a file that contains the object definitions to import by using the procedure described in Exporting object definitions, views, and applications.
- Before you begin importing, make sure that your database has adequate resources. Perform large imports during hours when users do not require access to the system.
- A server cannot have two objects with the same name. If an object in the import file has the same name as an object on the destination server, perform one of these tasks:
- Remove the object with the same name from the destination server
Rename the object with the same name on the destination server
When you import an overlay that has inherited properties, those properties are inherited from the copy of the origin object that is on the server. If you import the origin object with the overlay, then the overlay will inherit properties from the imported object. If not, then the overlay will inherit properties from the object already on the server.
- BMC Remedy Developer Studio cannot import definition (.def) files that are written in character sets other than UTF-8 or Western (Windows-1252) unless the charsets.jar file is installed in the JDKInstallationFolder\jre\lib folder.
To import object definitions from definition files
- You cannot compare association object in BMC Remedy Migrator.
- You cannot migrate your association object from .migrator or .def file to a server and from a server to a .migrator or .def file.
- Select File > Import.
- Expand BMC Remedy Developer Studio in the tree.
- Select Object Definitions, and click Next.
- Select the server to which to import definitions.
- Select the file (with a .def or .xml extension) that contains the definitions to import, and then click Open.
- Click Next.
- (Optional) If the object being imported is already on the destination server, click the Replace Objects on the Destination Server check box, which enables you to overwrite existing form definitions without deleting data or breaking workflow.
Replace Objects on the Destination Server — This check box informs the AR System Server to replace the display properties from the DEF file into the objects on the server. However, note that since it is the default behavior of the server, keeping this checkbox unchecked has no effect on server. This behavior is continued in version 9.x servers for backward compatibility reasons.
- Select any of the following options:
- Delete Excess Fields — Deletes fields on the server that are not present in the file.
- Delete Excess Views — Deletes views on the server that are not present in the file.
- Replace Display Properties — Replaces the display properties of the object on the destination server with the display properties of the object being imported.
- Replace Full Text options — Replaces the full text option of the object being imported with the value of the full text option for the object on the destination server.
Replace Application Owner — Replaces the Application Owner property of the object being imported with the value of the Application Owner property for the object on the destination server. This option is applicable for all objects within an application, except for free objects. When objects are added within an application, the property called AppOwner is set for these objects.
For example, if the definition file contains an object for which the AppOwner property is set to A and there is a same object on the destination server for which the AppOwner property is set to B, then this option allows you to set the AppOwner property of the object being imported, to the AppOwner value of the object on the destination server.
The objects within an application are expected to have the same value for the AppOwner property.
For requirements on using the Replace Objects on the Destination Server option, see Importing a join form using the Replace Objects on the Destination Server option.
Selecting objects to import
If you delete excess fields on the server, the associated data is deleted and any workflow might be broken.
- Select a Handle Conflicting Types option.
This option lets you decide on what path to take if field IDs are the same on the server and in the file, but the data types are different.
- Display Conflict Error (default) — Check for conflicting data types and report errors. The import not performed.
- Take No Action — Leave the field as it is on the server. Data is not overwritten during import.
Replace with New Type— Replace the field with the new type during import.
If you replace the field with the new data type, the original data stored in the field is deleted and workflow might not work.
- Select any of the following options:
- Click Finish.
If you attempt to import an application that is reserved by another user, the import operation fails with an error message. When you import objects that are reserved by another user, the reserved objects are skipped.
When the import is completed, an Import Complete message appears.
- Click OK.
Sequence of object import
The following table shows the sequence in which the objects will be imported:
Regular Form, Image, Archive Form
|Archive Main Form, Audit Form||1|
|Audit Main Form||2|
|Join Form||Base form Ranking + join levels|
|Menu||Highest form rank + 1|
|Field||Highest form rank + 2|
|Escalation||Highest form rank + 3|
|Filter||Highest form rank + 4|
|Highest form rank + 5|
|Container||Highest form rank + 6|
|Highest form rank + 7|
|Association||Highest form rank + 8|
Flashboards and its related objects
|Highest form rank + 9|
|Application||Highest form rank + 10|