Package de.xima.fc.workflow.bpmn

Class APreTestLoopBpmnModeler<Model>

java.lang.Object

de.xima.fc.workflow.bpmn.APreTestLoopBpmnModeler<Model>

Type Parameters:

Model - The type of the node's property model, see IElementHandler.getDataModelClass().

All Implemented Interfaces:

IWorkflowNodeBpmnModeler<Model>

Direct Known Subclasses:

FcWhileLoopBpmnModeler

public abstract class APreTestLoopBpmnModeler<Model>
extends Object
implements IWorkflowNodeBpmnModeler<Model>

BPMN modeler for nodes that execute like a pre-test loop, e.g. a while loop. Creates a diverging and converging exclusive gateway, and places the loop body between the gateways. When the loop condition matches, redirects the sequence flow to the loop body. If it does not match, redirects it to the end of the loop.

If the loop body contains nodes that can complete abruptly by transferring control to this loop (e.g. a break or continue statement), wraps the loop body in a SubProcess that catches the corresponding escalation with a boundary event and redirects the sequence flow accordingly (to the beginning of the loop for a continue statement, or to the end of the loop for a break statement).

At minimum, you should override getConditionName, getConsequentLabel and getAlternateLabel to provide the appropriate question and answers matching the business logic of your condition.

Since:

8.4.0

Constructor Summary

Constructors

Constructor	Description
APreTestLoopBpmnModeler()

Method Summary

Modifier and Type	Method	Description
protected String	getAlternateLabel(IModelWorkflowNodeParams<Model> params, IWorkflowBpmnModelContext context)	Gets the label for when the condition does not match, ending the loop.
protected String	getConditionDetails(IModelWorkflowNodeParams<Model> params, IWorkflowBpmnModelContext context)	Gets the detailed description of the condition that is evaluated to determine when to end the loop.
protected String	getConditionName(IModelWorkflowNodeParams<Model> params, IWorkflowBpmnModelContext context)	Gets the name of the condition that checks when to end the loop.
protected String	getConsequentLabel(IModelWorkflowNodeParams<Model> params, IWorkflowBpmnModelContext context)	Gets the label for when the condition matches, which continues the loop.
protected int	getLoopBodyChildIndex()	Gets the 0-based index of the child representing the loop body.
void	modelNode(IModelWorkflowNodeParams<Model> params, IWorkflowBpmnModelContext context)	Models a WorkflowNode in the BPMN diagram.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

APreTestLoopBpmnModeler

public APreTestLoopBpmnModeler()

Method Detail

modelNode

public final void modelNode(IModelWorkflowNodeParams<Model> params,
                            IWorkflowBpmnModelContext context)

Description copied from interface: IWorkflowNodeBpmnModeler

Models a WorkflowNode in the BPMN diagram. This method is called once for the root node of each WorkflowTask in the workflow. Implementations for nodes that have children should call context.modelNode(node) on their child nodes if needed.

The responsibility of each modeler is to access the provided params.partBuilder() and add the appropriate data to that builder. That data then gets used to create a IStructuredBpmnModelPart for the node, see the class-level documentation of IStructuredBpmnModelPart for more info.

When modelling a workflow node as BPMN, the usual approach is to create a nested tree of alignment items, making use of the layouter. This tree then gets resolved to a flat map. Finally, the various method on IFlattenedAlignmentItemMap can be used to create the BPMN shapes, BPMN edges and sequence flows.

Specified by:

modelNode in interface IWorkflowNodeBpmnModeler<Model>

Parameters:

params - The parameters for the modeler, containing the WorkflowNode to model and its deserialized custom properties model, as well as the part builder to fill with data.

context - The context for creating the BPMN diagram, its lifecycle starts when the conversion (of the workflow to a BPMN diagram) starts and ends when the conversion ends. The context lets you access various helper methods such as the layouter() or colorizer, and also provides access to all global data such as all triggers and nodes in the workflow.

getAlternateLabel

protected String getAlternateLabel(IModelWorkflowNodeParams<Model> params,
                                   IWorkflowBpmnModelContext context)

Gets the label for when the condition does not match, ending the loop. The label is displayed next to the outgoing sequence flow of the exclusive gateway.

When this returns a blank string, defaults to a default localized label that may or may not be appropriate for the specific circumstances of the workflow node being modelled.

Note regarding the naming convention for gateways. Label a data-based exclusive gateway with a question.

• Invoice correct?
• Trust level of user?

Label the outgoing sequence flows with the conditions they are executed under. Formulate the conditions as answers to the question posed at the gateway.

• Yes
• No
• Untrusted
• Basic
• Secure

Parameters:

params - The parameters for the workflow node to model, as provided by the workflow engine.

context - The context for the BPMN modelling process, as provided by the workflow engine.

Returns:

The label for the alternate part.

getConditionDetails

protected String getConditionDetails(IModelWorkflowNodeParams<Model> params,
                                     IWorkflowBpmnModelContext context)

Gets the detailed description of the condition that is evaluated to determine when to end the loop. The description is placed within the text annotation of the diverging exclusive gateway. May return empty if no details are needed.

Parameters:

params - The parameters for the workflow node to model, as provided by the workflow engine.

context - The context for the BPMN modelling process, as provided by the workflow engine.

Returns:

The details description of the condition, may be empty if no condition is specified.

getConditionName

protected String getConditionName(IModelWorkflowNodeParams<Model> params,
                                  IWorkflowBpmnModelContext context)

Gets the name of the condition that checks when to end the loop. Uses as the name of the diverging exclusive gateway.

When this returns a blank string, defaults to a default localized name that may or may not be appropriate for the specific circumstances of the workflow node being modelled.

Note regarding the naming convention for gateways. Label a data-based exclusive gateway with a question.

• Invoice correct?
• Trust level of user?

Label the outgoing sequence flows with the conditions they are executed under. Formulate the conditions as answers to the question posed at the gateway.

• Yes
• No
• Untrusted
• Basic
• Secure

Parameters:

params - The parameters for the workflow node to model, as provided by the workflow engine.

context - The context for the BPMN modelling process, as provided by the workflow engine.

Returns:

The details description of the condition, may be empty if no condition is specified.

getConsequentLabel

protected String getConsequentLabel(IModelWorkflowNodeParams<Model> params,
                                    IWorkflowBpmnModelContext context)

Gets the label for when the condition matches, which continues the loop. The label is displayed next to the outgoing sequence flow of the exclusive gateway.

When this returns a blank string, defaults to a default localized label that may or may not be appropriate for the specific circumstances of the workflow node being modelled.

Note regarding the naming convention for gateways. Label a data-based exclusive gateway with a question.

• Invoice correct?
• Trust level of user?

Label the outgoing sequence flows with the conditions they are executed under. Formulate the conditions as answers to the question posed at the gateway.

• Yes
• No
• Untrusted
• Basic
• Secure

Parameters:

params - The parameters for the workflow node to model, as provided by the workflow engine.

context - The context for the BPMN modelling process, as provided by the workflow engine.

Returns:

The label for the consequent part.

getLoopBodyChildIndex

protected int getLoopBodyChildIndex()

Gets the 0-based index of the child representing the loop body. The default implementation returns 0, i.e. the first child of the pre-test loop.

Returns:

0-based index of the loop body.