Implementing Workflow Interactions
Workflow interactions principle
From a workflow instance you can act on one or several other workflow instances: this is a workflow interaction.
The workflow interaction calls:
• A source workflow: workflow from which the transition is triggered.
• A target workflow: workflow called from the source workflow.
Example: in the framework of a workflow on action plans, when a workflow is triggered, actions owned by the action plan must be triggered.
You can configure workflow interactions on:
• a workflow action
• a workflow condition
Configuration of a workflow interaction is carried out in two stages. You must use and configure:
• a workflow action macro
• a workflow interaction macro
Configuration of macros delivered as standard is explained in the HOPEX interface, in the tooltip describing the macro. Workflow interaction macros
Workflow action macros call workflow interaction macros, which indicate how to access target workflow instances from the source workflow instance.
to create a workflow interaction macro:
Implement the following method: String getWorkflowInstanceTarget
|
Context
|
as WorkflowContextAction,
|
|
mgcollWorkflowInstanceTarget
|
as MegaCollection
|
)
where:
• Context is the workflow interaction execution context. This context uses the WorkflowContextAction interface.
• mgcollWorkflowInstanceTarget is the collection of target workflow instances. It is empty: you must fill it.
Workflow interaction examples
With e-mail sending
A user triggers a final workflow transition from a design task. An e-mail is sent to the person responsible for the request for change (if there is a request for change). The e-mail is to be sent only if the request for change is in course of processing.
To configure this workflow interaction:
1. Create an action with the macro "Send mail from transition with interaction workflow", with the following configuration:
"Workflow=Target"
2. Use the workflow interaction macro "Interaction workflow defined with the Subject link on workflow action" with the following configuration:
[WorkflowInteraction]
SubjectLink = ~WceoJb1gEz7R[Motive system of task]
The link used is [Design task.Motive of task][WorkflowTargetCondition]
WorkflowStatus = ~AwMZq391FDML[Request in progress]
The e-mail is sent if the request for change is in "Request in progress" status.
With notification sending
As standard, an interaction exists between:
• the workflow definition of design tasks
• the workflow definition of requests for change
When the last task corresponding to a request for change is completed, a notification is sent to the owner of the request for change.
For more details on requests for change, see "Using Requests For Change", page 694.