Specify flow completion attributes

You can specify the following flow completion criteria to specify when Process Manager should consider the flow complete and assign it a state:

Procedure

  • All work completes successfully or any work item fails. This is the default.
  • All selected work items end.
  • Any selected work items end. You can also specify what Process Manager should do when the state of the flow is determined
  • Complete any work in progress and stop running the flow. This is the default.
  • Change the flow state immediately but continue running the flow until any remaining work items that can complete, complete.
  • Continue running the flow and only change the state when any remaining work items that can complete, complete.
  • Determine the flow exit code either from the sum of exit codes of all work items in the flow(this is the default), or from the last finished work item in a successful flow, or the last failed item in a failed flow.

Assign a state to a flow when all work items are done

Procedure

  1. From the Action menu, select Specify Flow Completion Attributes, or right-click in a blank section of the flow definition, and select Completion Attributes. The Flow Completion Attributes dialog box appears.
  2. Leave the first option set to the default All work completes successfully or any work item fails.
  3. When a work item fails, you can either stop the flow or continue running the flow.

    To stop the flow if any work item fails:

    • If you want the flow to stop running if any work item exits but complete work that is currently running, leave the option as the default Complete any work in progress and stop running the flow .
    • If you want the flow to stop running if any work item exits and stop any running work items, choose Stop the flow and kill any running work items.

    To continue the flow if any work item fails:

    • If you want the flow to continue to run but change the flow state, select Change the flow state immediately and continue running the flow. This allows you to immediately trigger the next work item if there is one that is dependent on this flow or subflow.
    • If you want to continue to process as many jobs in the flow as possible, select Continue running the flow and when the flow is complete, change the flow state.
  4. Select how the flow exit code is calculated in Determine the flow exit code from.
  5. Click OK. The flow will be assigned a state when all of the work items complete successfully or any work item fails or is killed.

Assign a state to a flow when all selected work items end

Procedure

  1. From the Action menu, select Specify Flow Completion Attributes, or right-click in a blank section of the flow definition, and select Completion Attributes. The Flow Completion Attributes dialog box appears.
  2. Select All selected work items end.
  3. From the list of available work items, select those that must process before the flow can be assigned a state. Select each item and click Add> to move it to the list of selected items, or double-click on an item to move it to the other list.
  4. When all selected work items end, you can either stop the flow or continue running the flow.

    To stop the flow when all selected work items end:

    • If you want the flow to stop running but complete work that is currently running, leave the option as the default Complete any work in progress and stop running the flow .
    • If you want the flow to stop running and stop any running work items, choose Stop the flow and kill any running work items.

    To continue the flow when all selected work items end:

    • If you want the flow to continue to run but change the flow state, select Change the flow state immediately and continue running the flow. This allows you to immediately trigger the next work item if there is one that is dependent on this flow or subflow.
    • If you want to continue to process as many jobs in the flow as possible, choose Continue running the flow and when the flow is complete, change the flow state.
  5. Click OK. The flow will be assigned a state when all of the selected work items end.

Assign a state to a flow when any selected work item ends

Procedure

  1. From the Action menu, select Specify Flow Completion Attributes, or right-click in a blank section of the flow definition, and select Completion Attributes. The Flow Completion Attributes dialog box appears.
  2. Select Any selected work items end.
  3. From the list of available work items, select those that may process before the flow can be assigned a state. Select each item and click Add> to move it to the list of selected items, or double-click on an item to move it to the other list. When one item in this list ends, the flow will be assigned a state.
  4. When any selected work items end, you can either stop the flow or continue running the flow.

    To stop the flow when any selected work items end:

    • If you want the flow to stop running but complete work that is currently running, leave the option as the default Complete any work in progress and stop running the flow .
    • If you want the flow to stop running and stop any running work items, choose Stop the flow and kill any running work items.

    To continue the flow when any selected work items end:

    • If you want the flow to continue to run but change the flow state, select Change the flow state immediately and continue running the flow. This allows you to immediately trigger the next work item if there is one that is dependent on this flow or subflow.
    • If you want to continue to process as many jobs in the flow as possible, choose Continue running the flow and when the flow is complete, change the flow state.
  5. Click OK. The flow will be considered complete when one of the selected work items ends.

Continue processing when the state of the flow is determined

Procedure

  1. From the Action menu, select Specify Flow Completion Attributes, or right-click in a blank section of the flow definition, and select Completion Attributes. The Flow Completion Attributes dialog box appears.
  2. If you want the work item to continue to run but change the flow state, select Change the flow state immediately and continue running the flow. This allows you to immediately trigger the next work item if there is one that is dependent on this flow or subflow. New time, file, and proxy events in the flow that are set to trigger jobs are not considered when continuing to run the flow. After determining the flow state, Process Manager does not evaluate these events.
  3. Click OK. When the flow is considered complete and assigned a state, any eligible work items in the flow will continue to process until Process Manager cannot run any more work, or until the remaining work is dependent on events or has dependencies that cannot be met. The flow is then stopped.

Continue processing and only change the state after the flow is complete

Procedure

  1. From the Action menu, select Specify Flow Completion Attributes, or right-click in a blank section of the flow definition, and select Completion Attributes. The Flow Completion Attributes dialog box appears.
  2. If you want to continue to process as many jobs in the flow as possible Continue running the flow and when the flow is complete, change the flow state.
  3. Click OK. The flow will continue to run and only change state once Process Manager cannot run any more work, or until the remaining work is dependent on events or has dependencies that cannot be met.