Prepare XML file for automatic import

You can prepare an XML file that contains only your user-defined object store components.

These procedures show you how to create an object store manually. You can use this object store as a prototype for testing the imported objects. This can help you to detect and fix any duplicate entries before using the XML file for automatic imports—when duplicate entries may cause object store creation to fail.

To prepare an XML file for automatic import

  1. Create a new object store. For details, see Create an object store.

    TIP
    During object store creation, watch the status messages as the wizard imports the default objects from the XML files that come with your installation. This can help you understand how setting up a user-defined XML file for automatic import can affect object store creation.
  2. Add new classes, objects, properties, and content that you want added to every new object store.
  3. For each user-defined class or object you add to the object store:
    1. Right-click the top-level object and select Add to Export Manifest from the context menu.

      TIP
      Do not select any of the default objects or include any associated objects. For example, do not right-click the Choice Lists node when you select this option. Instead, select Choice Lists node to display all defined choice lists in the details pane. Multi-select all choice lists in the details pane, then select Add to Export Manifest from the context menu.
    2. In the Include Options screen, select only user-defined options that you haven't already added to the export manifest.

      TIP
      Depending on the type of objects, choose either Do not included any associated objects or Select associated objects to be included manually. If you include all associated objects, you're more likely to create duplicate entries since you can't review which objects are associated with the selected object.
    3. Click OK.
  4. Right-click Export Manifest and select Export All Objects from the context menu.
  5. Rename the default XML file and log file to help you identify this set of object store components, then click OK.
  6. Create a new object store you can use for testing this XML file. For details, see Create an object store.
  7. Right-click the new object store and select All Tasks > Import All from the context menu.
  8. In the Import Helper screen:
    1. Select the XML file created in Step 5.
    2. Change the log file name to one that matches the name of the XML file.
    3. Clear these check boxes as appropriate:
      • Append if file already exists: If you are using an existing log file, clearing this check box overwrites any existing messages.
      • Ignore duplicate error messages during import: When this option is selected during an import, the status messages show duplicate errors as "Ignoring Duplicate Import Error - <Object Type>". After importing objects with duplicate errors, the Import Helper displays a successful import message. This option does not change or remove the errors recorded in the log file. If you clear this check box prior to importing duplicate objects, the Import Helper displays a message that reminds you to check the log file for errors.
    4. Click Import.
  9. Watch the status messages displayed as the Import Helper imports objects.