|
![]() |
The Split Join shape causes processing of a work item to split into two or more independent flow executions that operate asynchronously and then later rejoin.
Use the Split Join shape to require that multiple subprocesses of your flow be completed before the current flow continues execution. This allows subprocesses to execute asynchronously, in parallel. For an example, see Work-.ParallelWork.
For example, a mortgage application workflow may require that facts about the home buyers be validated, and that a title search be completed. These two tasks are unrelated and can be performed in subprocesses that proceed independently and in parallel. Other processing later in the primary flow can require that both these two subprocesses complete.
The and
help to identify the Split Join shape.
indicates that one or more tickets are defined on the Split Join shape. Assigned ticket names appear beside this icon on the flow.
Adding a Split Join shape to the flow
On the flow Diagram tab, you can add a shape to a flow in one of three ways. Validation of the added shapes occurs when you save the flow.
1. On the flow Diagram tab, open the properties panel using one of the following:
2. When the Split Join Properties panel appears, enter a text name for this shape. The shape name defaults to Split Join. Choose a name meaningful to application users who see this on the work item history display, the breadcrumbs control (for entry points), and the Where-Am-I? diagram. For example: Customer Limit Check.
The shape name is only descriptive; it does not affect runtime execution of the flow. This name also appears inside the Split Join shape on the Diagram tab.
To change the name after you have exited from the properties panel, click the name, and type over the highlighted text.
3. Complete the fields as described in the tables below.
4. Click OK or click anywhere off the shape to save edits and close the panel.
5. Click and drag the shape as needed to position it in the flow.
6. Connect at least one incoming connector to the Split Join shape.
7. Connect at least one outgoing connector from the Split Join shape to another shape, unless a parallel process resolves a work item and does not have to return to the flow.
Deleting a Split Join shape from the flow
A Split Join shape may be deleted from the process flow. Right-click the Split Join shape, and select Delete from the drop-down menu.
You can also select the Split Join and do one of the following:
Complete the following fields on the Split Join tab.
Field |
Description |
Join |
Choose
|
Audit Note |
|
Entry Point |
Select to indicate that this Split Join shape is an entry point, which a user can return to using the breadcrumbs control or the standard flow action Previous. The default is cleared. This checkbox works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the checkbox has no effect. |
Only Going Back |
This checkbox appears only when you select the Entry Point? checkbox. Select to restrict users at runtime from jumping ahead to this step without having completed the preceding steps. After having completed this step, users may jump back to it from steps that follow it.
|
Post Action on Click Away |
This checkbox appears only when you select the Entry Point checkbox. Select to run flow action post-processing when you click away from this entry point. |
Complete the following fields on the Subprocesses tab. Click the plus sign beside Specify a Flow Rule for this Subprocess
to display the fields for each subprocess. Three additional tabs will appear: Subprocess, FlowInput, and FlowOutput.
Use the following table to complete the fields if your flow is being defined on the current work item:
Field |
Description |
Name |
Enter a name for the subprocess. Choose a name meaningful to application users who see this on the work item history display, the breadcrumbs control (for entry points), and the Where-Am-I? diagram. It does not affect flow execution.
|
Define Flow |
Identify the objects the flow is to update. Select:
|
Filter Flow Rule By |
Select |
Flow Rule![]() |
|
Parameters |
Some flows have input parameters. Enter parameters for the selected flow. |
Application |
|
Work Type |
|
Specification |
|
Audit Note |
|
Entry Point |
Select to indicate that this Split Join shape is an entry point, which a user can return to using the breadcrumbs control or the standard flow action Previous. The default is cleared. This checkbox works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the checkbox has no effect. |
Only Going Back |
This checkbox appears only when you select the Entry Point checkbox. Select to restrict users at runtime from jumping ahead to this step without having completed the preceding steps. After having completed this step, users may jump back to it from steps that follow it.
|
Post Action on Click Away |
This checkbox appears only when you select the Entry Point checkbox. Select to run flow action post-processing when you click away from this entry point. |
Subprocess has Entry Points |
In a regular flow, select to allow users to return to the entry points within the Split Join subprocesses using the breadcrumbs control, or clicking a tree-harness node from a completed subprocess or the standard flow action Work-.Previous. For example, assume that a Split Join shape calls a flow containing two assignments ("Review" and "Approve) and the pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.
|
Use the following table to complete the fields if your flow is being defined on another work item:
Field |
Description |
Name |
Enter a name for the subprocess. Choose a name meaningful to application users who see this on the work item history display, the breadcrumbs control (for entry points), and the Where-Am-I? diagram. It does not affect flow execution.
|
Define Flow |
Identify the objects the flow is to update. Select:
|
Work Property |
|
Class |
|
Page Name |
Optional. If (when this shape is reached) the other work item is present on the clipboard, enter the page name that holds it. If the other work item is not present, enter the page name to be created that holds it. When you leave this field blank but complete the Work Property field, the system opens the work item on a page named
|
Filter Flow Rule By |
Select |
Flow Rule![]() |
|
Parameters |
Some flows have input parameters. Enter parameters for the selected flow. |
Application |
|
Work Type |
|
Specification |
|
Audit Note |
|
Entry Point |
Select to indicate that this Split Join shape is an entry point, which a user can return to using the breadcrumbs control or the standard flow action Previous. The default is cleared. This checkbox works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the checkbox has no effect. |
Only Going Back |
This checkbox appears only when you select the Entry Point checkbox. Select to restrict users at runtime from jumping ahead to this step without having completed the preceding steps. After having completed this step, users may jump back to it from steps that follow it.
|
Post Action on Click Away |
This checkbox appears only when you select the Entry Point checkbox. Select to run flow action post-processing when you click away from this entry point. |
Subprocess has Entry Points |
In a regular flow, select to allow users to return to the entry points within the Split Join subprocesses using the breadcrumbs control, or clicking a tree-harness node from a completed subprocess or the standard flow action Work-.Previous. For example, assume that a Split Join shape calls a flow containing two assignments ("Review" and "Approve) and the pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.
|
Use the following table to complete the fields if your flow is being defined on an embedded page:
Field |
Description |
Name |
Enter a name for the subprocess. Choose a name meaningful to application users who see this on the work item history display, the breadcrumbs control (for entry points), and the Where-Am-I? diagram. It does not affect flow execution.
|
Define Flow |
Identify the objects the flow is to update. Select:
|
Page Property |
|
Class |
|
Filter Flow Rule By |
Select |
Flow Rule![]() |
|
Parameters |
Some flows have input parameters. Enter parameters for the selected flow. |
Application |
|
Work Type |
|
Specification |
|
Audit Note |
|
Entry Point |
Select to indicate that this Split Join shape is an entry point, which a user can return to using the breadcrumbs control or the standard flow action Previous. The default is cleared. This checkbox works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the checkbox has no effect. |
Only going back |
This checkbox appears only when you select the Entry Point checkbox. Select to restrict users at runtime from jumping ahead to this step without having completed the preceding steps. After having completed this step, users may jump back to it from steps that follow it.
|
Post Action on Click Away |
This checkbox appears only when you select the Entry Point checkbox. Select to run flow action post-processing when you click away from this entry point. |
Subprocess has Entry Points |
In a regular flow, select to allow users to return to the entry points within the Split Join subprocesses using the breadcrumbs control, or clicking a tree-harness node from a completed subprocess or the standard flow action -Work.Previous. For example, assume that a Split Join shape calls a flow containing two assignments ("Review" and "Approve) and the pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.
|
Use the following table to complete the fields on the Flow Input tab:
Field |
Description |
Condition Type |
Choose If you choose If you choose |
When |
|
Likelihood![]() |
Associate a likelihood value between 1 and 99 for the connector. At runtime, the system evaluates the conditions in order of deceasing likelihood. Choose distinct likelihood values if you care about the order. |
Click to specify a property Name and Value.
Click to specify a property Name and Value.
Complete the Work Status field under the Status tab to set the status for the work item. This allows you to easily change the status at multiple points in the life cycle of a work item without adding a Utility shape to the flow for each status change. Similar to setting work item status using a Utility shape, setting the status on this tab invokes the UpdateStatus activity. Any defined tickets dependent on the status are raised, as appropriate.
Field |
Description |
Work Status |
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.
|
Add a Ticket Name field under the Tickets tab to indicate the ticket(s) available at runtime. Use the Ticket to mark the starting point for exceptions that may arise at any point in the flow, such as a cancellation. The ticket is a label for a point in a flow, much like a programming "GOTO" destination.
An activity executing anywhere in your entire PRPC application can set or raise this ticket by executing the Obj-Set-Tickets method with this ticket name as a parameter. See Ticket help for other ways to raise a ticket.
The scope of a raised ticket includes all flows on the current work item that contain this ticket. If found, processing stops on that flow promptly, and resumes at the ticket point.
The system adds a ticket icon to the split join shape to indicate one or more tickets are associated with this split join. Assigned ticket names appear beside this icon on the flow.
Field |
Description |
Ticket Name |
ExampleProcessing is connected to a ticket to respond to an exception, error flow or event. For example, if a mortgage application is withdrawn after some, but not all, of the application processing is completed, a mortgage processing flow can:
|
Display Name | Optional. The Ticket Name appears by default. Enter a name to display other than the ticket name. |