Collapse All Expand All

Version: 10.1

Resource Center Home

Below is a list of the subtasks available for use with Workflow Manager, the criteria necessary for them to be enabled, and the steps that are performed when they are executed. Many of these subtasks are named after the task with which they are associated. You may create custom subtasks (see Customizing Process Framework). Use the Process Framework Admin Tool to group subtasks and create custom tasks.

Approve Design performs actions that should occur when a design is approved.

Enabled

Execute

1. Sets the Approved Date and Approved By fields on the design node.
2. Enters the design’s ID in the MM_WMS_APPROVED_DESIGNS table.
3. Looks for the ConstructOnApprove value in the MM_PX_CONFIG table. If the ConstructOnApprove value is false, the subtask is complete. If this configuration value is true, the subtask gets the design’s parent node and checks to see that it is a work request. If the parent node is a work request, the Construct Work Request task is executed on the parent node to set its state to In Construction.

Approve Imported Design approves a design on the enterprise after it has been approved in the field and imported into the enterprise database.

Enabled

Execute

1. Check to see if the design has been approved and skips the design if it has not been approved.
2. If any design in the same work request has already been approved, it will be unapproved.
3. Approves the imported design on the enterprise.
4. Checks the MM_PX_CONFIG table to see if the ConstructOnApprove flag has been set. If it is set, the Work Request will be given a state of In Construction.

Begin Construction executes the Construct Work Request task on the design’s parent work request if it is necessary.

Enabled

Execute

1. If the ConstructOnApprove configuration value is false, the subtask gets the design’s parent and checks to see if it is a work request. If the parent node is a work request, the Construct Work Request task is executed on the parent node to set its state to In Construction.

Change Design's Owner to Mobile User allows the user to change the owner of a design to a mobile user.

Enabled

Execute

1. Allows the user to select from a list of mobile users.
2. Assigns design to the chosen user.

Parameters

Change Owner allows the user to assign the work request or design to another user.

Enabled

Execute

1. Checks to see that the node is a design or work request.
2. Finds a list of users that have the roles necessary to access the current node.
3. Asks the user to specify a new user.
4. Attempts to transfer ownership of the node to the selected user.
5. If design is open in ArcMap, it will be closed.

Parameters

Change Owner to Include All Users changes the owner of a design to another user.

Enabled

Execute

1. Identifies the users with the appropriate roles assigned to own the selected node.
2. Allows the user to select from a list of valid users.
3. Assigns the node to the chosen user.

Parameters

Change Owner to Self changes the owner of the selected node to the current user.

Enabled

Execute

1. Changes the owner of the node to the current user.

Close Design closes a design that has been opened in ArcMap.

Enabled

Execute

1. Closes the open design.
2. Sets the PxApplication on the Process Framework Tasks tool extension to nothing.

Close Express Design closes an express design that has been opened in ArcMap.

Enabled

Execute

1. Prompts the user to save any outstanding edits.
2. Checks for conflicts.
3. Reconciles and posts the design.
4. Closes the express design.
5. Marks the design's version for deletion (unless it has been opened for as-built editing).
6. Sets the PxApplication on the Process Framework Tasks tool extension to nothing.
7. Enables the Stored Items tools.

Close Express Design with GDBM closes an express design and supports integration with Geodatabase Manager. Geodatabase Manager provides the GDBM Set Posting Priority which reconciles and posts designs using a batch process.

Enabled

Execute

1. Prompts the user to save any outstanding edits.
2. Checks for conflicts.
3. Reconciles and posts the design.
4. Closes the express design.
5. Sets the PxApplication on the Process Framework Tasks tool extension to nothing.
6. Enables the Stored Items tools.

Parameters

Confirm verifies that the user wishes to continue.

Enabled

Execute

1. Displays a message box that asks the user if she wishes to continue. If the user selects no, this subtask returns false and subsequent subtasks will not be executed.

Confirm Delete Staking Job verifies that the user wishes to continue deleting the selected staking job.

Enabled

Execute

1. Displays a message box that asks the user if she wishes to continue. If the user selects no, this subtask returns false and subsequent subtasks will not be executed.

Copy Design allows you to create a copy of an existing design.

Enabled

Execute

1. User interface prompts user for set-up information.
2. Creates WR (if user specified "create new WR").
3. Creates new design(s) based on number of copies entered by user.
4. Copies the contents of the original design to the new design(s) depending on the set-up information entered.

Create Design adds a new design node to an existing work request.

Enabled

Execute

1. Calls Terminate on Process Framework’s active control if the active control is an IMMPxControl2. This gives the form displayed in Process Framework a chance to cancel this operation or to take some action before it is replaced by the design’s control.
2. Creates a new design node.
3. Sets these properties on the design: Work Request ID, Create Date, Design Number, default design name.
4. Adds the node to the TOC.
5. Sets the build object.
6. Calls the "Create Design" transition programmatically. If the transition does not exist it sets the design node's state to the initial state set in the Node Types tab.

 Create Work Request adds a new work request node.

Enabled

Execute

1. Creates a new work request.
2. Sets these properties on the work request: default work request name and description, and current owner.
3. Adds the node to the TOC.
4. Sets the node’s build object.

Delete removes the node and attempts to remove all of the associated version data from ArcMap. If it cannot remove the version data from ArcMap, the data is marked as orphaned and may be deleted using the Clean Up tool.

Enabled

Execute

1. Closes the design if it is open in ArcMap.
2. Calls the node’s deleter object.
3. Deleting a design may change the state of its parent work request. The work request state will be set to Initiated if the parent work request does not have any children. If the work request has children, the state of the work request will be based on the state of the children. If the work request is in the Complete state, the state of the work request will not be changed.

Delete Sibling Designs deletes all designs in the work request except the one selected when this subtask is performed. You may use this subtask in conjunction with subtasks such as Verify Design or Begin Construction to delete alternate designs from a work request when one is approved. This subtasks also requires the existence of a task called Delete No Prompt. The Delete No Prompt task should include the following subtasks (in order): Does user own work request or design?, Is design locked?, Delete. Note that there is no subtask to confirm deletion. Refer to the sample data to see how tasks are configured.

Enabled

Execute

1. Prompts the user to confirm deletion.
2. Gets the parent work request.
3. Compiles a collection of siblings.
4. Passes in the selected design.
5. Deletes each sibling and retains the design passed in.

Design Cost Report displays the cost of a design.

Enabled

Execute

1. Generates a cost report for the design.
2. Converts the cost report to HTML using an XSL style sheet.
3. Displays the design cost report.

Does User Own Work Request or Design Node? checks to see if the user is also the current owner.

Enabled

Execute

1. Always returns true.

Incremental Copy Design copies a design but NOT its compatible units.

Enabled

Execute

1. Creates a new work request.
2. Copies the design node to the new WR. Any CUs associated with the design are NOT copied.

Is Design Locked? checks the design to determine if the opened design is locked.

Enabled

Execute

1. Always returns true.

Is Design Open? checks the design to determine if it is open.

Enabled

Execute

1. Always returns true.

Is Express Design? checks to see if the selected design is enabled for Designer Express. This subtask determines the design type using the product family type table.

Enabled

Execute

1. Always returns true. 

Is Standard Design? checks to see if the selected design is enabled for Designer (and not Designer Express). This subtask determines the design type using the product family type table.

Enabled

Execute

1. Always returns true. 

Mobile Approve Design executes the approve design task so the design will be in the proper state (approved) before it is sent to the enterprise by another subtask.

Enabled

Execute

1. Executes the Approve Design task.

Mobile Reject Design changes a mobile design’s status to In Design and allows the user to assign it to another user.

Enabled

Execute

1. Executes the Reject Design task.

Mobile Submit Design changes the mobile design’s status to Pending Approval and allows the mobile user to assign it to an approval officer.

Enabled

Execute

1. Executes the Submit Design task.

Move Design assigns a design to a different work request.

Enabled

Execute

1. Compiles a list of all available work requests and presents it to the user for selection. This list excludes the selected design’s parent work request and any work requests that have an approved design.
2. Moves the design to the selected work request.
3. If the selected design has been approved, the MM_WMS_APPROVED_DESIGNS table is updated.
4. If moving the design affects the state of the source work request, then there must a valid transition defined that allows the work request state to change before adding the destination work request to the list.

Normal Copy Design copies a design and its compatible units.

Enabled

Execute

1. Creates a new work request.
2. Copies the design node and its associated compatible units to the new WR.

Open Design opens the design node in ArcMap.

Enabled

Execute

1. Calls Terminate on Process Framework’s active control if the active control is an IMMPxControl2. This gives the form displayed in Process Framework a chance to cancel this operation or to take some action before it is unloaded.
2. Opens the design.
3. Sets the PxApplication on the Process Framework Tasks Tool extension.

Open Express Design opens the selected design for editing in Designer Express.

Enabled

Execute

1. Gets the express design.
2. Determines whether the express design should be opened as View Only.
3. Creates the workspace for the express design.
4. Opens the express design and updates the MM_PX_Versions table to indicate the design exists.
5. Sets the PxApplication on the Process Framework Task Tool extension.
6. Enables the Active Annotation Target tool.
7. Disables the Stored Items tool.

Open Express Design for As-Built Editing opens the selected design for as-built editing in Designer Express.

Enabled

Execute

1. Gets the express design.
2. Determines whether the express design should be opened as View Only.
3. Creates the workspace for the express design.
4. Opens the express design and disables the Design Palette tab.
5. Updates the MM_PX_Versions table to indicate the design exists.
6. Disables the Stored Items tool.

Open Redline Design opens a design for redline (graphic) editing in ArcFM Viewer for ArcGIS Engine.

Enabled

Execute

1. Gets the design.
2. Creates a Mobile packet if one does not already exist for the design.
3. Determines whether the design should be opened as View Only.
4. Loads the design's stored display (if it exists).
5. Loads the design's Mobile packet.
6. Activates the mobile graphics layer.
7. Sets the PxApplication on the Process Framework Task Tool extension.

Open Staking Design opens the selected design for editing in Designer Staker.

Enabled

Execute

1. Gets the design.
2. Creates a Mobile packet if one does not already exist for the design.
3. Determines whether the design should be opened as View Only.
4. Loads the design's stored display (if it exists).
5. Loads the design's Mobile packet.
6. Activates the mobile graphics layer.
7. Sets the PxApplication on the Process Framework Task Tool extension.

Output CIM XML writes information about the selected design or work request node to a CIM-compliant XML file.

Enabled

Execute

1. If an input dictionary key is provided, looks in the task dictionary for XML message.
2. If input XML path is provided, gets the XML message.
3. If neither input parameter has a value, prompts the user for an XML file and retrieves the XML message from the path provided by the user.
4. Opens XML and processes according to verb provided. If New Verb parameter has a value, uses this verb to process.
5. If output dictionary key is provided, writes the XML for the selected node to the task dictionary.
6. If output XML path is provided, writes to a local XML file.
7. If neither output parameter has a value, prompts the user for a path to where the XML file should be written and writes out the XML.

Parameters

Process CIM Message Looks at the request noun and verb of a CIM-compliant message, and forwards the message to the appropriate processor.

Enabled

Execute

1. If an input dictionary key is provided, looks in the task dictionary for XML.
2. If input XML path is provided, gets the XML.
3. If neither input parameter has a value, prompts the user for an XML file and retrieves the XML from the path provided by the user.
4. Opens XML and processes.
5. If output dictionary key is provided, writes the XML to the task dictionary.
6. If output XML path is provided, writes to a local XML file.
7. If neither output parameter has a value, prompts the user for a path to where the XML file should be written and writes out the XML.

Parameters

Reconcile Design reconciles the parent version to the current design.

Enabled

Execute

1. Determines whether the DefineConflictsByColumn configuration value is set in the Process Framework Admin Tool. If this value is set to 1, conflicts are defined by column. If this value is set to 0 or not set at all, conflicts are defined by row.
2. Reconciles the parent version to the open design.

Refresh Database Connection: This subtask is currently not in use and will always remain disabled.

Reject Design changes the design’s status to In Design and allows the user to assign it to another user.

Enabled

Execute

1. Prompts the user to select a new user.
2. Attempts to transfer ownership.
3. Tells the builder that the user has changed so it can update the tree if necessary.
4. If ownership is changed, the design is closed.

Re-send Design to Field executes the Send to Field task if the node’s current owner has the Mobile role assigned.

Enabled

Execute

1. Gets the node's owner.
2. Executes the Send Design to Current Field Owner task if the node's owner has the Always Mobile role assigned.

Save Design saves the current open design.

Enabled

Execute

1. Saves the design.

Send Design identifies whether the user is in the field or on the enterprise and executes the appropriate task: Send Design to Enterprise or Send Design to Field.

Enabled

Execute

1. Checks to see if the user is in the field or on the enterprise.
2. If the user is in the field, executes Send Design to Enterprise task.
3. If the user is on the enterprise, executes the Send Design to Field task.

 

Send Express Design to GIS identifies whether the user is in the field or on the enterprise and executes the appropriate task: Send Design to Enterprise or Send Design to Field.

Enabled

Execute

1. Checks to see if the user is in the field or on the enterprise.
2. If the user is in the field, executes Send Design to Enterprise task.
3. If the user is on the enterprise, executes the Send Design to Field task.

 Send to Enterprise takes a design from the mobile environment and puts it back on the enterprise server.

Enabled

Execute

1. Gets the parent node of the selected design.
2. Closes the design if it is open in ArcMap.
3. Adds the packet to the transporter.
4. Deletes the design and work request if it doesn't contain another design.

Send to Field takes a design from the enterprise server and puts it in the mobile environment.

Enabled

Execute

1. Creates a mobile packet if one does not already exist.
2. Closes the design if it is open in ArcMap.
3. Saves the mobile packet.
4. Adds the mobile packet to the transporter.

Set to Express Design changes the product type of the selected design to be an express design.

Enabled

Execute

1. Gets the design.
2. Sets the mmWMSDesignerProductType enumeration value to mmExpress.

Set to Stake Job changes the product type of the selected design to be a stake job.

Enabled

Execute

1. Gets the design.
2. Sets the mmWMSDesignerProductType enumeration value to mmStaker.

Set to Standard Design changes the product type of the selected design node (e.g., express design or stake job) to be a design.

Enabled

Execute

1. Gets the design.
2. Sets the mmWMSDesignerProductType enumeration value to mmDesigner.

Submit Design changes the design’s status to Pending Approval and allows the user to assign it to an approval officer.

Enabled

Execute

1. Prompts the user to select an approval officer.
2. Attempts to transfer ownership.
3. Tells the builder that the user has changed so it can update the tree if necessary.
4. If ownership is changed, the design is closed.

Transition Stake Job to Enterprise transitions the selected stake job and its work request to "In Construction" before it is sent to the Enterprise.

Enabled

Execute

1. Executes the Construct Work Request task on the work request that contains the selected design.

Undo Approve Design changes the design’s status from Approved to Pending Approval.

Enabled

Execute

1. Removes the values for the Approved Date and Approved By ID properties in the design.
2. Removes the corresponding entry in the MM_WMS_APPROVED_DESIGNS table.

Undo Begin Construction calls a task that changes the work request’s status from In Construction to In Design.

Enabled

Execute

1. Transitions the design’s parent work request to In Design by executing the Undo Construct Work Request task.

Verify Design posts the design and changes the work request’s state to Complete before removing it from the TOC. Completed work requests may be viewed using the Completed Work filter.

Enabled

Execute

1. Post the design.
2. Transitions the design’s parent work request to Complete by executing the Complete Work Request task.
3. Sets the work request node to hidden.

 

 

---

Send Comment to ArcFMdocumentation@schneider-electric.com