Back Forward Flow form — Editing in Visio
Assignment Service shape properties
 

About Flows

Purpose

Advanced featureUse the Assignment Service shape in a flow to pass control to an external system using a connector (for example, Connect BPEL rule). Assignment Service shapes support asynchronous coordination with external systems.

Both Integrator shapes and Assignment Service shapes reference an activity of type Connect. For an Integrator shape, flow execution continues as soon as the activity completes. For an Assignment Service shape, flow execution pauses until PRPC receives a service request of the appropriate type.

Adding an Assignment Service shape to a flow

1. Drag the Assignment Service shape (Assignment-Service) onto the flow and drop it.

2. When the Assignment Service Properties panel appears, complete these fields:

Field

Description

Name

Enter a text name for this Assignment Service shape. 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.

The shape name is only descriptive; it does not affect runtime execution of the flow. This name also appears inside the Assignment Service shape on the Diagram tab.

Rule

SmartPromptSelect an activity with an Activity Type of Connect.

Parameters

If the activity accepts input parameters, a list of parameters appears. Enter parameter values. PRPC validates these parameter values when you exit from Visio editing.

Service Level

SmartPromptOptional. Select a service level rule to apply to this shape. For example, a service level can cause escalation processing when no response is received from the external system after 60 seconds.

This may indicate that the external system is unavailable or that other technical problems are present. See Handling connector exceptions.

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, the corresponding text on work item history displays can be localized.)

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

Entry Point?

Select to indicate that this Assignment Service shape is an entry point, which a user can return to using the breadcrumbs control or the standard flow action Work-.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.

Leave unselected to allow users to select this entry point from anywhere within the flow. They can complete or visit an earlier or later step.

TipFor maximum user flexibility, leave this checkbox unselected if your flow accepts inputs in any order. However, this approach is typically not workable for flows that contain fork and decision shapes, or that have intermediate tasks that are not entry points.

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.

3. Click  Apply   when finished.

4. Connect at least one incoming connector and at least one outgoing connector to the shape.

(To edit these shape properties after you save the Flow form, open the Diagram tab, right-click the shape, and select the Edit tab on the pop-up window.)

Up About Flows