How-To - Designer - Create a Work Request Using CIM

Version 2

    Solution

     

    This document describes how to configure a task in Workflow Manager to create a work request using the Process CIM Message subtask. Further information on this process is available here: WMS Integration Using CIM.

     

    Follow these steps to configure and execute a task to create a work request:

     

    1. Download the attached WRCIMXML.xml file.

    1. C:\temp\WRCIMXML.xml will be used as the file path in this example.

     

    2. Configure a task to create a work request using CIM

    1. Start the Process Framework Administration Tool and log in.
    2. Select the Node Types tab.
    3. Check Show filter node types.
    4. Select the UserWorkRequest node type.
    5. Click Add Task.
    6. Enter CIM Create Work Request in the Task Name field.
    7. Enter a description in the Task Description field.
    8. Check the Task Roles that are allowed to run the task.
    9. Double click on Process CIM Message in the Available Subtasks list to send it to Selected Subtasks.
    10. Highlight Process CIM Message in the Selected Subtasks list.
    11. Highlight Input XML Path in the Parameters list.
    12. Enter the file path (including the file name) that WRCIMXML.xml was saved to in the Parameter Values field. (C:\temp\WRCIMXML.xml in this example)
    13. Highlight Output XML Path in the Parameters list.
    14. Enter a path to a file (including the file name) to write the results of running the task to in the Parameter Values field. (C:\temp\WRCreateResults.xml in this example)
    15. Click OK.
    16. Select File > Save.

     

    3. Edit the XML file for use in the CIM Create Work Request task

    1. Edit the file. (C:\temp\WRCIMXML.xml in this example)
    2. Under the <Request> tag, change the following:
      1. Change <cim:aliasName>???</cim:aliasName> to the name of the work request. This populates the NAME field in process.MM_WMS_WORK_REQUEST.
      2. Change <cim:description>???</cim:description> to a description of the work request. This populates the DESCRIPTION field in process.MM_WMS_WORK_REQUEST.
      3. Change <cim:name>nnn</cim:name> to a numeric value. This populates the ID field in process.MM_WMS_WORK_REQUEST. It must be an ID that doesn't exist yet.
    3. Under the <Organization.WorkTaskRole> tag, change the following:
      1. Change <cim:name>???</cim:name> to the desired owner of the work request. This populates the CURRENT_OWNER_ID field in process.MM_WMS_WORK_REQUEST. This must match the USER_NAME field in process.MM_PX_USER.
    4. Save the file.

     

    4. Create a work request using the CIM Create Work Request task

    1. Start ArcMap.
    2. Start Workflow Manager and log in.
    3. Select My Work.
    4. Select CIM Create Work Request from the Available Tasks dropdown list and execute it.
    5. Check the results file (C:\temp\WRCreateResults.xml in this example) for the results of running the task. It will contain an <ActivityRecord> with a <cim:status> of Succeeded or Failed. If it failed there will also be a <cim:statusReason> tag with the error.
    6. Refresh My Work to see the new work request.