Copying objects from another system

To reuse objects from another Ricoh ProcessDirector system, you can use the other system to export them. On this Ricoh ProcessDirector system, you can import the objects rather than recreating them manually.

You can export and import objects such as input devices, workflows, printers, media objects, notifications, servers, step templates, user names, groups, and locations. You can also export and import some objects added by features or extensions.

  • Before you import an object that has the same name as an existing object of the same type, make sure that the existing object is disabled. If the object is an input device, also make sure that it is disconnected.

    When you import the new object, the existing object is updated to match the new one.

  • Before you import an input device or printer whose Parent server property has any value other than System, make sure that the parent server has been added as a secondary server. Make sure that the secondary server has been enabled and connected to the primary server.
  • You cannot import objects added by a feature or extension that is not installed on this system.
  • Before you import a notification, you must import the user names and groups specified on the Recipient address, Copy address, and Blind copy address properties if they do not exist on the system.
  • If you are using the Preprinted Forms Replacement feature, export the file before you import media objects with electronic forms. Follow the instructions in the help system for exporting media objects with electronic forms.
  • When you import step resources, the files that they refer to are not included in the export package. Copy the files referenced in the step resources from the export system to the import system manually. You must copy the files to the import system before you import the step resource objects.
    • To import all the step resources, copy the contents of /aiw/aiw1/StepResources from the export system into the same directory on the import system.
    • To import specific step resources, open the XML file that you exported. Find the entry for each step resource that you exported and locate the StepResource.File property. In that value, find the name of the RSC file associated with that step resource. For example, in this value:
      • <property name="StepResource.File" value="{&quot;fileName&quot; : &quot;/aiw/aiw1/StepResources/1992052c6ef44a229b8b43d77232bf53.rsc1992052c6ef44a229b8b43d77232bf53.rsc&quot; , &quot,&quot;displayName&quot; : &quot;Ricoh_Export-2019-08-26_13-30-04.xml&quot;}"/>

      The file name is: 1992052c6ef44a229b8b43d77232bf53.rsc

      Find the file on the export system and copy it into the same directory on the import system.

  • You can export objects from a primary server running on one operating system and import them on a primary server running on a different operating system.

    If you import any step templates based on the RunExternalProgram step template, you must update the External command and External control file template properties for those templates.

To copy objects from another system:

  1. Click the Administration tab.
  2. In the left pane, click UtilitiesImport Objects.
  3. In the File to import field, click to select the XML file that contains the properties of exported objects.
    The default name of this file is Ricoh_Export_timestamp.xml. The administrator who exported the objects might have given the file a different name.
    • If you exported media objects with electronic forms, the name of the file is media.xml. It is in this directory:
      • /aiw/aiw1 on AIX and Linux
      • C:\aiw\aiw1 on Windows

    If you have another file containing exported objects that you want to import, you can enter another filename and the objects in that file are added to the list.

  4. Select the objects that you want to import.
  5. To make sure that you do not update objects that exist, click Deselect existing objects.
  6. Click Import.
  • Credential objects may be contained in the file you import if they were included as references in workflows, step templates, or input devices. The imported credential objects cannot be used until you re-enter values for the User name and Password properties on the imported system.