This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

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

      Note

      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

Note

  • 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.
  1. Select File > Import.
  2. Expand BMC Remedy Developer Studio in the tree.
  3. Select Object Definitions, and click Next.
  4. Select the server to which to import definitions.
  5. Select the file (with a .def or .xml extension) that contains the definitions to import, and then click Open.
  6. Click Next.
  7. (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.
    1. 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.

        Note

        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

        Warning

        If you delete excess fields on the server, the associated data is deleted and any workflow might be broken.

    2. 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.

        Warning

        If you replace the field with the new data type, the original data stored in the field is deleted and workflow might not work.

  1. 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.
  2. Click OK.

Sequence of object import

The following table shows the sequence in which the objects will be imported:

ObjectsRank

Regular Form, Image, Archive Form

0
Archive Main Form, Audit Form1
Audit Main Form2
View Form3
Join FormBase form Ranking + join levels
Menu Highest form rank + 1
FieldHighest form rank + 2
EscalationHighest form rank + 3
FilterHighest form rank + 4

Active Link

Highest form rank + 5
ContainerHighest form rank + 6

Packaging List

Highest form rank + 7
AssociationHighest form rank + 8

Flashboards and its related objects

Highest form rank + 9
ApplicationHighest form rank + 10
Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Colin Rolls

    some more info on the order the different object types are handled during import would be good here. for example, I import a new form with new related active link at the same time, the form would be imported first then the active link. and if I import a new form with an unrelated active link what order would the import happen now? does the import process check for relationships to define the order or does it just import in a certain object order every time?

    Jan 22, 2016 04:52
    1. Prachi Kalyani

      Thank you, Colin. We will update the documentation soon.

      Thanks,

      Prachi

      Jan 22, 2016 05:10
    1. Prachi Kalyani

      Hello Colin,

      Sorry for the deplay in response.

      The following table show the rank in which the objects will be imported:

      ObjectsRank

      Regular Form, Image, Archive Form

      0
      Archive Main Form, Audit Form1
      Audit Main Form2
      View Form3
      Join FormBase form Ranking + join levels
      Menu Highest form rank + 1
      FieldHighest form rank + 2
      EscalationHighest form rank + 3
      FilterHighest form rank + 4

      Active Link

      Highest form rank + 5
      ContainerHighest form rank + 6

      Packaging List

      Highest form rank + 7
      AssociationHighest form rank + 8

      Flashboards and its related objects

      Highest form rank + 9
      ApplicationHighest form rank + 10

      Hope this helps!

      Thanks,

      Prachi

      Apr 01, 2016 12:29
  2. Tony Reel

    Note 7 is missing a description for the "Replace Display properties" option

    Aug 24, 2017 10:02
    1. Anagha Deshpande

      Hello Tony,

      Thank you for bringing this to our notice. I will update the topic soon.

      Regards,

      Anagha 

      Aug 28, 2017 03:19
      1. Anagha Deshpande

        Hello Tony,

        I have added the description for Replace Display properties check box.

        Regards,

        Anagha

        Sep 19, 2017 11:51
  3. Anil Umate

    Hi,

    We can not see the description for option "Replace Display properties" Check box.

    can you please add this?

    Apr 23, 2018 07:30
    1. Anagha Deshpande

      Hello Anil,

      I will check with the SME and will update the description.

      Regards,

      Anagha

      Apr 23, 2018 10:40
      1. Anil Umate

        Hi Anagha,

        Please share the description, if you checked with SME.

        Aug 24, 2018 07:05
      1. Anil Umate

        Can you please update about my last query?

        Jul 16, 2019 11:11
        1. Anagha Deshpande

          Hello Anil,

          Apologies for the delay.

          We will respond soon.

          Regards,

          Anagha

          Jul 16, 2019 11:27
    1. Himanshu Raul

      Hi Anil,

      Thank you for your comment. We have updated the topic.

      Regards,

      Himanshu

      Jul 31, 2019 05:05