Flow form - Editing in Process Modeler - Connectors and flow actions

Connectors between two shapes can either be anchored to a specific connection point, or be unanchored and tied only to the shape. Consider the kinds of connections as you create a neat, easy-to-follow flow.

You can draw a connector to and from a specific connector point so that it is anchored to that point. When the connector is selected, these anchored connections will display as a solid gray dot at each connector point. If you move the shape on the canvas, the connector remains anchored to that point.

You can also draw an unanchored connector from one shape to another by clicking a gray arrow outside the shape and dragging to the destination the shape. The connector is tied to the shape, but not to a specific connector point on the shape. When the connector is selected, these unanchored connections will display as an open white dot on the shape at each connector point. If you move the shape on the canvas, the connector stays with the shape, but will automatically route to the nearest connector point.

You can have a combination of anchored and unanchored connectors between an originating shape and a destination shape. Connections can be:

anchored to anchored
anchored to unanchored
unanchored to anchored
unanchored to unanchored

Plan for whether your connector points should be anchored or unanchored. As a shape is dragged on the canvas, the unanchored connector ends can switch among some of the available connector points, trying to reduce the number of bends in their associated connectors. When the shape is released in its new position, the connector ends that were anchored will stay on those same points, and the unanchored connectors will typically connect at the closest connector point on the shape. Unanchored connectors may result in multiple connectors on a single connector point after dragging.

When a Visio flow is converted for use in the Process Modeler, all connections in the converted process flow are unanchored.

Plan your connectors and criteria so that at least one is True no matter what data values are present. As a good practice, select Else as the criterion for the connector with the lowest likelihood.

1. Hover over a shape to see the connection points.

As you move your mouse over a shape, the connector points appear on the top, bottom, and sides. A green box displays around the connector point to indicate that you have selected a starting point that the connector will be anchored to.
As you move your mouse over a shape, gray arrows also appear outside the shape. A blue box displays around the whole shape to indicate that the starting point will be an unanchored connection, tied to the shape, but not tied to a specific point.

2. Click and drag your mouse from the starting shape to draw the connector to another shape. A connector must make a valid connection to a shape. The dashed line will remain until you connect to a valid destination point. Valid connections display with a green connector line and a green outline around the target shape.

You may either connect to a specific point by dragging to a connector point and dropping when the green highlight box appears around the connection point, or create an unanchored connection to the shape by dropping on the shape when the green outline appears around the entire shape.
If you drag to an anchored connector point, the point will display as a gray dot when the connector is selected. If you drag to the center of the shape, the connector will automatically route to the nearest connector point which will display as an open white dot when the connector is selected.
You cannot connect to an annotation or swimlane.

3. If this flow is a screen flow, special rules apply. Continue with Flow Rules — Editing in Process Modeler — Creating and Editing a Screen Flow.

4. Double-click the connector, or select the connector and click on the toolbar, to display the Connector Properties panel. Complete the fields that appear according to the tables below.

5. Optionally, enter a name for the connector. The name will display if you change it from the default provided or if you change a status. Note that for a connector originating at the Start shape, Name is the only field in the panel.

6. Click OK or click anywhere off the shape to save edits and close the panel.

7. The on the toolbar toggles the likelihood display on the connectors.

The contents of the Connector Properties panel varies depending on the shape that the connector originates from. For example, a connector originating from an assignment shape will display a different property panel than a connector originating from a decision shape.

Complete the Connector Properties panel to identify the connector flow action available to a user who performs this assignment. The flow action rule controls how users interact with user forms to complete the assignments.

On the Connector tab, complete the following:

Field	Description
Flow Action	Select the name of a flow action.
Application	Optional. Select the name of the application that you want to link to this shape. The value of this field is referenced with the flow diagram in application documents.
Work Type	Optional. Select the name of the work type for the application that you want to link to this shape. The value of this field is referenced with the flow diagram in application documents.
Specification	Optional. Select the name of the specification for the application and work type that details the implementation requirements for this shape. The value of this field is referenced with the flow diagram in application documents and on the Implementation tab of the corresponding Application Specification.
Likelihood	Enter a percentage between 1 and 100 that indicates how likely it is that a user selects this flow action. If only one path is possible, enter 100. Otherwise, allocate percentages among the multiple flow actions as appropriate. Toggle their display using on the toolbar. These can be approximate; you can change them later.
Audit Note	Optional. Select or enter the name of a Rule-Message rule to control the text of an instances added to the work item history (the "audit trail") when a flow execution completes this connector. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, the corresponding text on work item history displays can be localized.) Alternatively, enter a brief text phrase between double quotes. Optionally, to reduce the volume of history detail instances, your application can prevent system-generated messages from being added to work item history. See Controlling the volume of generated work item history instances and the PDN article 25196 How to control history instances written to the audit trail.

On the Set Properties tab, optionally indicate how you want to set properties for work items as they advance over this connector. You can set properties explicitly or apply a data transform rule. A clipboard icon appears on the connector if you assign properties or a data transform on the connector.

To set properties explicitly, click Set Properties.
- In the Name field, use the SmartPrompt to identify a target property reference. When during flow execution at runtime a work item advances on this connector, the system sets the value of this property to the value specified in the Value (next) field. For example, select .pyStatusWork if all work items using this connector are to have a new status value.
- In the Value field, enter a literal value or property reference for the property whose value is copied to the target.
- Don't use this feature to set pyStatusWork to a resolved value. Always use the standard utility Work-.Resolve to resolve a work object.
- Click to add rows as needed.
To apply a data transform (formerly known as a 'model') for setting multiple properties, click Apply Data Transform. Use the SmartPrompt to select the data transform. The data transform you select may accept input parameters that will appear in the box below. Supply a value for each parameter.

Typically, there are two or more outgoing connectors from a decision shape, one of which is labeled Else.

On the Connector tab, complete the following:

Field	Description
Condition Type	Select `Result` or `Else` or `When`. Select: `Result` — Use to perform a comparison. `Else` — To define a last resort, none-of-the-above connector that the flow is to use when no other connectors are valid. `When` — If the work item is permitted to flow along this connector when only when a certain when condition rule evaluates to true. Use the SmartPrompt to enter the name of a when condition rule. Alternatively, you can use the Expression Builder. If the Decision is a Fork type, one more condition is available: `Always` — When only one path is possible from the shape.
Result	Available when you select `Result` for the Condition Type. Use the drop-down menu to select the value returned at runtime by the decision shape. This field is a text entry box when draft mode is on or when the decision shape is a Fork. This allows you to enter temporary results, even if you have not assigned an actual decision rule to the shape. When draft mode is off, you must associate a decision rule and enter a valid result. If decision type is Boolean, select true or false. If decision type is Map Value, select from the list of values that are configured on the third column of the Map Value rule form Matrix tab. If decision type is Decision Table, select from the list of values that are configured on the Table tab of the Decision Table form. If decision type is Decision Tree, select from the list of values that are configured on the Decision tab of the Decision Tree form. If the decision type is a Fork, complete the text entry field.
When	Available if this connector is from a fork decision shape. Enter the name of a When condition rule. If you chose `Always` or `Else`, no further input is required.
Likelihood	Available when you select `Result` or `When` for the Condition Type. Enter a percentage between 1 and 100 that indicates how likely you expect that the work item at runtime follows this connector path. If only one path is possible, enter 100. Otherwise, allocate percentages among the multiple paths as appropriate. These can be approximate; you can change them later. When the system lists connector flow actions to the user, they appear sorted by decreasing likelihood values.
Audit Note	Optional. Select or enter the name of a Rule-Message rule to control the text of an instances added to the work item history (the "audit trail") when a flow execution completes this connector. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, the corresponding text on work item history displays can be localized.) Alternatively, enter a brief text phrase between double quotes. Optionally, to reduce the volume of history detail instances, your application can prevent system-generated messages from being added to work item history. See Controlling the volume of generated work item history instances and the PDN article 25196 How to control history instances written to the audit trail.

On the Set Properties tab, optionally indicate how you want to set properties for work items as they advance over this connector. You can set properties explicitly or apply a data transform rule. A clipboard icon appears on the connector if you assign properties or a data transform on the connector.

To set properties explicitly, click Set Properties.
- In the Name field, use the SmartPrompt to identify a target property reference. When during flow execution at runtime a work item advances on this connector, the system sets the value of this property to the value specified in the Value (next) field. For example, select .pyStatusWork if all work items using this connector are to have a new status value.
- In the Value field, enter a literal value or property reference for the property whose value is copied to the target.
- Don't use this feature to set pyStatusWork to a resolved value. Always use the standard utility Work-.Resolve to resolve a work object.
- Click to add rows as needed.
To apply a data transform (formerly known as a 'model') rule for setting multiple properties, click Apply Data Transform. Use the SmartPrompt to select the data transform. The data transform you select may accept input parameters that will appear in the box below. Supply a value for each parameter.

A utility shape can return a literal constant result using the TaskStatus-Set method. Similarly, a subprocess called from this flow can return a literal constant result to indicate which End shape was reached. Complete these fields to have the system test the result returned in these situations to select a connector.

Field	Description
Condition Type	Select `Always`, `Else, Result`, or `When`: `Always` — When only one path is possible from the shape. `Else` — To define a last resort connector that the flow is to follow when no other connectors are valid. `Result` — The flow proceeds on this connector only if a value returned at runtime matches a value in the next text box. `When` — If the work item is permitted to flow along this connector when only when a certain when condition rule evaluates to true.
Result	Available when you select `Result` for the Condition Type. Use the drop-down menu to select the value returned at runtime by the shape. The value you enter here depends on your selection in the Condition Type field: Enter a text value to match the text value returned at runtime by the called flow (through a setting on the End shape) or by the TaskStatus-Set method in the called activity. When the End settings of the called flow are previously defined, SmartPrompt is available.
When	Available when you select `When` for the Condition Type. Enter the name — second key part — of a when condition rule.
Likelihood	Appears when `Result` or `When` is selected. Enter a percentage between 1 and 100 that indicates approximately how likely it is that the work item at run follows this path. If only one path exists, enter 100. Otherwise, allocate percentages among the multiple paths as appropriate. If you chose `Always` or `Else`, no further input is required.
Audit Note	Optional. Select or enter the name of a Rule-Message rule to control the text of an instances added to the work item history (the "audit trail") when a flow execution completes this connector. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, the corresponding text on work item history displays can be localized.) Alternatively, enter a brief text phrase between double quotes. Optionally, to reduce the volume of history detail instances, your application can prevent system-generated messages from being added to work item history. See Controlling the volume of generated work item history instances and the PDN article 25196 How to control history instances written to the audit trail.

On the Set Properties tab, optionally indicate how you want to set properties for work items as they advance over this connector. You can set properties explicitly or apply a data transform rule. A clipboard icon appears on the connector if you assign properties or a data transform on the connector.

To set properties explicitly, click Set Properties.
- In the Name field, use the SmartPrompt to identify a target property reference. When during flow execution at runtime a work item advances on this connector, the system sets the value of this property to the value specified in the Value (next) field. For example, select .pyStatusWork if all work items using this connector are to have a new status value.
- In the Value field, enter a literal value or property reference for the property whose value is copied to the target.
- Don't use this feature to set pyStatusWork to a resolved value. Always use the standard utility Work-.Resolve to resolve a work object.
- Click to add rows as needed.
To apply a data transform (formerly known as a 'model') rule for setting multiple properties, click Apply Data Transform. Use the SmartPrompt to select the data transform. The data transform you select may accept input parameters that will appear in the box below. Supply a value for each parameter.

A connector may be moved or rerouted to or from another valid shape.

Click a connector. The connector highlights when it is selected. You must have selected the connector before you can move an endpoint.
Move the mouse over the connector point you want to move.
Click and drag the connector point to or from a different shape, making an anchored or an unanchored connection.
Adjust the properties panel as needed for the new shape.

A status indicator appears on connectors to shapes that change a work item status. For example, if the shape status is set to Pending-External, the connector to that shape will display a small red flag. All transitions connecting to the shape will display the status indicator. Following are the status indicators for the four status prefixes.

New

Open

Pending

Resolved

A connector may be deleted from the process flow. Right-click the connector, and select Delete from the drop-down menu.

You can also select the connector and do one of the following:

Click the Delete icon on the toolbar.
Press the Delete key on your keyboard.

When a shape is deleted, the connectors to and from the shape are also deleted.

By selecting a flow action and completing the resulting HTML form, a user determines which path is followed from an assignment shape. For all other shapes, system processing determines which path is followed:

If no outgoing connector from the shape, processing stops. The work item may remain open, but no further processing by this flow occurs.
When only one outgoing connector exists, processing follows that connector.
From an assignment shape, the user selects the outgoing connector by choosing the associated flow action.
From a decision shape, the system selects the outgoing connector that contains a value that matches the result of the decision rule.
From all other shapes, the system evaluates the connectors available to it starting with the one with the highest likelihood value. Evaluation continues with the next highest likelihood connector, and so on, until one evaluates to True, or until the Else Connector is chosen.

As a start during initial development, you can enter approximate likelihood values. Later, after this flow is used in a production setting, you can use the Flow Analysis button (on the Design tab) to compare experience with likelihood values.

If the actual results vary significantly from the likelihood values, it can be valuable to understand why. You can update the flow with more accurate likelihood values at any time later; such changes do not affect the logic or operation of the workflow. A decision with type of fork may take one of several paths of processing based on the set of conditions resulting from When rules invoked.

At runtime, the system presents available flow actions in a selection list, with connector flow actions (sorted by decreasing likelihood) appearing above local flow actions. In generally, you cannot control the order of the local flow actions. However, if for one assignment you want to make a local flow action appear first, add a connector to the flow that loops back to the assignment, and assign the largest likelihood value to that connector.

Flow form Editing in Process Modeler — Connectors and flow actions
About New Diagram Parameters Pages & Classes Design
Process Specifications Requirements Test Cases History More...

Flow form Editing in Process Modeler — Connectors and flow actions

Field

Description

Field

Description

Field

Description

Flow form
Editing in Process Modeler — Connectors and flow actions