Using ObjectManager to move objects

This example shows how an IBM OpenPages® with Watson™ administrator can move a process object from the folder location /ENTITY02 to /ENTITY01.

Before you begin

This solution assumes that the administrator knows the following:

The contents of TechNote # 1648075 that explains the difference between system folder location and associations.
The system-level folder name of the object.

The target folder location already exists. Otherwise, the following validation will occur:

VALIDATION ERROR (Line: 967 Column: 89): Target Folder Resource (/_op_sox/Project/Default/ICDocumentation/Processes/SampleFolder001) does not exist.

About this task

The following is the syntax for moving objects using the ObjectManager tool:

<openpagesConfiguration xmlFormatVersion="1.31">
     <moveResources>
        <targetFolder name="{fullpath of target folder}">
             <sourceResource name="{fullpath of the object to be moved}"/>
        </targetFolder>
     </moveResources>
</openpagesConfiguration>

Procedure

Log on to the application server.
Open a text editor.
Copy the previous syntax example.

Update the example to reflect the target folder location(s) and source folder location(s).

For example:

<openpagesConfiguration xmlFormatVersion="1.31">
<moveResources>
<targetFolder name="/_op_sox/Project/Default/ICDocumentation/
    Processes/ENTITY01">
<sourceResource name="/_op_sox/Project/Default/ICDocumentation/
    Processes/ENTITY02/PROC01.txt"/>
</targetFolder>
</moveResources>
</openpagesConfiguration>

Save the file using the an ObjectManager name (e.g., samplemove-op-config.xml).
Open a command prompt or shell. Alternatively, you can use > System Migration > Import Configuration to import the XML file. For information, see Importing a migration file.
Go to OP_HOME/bin where OP_HOME represents the installation location of the OpenPages with Watson application.

Run the command to load the ObjectManager file.

The following is the sample output for the working example:

D:\OpenPages\bin>ObjectManager l c 
OpenPagesAdministrator OpenPagesAdministrator 
D:\temp samplemove

OpenPages V8.1.0.0 (Build: OP_8.1-270 2019/09/06 19:17:21) starting ...
OpenPages Global environment initialized.
==============================
Object Manager Admin Utility V8.1.0.0 (Build: OP_8.1-270 2019/09/06 19:27:49)
==============================

List of command line arguments:
        Arg 1: <l>
        Arg 2: <c>
        Arg 3: <OpenPagesAdministrator>
        Arg 4: <****>
        Arg 5: <D:\temp>
        Arg 6: <samplemove>
Total number of arguments: 6
OpenPages Server environment initialized.

Loading OpenPages Configuration (samplemove) from folder: 'D:\temp' ...

Processing started at Thu Apr 05 15:51:29 EDT 2013

Processing Move Resource Requests ...
      1 total

Move Resource requests processed: 1

Total Objects processed: 0

Total Requests processed: 1

Total Validation Errors: 0

Total Exceptions: 0

Processing finished at Thu Oct 03 15:51:29 EDT 2019
Elapsed time: 347 milliseconds

Restart the OpenPages services. For more information, see Starting and stopping servers.

If an administrator needs to move multiple objects via ObjectManager, the following is the sample syntax:

<openpagesConfiguration xmlFormatVersion="1.31">
  <moveResources>
     <targetFolder name="{target fullpath folder for object 1}">
     <sourceResource name="{fullpath of the object 1 to be moved}"/>
     </targetFolder>
     <targetFolder name="{target fullpath folder for object 2}">
     <sourceResource name="{fullpath of the object 2 to be moved}"/>
     </targetFolder>
     <targetFolder name="{target fullpath folder for object 3}">
     <sourceResource name="{fullpath of the object 3 to be moved}"/>
    </targetFolder>
  </moveResources>
</openpagesConfiguration>