Flow form — Editing in Process Modeler
Split Join shape properties 

About Flows
  1. About 
  2. New 
  3. Diagram 
  4. Parameters 
  5. Pages & Classes 
  6. Design 
  1. Process 
  2. Specifications 
  3. Requirements 
  4. Test Cases 
  5. History 
  6. More... 

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.

Purpose

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.

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.

Use the canvas context menu:

  1. Right-click a blank area of the canvas near the location where you would like the Split Join shape to appear.
  2. Hover over Add on the submenu to display a list of shapes you can add to the flow.
  3. Click the Split Join shape. After the shape has been added to the canvas, click and drag to reposition.

Use the toolbar Flow Shape palette:

  1. Click the Flow Shape palette on the toolbar to display a drop-down shapes menu that will remain open until you close it, facilitating the process of rapidly adding multiple shapes. Click the window title bar and drag the submenu to another area of the screen, as needed.
  2. Click and drag the Split Join shape to the canvas.
  3. Close the Flow Shape palette at any time.

Use the Flow Shape palette drop-down menu:

  1. Click the down arrow on the toolbar Flow Shape palette to display a drop-down shapes menu.
  2. Click and drag the Split Join shape from the drop-down menu to the desired position on the canvas.

Editing Split Join properties

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 name, no longer than 128 characters, to the right of the shape title (Split Join: [name]). 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.

NoteTo 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 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:

NoteWhen a shape is deleted, the connectors to and from the shape remain on the canvas.

Cut, copy, and paste Split Join shapes

Cut or copy shapes from a flow and paste them within the same flow or in other flows within your user session.

 

Completing the properties panel sections

Complete the sections comprising the property panel as described below.

Details

Field

Description

Join

Choose Any, All or Some. Choose:

  • All if the current flow is to resume only when all the split subprocesses return.
  • Any if processing in the current flow is to resume after any one of the split subprocesses completes. At that time, processing of the other split subprocesses that have not completed is stopped. Open assignments for these subprocesses are cancelled.
  • Some if multiple subprocesses are spawned and the flow is to resume when a when condition rule is met.
Exit iteration

This field appears only when you select Some in the Join field. Select On Count or On When to create the condition which causes processing in the original flow to resume.

On Count - Enter the number of paths that must result in a specific status in order to exit the split and resume processing in the original flow.

On When - Select a when condition rule. The system uses the class of the parent flow as the Applies To key part of the when condition rule.

If this field is not blank, at runtime the system evaluates this when condition rule upon completion of the spawned processes. If true, the Split Join is exited and flow processing continues. If false, no additional flow executions are started and the flow is resumed.

For example, you can use this field to exit when a top-level work item property was set to 6 or less, where the subprocess executions contain assignments recording committee member votes, and 6 yes votes count as a majority.

When

This field appears only when you select On When in the Exit Iteration field. Select a when condition rule. The system uses the class of the parent flow as the Applies To key part of the when condition rule.

If this field is not blank, at runtime the system evaluates this when condition rule once for each page of the property in the Page Property field. If false, no additional flow executions are started and the flow is resumed.

For example, you can use this field to exit when a top-level work item property was set to 6 or less, where the subprocess executions contain assignments recording committee member votes, and 6 yes votes count as a majority.

At least...
path(s)
Enter the minimum number of paths that must result in a specific status to exit the split and resume processing in the original flow. For example, if a given number of users choose a specific flow action that results in a specified flow status, then processing in the original flow resumes.
Result with flow statusIdentify the status that some flows must reach in order to exit the split and resume processing in the original flow.
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 shape. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, you can localize the corresponding text on work item history displays. See About the Localization wizard.)

NoteOptionally, 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 How to control history instances written to the audit trail.

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. 5.2

This check box works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the check box has no effect.

Only Going Back

This check box appears only when you select the Entry Point check box. 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.

TipFor maximum user flexibility, leave this check box unselected if your flow accepts inputs in any order.

Post Action on Click Away

This check box appears only when you select the Entry Point check box. Select to run flow action post-processing when you click away from this entry point.

Complete the flow rule for this subprocess

Complete the following fields on this section. Click the down arrow beside Specify a Flow Rule for this Subprocess to display the fields for each subprocess. Three tabs appear: Subprocess, Flow Input, and Flow Output.

Subprocess tab — for flow defined "On Current Work Item"

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.

Tip When first building, it is simplest to make this name the same as the name of the called flow. Later when your flow is complete, you can change the name to be more descriptive.

Define Flow

Identify the objects the flow is to update. Select:

  • On Current Work Item to continue processing on the current (unresolved) work item in the next flow
Filter Flow Rule By

Select Process Flow or Screen Flow as the category of the destination subprocess to be started.

Flow RuleRequired

SmartPrompt Select the Flow Name, the second key part of the flow to be started for the other work item.

Parameters

Some flows have input parameters. Enter parameters for the selected flow.

Application

SmartPromptOptional. Select the name of the application that you want to link to the shape. The value of this field is referenced with the flow diagram in application documents.

Work Type

SmartPromptOptional. Select the name of the work type for the application that you want to link to the shape. The value of this field is referenced with the flow diagram in application documents.

Specification

SmartPromptOptional. Select the name of the specification for the application and work type that details the implementation requirements for the Subprocess 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.

Audit Note

SmartPromptOptional. 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 shape. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, you can localize the corresponding text on work item history displays. See About the Localization wizard.)

NoteOptionally, 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.

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 check box works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the check box has no effect.

Only Going Back

This check box appears only when you select the Entry Point check box. 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.

TipFor maximum user flexibility, leave this check box unselected if your flow accepts inputs in any order.

Post Action on Click Away

This check box appears only when you select the Entry Point check box. 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 Page List has three entries. The label property is set to .myString and that the values of .myString on each page of the Page List are pg1, pg2, and pg3. Then the breadcrumbs appear as:

pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.

NoteTabbed nodes and tree harnesses require Subprocess has Entry Points to be selected. By default, the box is cleared.

Subprocess tab — for flow defined "On specific work item"

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.

Tip When first building, it is simplest to make this name the same as the name of the called flow. Later when your flow is complete, you can change the name to be more descriptive.

Define Flow

Identify the objects the flow is to update. Select:

  • Choose On specific work item to start processing on a different work item.
Work Property

Enter a property reference in the current work item that identifies the key (.piousness property) of the other work item. Leave this blank if (when this shape is reached) the other work item is already open as a page on the clipboard.

Class

Select the class (work type) of the "other" work item.

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 pyNextObj (or pyNextObj_1, and so on).

NoteTo start the flow execution, the current requestor must hold a lock on the work item. If the current requestor does not hold or cannot acquire this lock, the system starts a problem flow rather than the designated flow.)

Filter flow rule by

Select Process Flow or Screen Flow as the category of the destination subprocess to be started.

Flow rule

Select the Flow Name, the second key part of the flow to be started for the other work item.

Parameters

Some flows have input parameters. Enter parameters for the selected flow.

Application

Optional. Select the name of the application that you want to link to the shape. The value of this field is referenced with the flow diagram in application documents.

Work type

SmartPromptOptional. Select the name of the work type for the application that you want to link to the shape. The value of this field is referenced with the flow diagram in application documents.

Specification

SmartPromptOptional. Select the name of the specification for the application and work type that details the implementation requirements for the Subprocess 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.

Audit note

SmartPromptOptional. 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 shape. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, you can localize the corresponding text on work item history displays. See About the Localization wizard.)

NoteOptionally, 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.

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 check box works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the check box has no effect.

Only going back

This check box appears only when you select the Entry point check box. 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.

TipFor maximum user flexibility, leave this check box unselected if your flow accepts inputs in any order.

Post action on click away

This check box appears only when you select the Entry point check box. 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 Page List has three entries. The label property is set to .myString and that the values of .myString on each page of the Page List are pg1, pg2, and pg3. Then the breadcrumbs appear as:

pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.

NoteTabbed nodes and tree harnesses require Subprocess has entry points to be selected. By default, the box is cleared.

Subprocess tab — for flow defined "on embedded page"

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.

Tip When first building, it is simplest to make this name the same as the name of the called flow. Later when your flow is complete, you can change the name to be more descriptive.

Define flow

Identify the objects the flow is to update. Select:

  • Choose On Embedded Page when this flow is part of a Split Join operation.
Page property

Enter a reference to the property (of mode Page, Page List, or Page Group) that holds the embedded page.

Class

Identify the class (such as the work type) of the embedded page. You can enter a property reference or expression here.

Filter flow by

Select Process Flow or Screen Flow as the category of the destination subprocess to be started.

Flow rule

Select the Flow Name, the second key part of the flow to be started for the other work item.

Parameters

Some flows have input parameters. Enter parameters for the selected flow.

Application

Optional. Select the name of the application that you want to link to the 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 the 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 the Subprocess 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.

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 shape. PRPC includes a few dozen standard messages in the Work- class. (Through field value rules, you can localize the corresponding text on work item history displays. See About the Localization wizard.)

NoteOptionally, 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 How to control history instances written to the audit trail.

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 check box works with Perform harnesses that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the check box has no effect.

Only going back

This check box appears only when you select the Entry Point check box. 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.

TipFor maximum user flexibility, leave this check box unselected if your flow accepts inputs in any order.

Post Action on Click Away

This check box appears only when you select the Entry Point check box. 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 Page List has three entries. The label property is set to .myString and that the values of .myString on each page of the Page List are pg1, pg2, and pg3. Then the breadcrumbs appear as:

pg1 -Review - Approve - pg2 - Review - Approve — pg3 - Review - Approve.

NoteTabbed nodes and tree harnesses require Subprocess has Entry Points to be selected. By default, the box is cleared.

Flow Input tab

Use the following table to complete the fields on the Flow Input tab:

Field

Description

Condition Type

Choose Always or When.

If you choose Always, add a row and specify a property Name and Value.

If you choose When, complete the fields as described below.

When

Optional. Select the When rule containing the test condition.

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.

add row Click to specify a property Name and Value.

Flow Output tab

add row Click to specify a property Name and Value.

Advanced

Status

Field

Description

Work status

Enter a work status in this field 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 invokes the UpdateStatus activity. Any defined tickets dependent on the status are raised, as appropriate. The selected status updates .pyStatusWork when the flow execution reaches this assignment 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 displays 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

Tickets

Add a Ticket Name field 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 to the decision shape to indicate one or more tickets are associated with this decision. The assigned ticket name appears on the flow.

Field

Description

Ticket Name

add row Select one or more tickets that are to be available at runtime from this decision. Add a row for each ticket. Use SmartPrompt to display all tickets available to flows in this work type.

TipCreating ticket rules is recommended but not required. You can enter here a name that does not correspond to a ticket rule .

NoteIf a shape has more than one ticket associated with it, then processing continues with that task only after all tickets are set.

Example

Processing 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:

  • Include a ticket named Withdrawn on a utility shape that computes the fees due for work done so far, and any refund amount
  • Follow the utility shape with another that produces correspondence, to alert all parties working on the mortgage that it was withdrawn
  • Connect to external systems to back out (rollback) changes or void accounting entries as appropriate
Display NameThe Ticket Name appears by default. Enter a name to display other than the ticket name.

Up About Flows