Configuring Workflow State Conversions
After new workflow definitions are deployed for Appointment or Job workflows, associated Workflow State Conversion records are generated. Workflow state conversions define coupled state transitions between source and target objects. To configure workflow state conversions, you specify how the state of a target object (for example, Job) changes based on the state change of a source object (for example, Appointment). Workflow state conversions work in the same way as status conversions in BPM.
To configure workflow state conversions:
1. In Max Designer, on the Developer Tools (
) launchpad menu, click Workflow State Conversions.
) launchpad menu, click Workflow State Conversions.2. In the list view, in the top left corner, click Create (
), and then in the Workflow State Conversion form, complete the fields as follows and click Save (
).
), and then in the Workflow State Conversion form, complete the fields as follows and click Save ().Field | Description |
|---|---|
Name | Display name for the state conversion. |
Source Object | Changes to this object trigger this state conversion. |
Target Object | Object modified by this state conversion. |
Object Relationship | Relationship between source and target objects. |
Source Workflow Definition | Workflow definition to which source object states belong. |
Target Workflow Definition | Workflow definition to which target object states belong. |
Source Execution Condition | Groovy code that determines whether source records trigger state change for target records. Returns a Boolean value. If not specified, source records trigger state transitions for target records. For code syntax details, click the field label. |
Target Execution Condition | Groovy code that determines whether target records change state based on state transitions of source records. Returns a Boolean value. If not specified, target records change state. For code syntax details, click the field label. |
Fallback | Groovy code that is executed when expected next workflow states of target records are unreachable from current workflow states. Not executed for exceptions or other errors generated during state conversion. Returns true if logic can handle the issue, or false otherwise. If not specified, com.intalio.core.seed.internal.workflow.exceptions.UnreachableStateException is thrown. For code syntax details, click the field label. |
 | Each active Workflow State Conversion record must have a unique set of field values for Template, Source Object, and Target Object. No two active Workflow State Conversion records can have the same set of field values for: • Source Object • Target Object • Object Relationship • Invert Relationship Direction • Source Workflow Definition • Target Workflow Definition |
3. In the Workflow State Mappings tab, in the top right corner, click Create (), and then in the Create New Workflow State Mapping dialog box, complete the fields as follows:
), and then in the Create New Workflow State Mapping dialog box, complete the fields as follows:Field | Value |
|---|---|
Source Record Original State | State of source records before any transitions occur. If not specified, the target record transitions to the next expected state when the source record changes to the configured Source Record New State. |
Source Record New State | State to which source records transition to trigger state changes in target records. |
Target Record Next State | State to which target records transition when defined source record state changes occur. |
4. On the Development Actions (
) launchpad menu, click Synchronize.
) launchpad menu, click Synchronize.For more information: