Workflow from document flow process

The ProcessWorkflow BOD is used to start a workflow from a workflow activity. You do not have to model or send this message. In ION the ProcessWorkflow BOD is automatically created based on the modeled workflow activity.

When a document is received by a workflow activity, these actions are taken:

  1. The values of the attributes that are required as input for the workflow, are extracted from the document.
    Note: 
    • If the selected attribute occurs multiple times in the document then only the first value is used as input for the workflow.
    • If the selected attribute does not occur in the document then the workflow is started without a value for the input parameter. This only works if the workflow input parameter has 'Use Initial Value if Null' selected in the workflow modeler.
    • If repeating attributes are mapped to a structure, the workflow structure contains as many levels as repetitions. This depends on the mapping definition and if filtering is modeled.
  2. The request to start the workflow (ProcessWorkflow) is built and sent to the workflow engine.
  3. The workflow is started and a copy of the original document is saved.
  4. After the workflow completes, the output of the workflow, the AcknowledgeWorkflow, is sent back to the workflow activity.
  5. If no next activity exists in the document flow then the output of the workflow is ignored.

If a next activity exists then the copy of the original document is retrieved. The output parameters from the workflow are merged into the document and the document is sent to the next step in the document flow.

Note: 
  • If the attribute that is linked to the workflow output parameter already exists then the existing value is overwritten.
  • If the attribute does not yet exist then it is added to the document.
  • If the attribute occurs multiple times in the document then only the first value is updated.
  • Structures cannot be used as output, they do not change the document.