Back Forward Flow form
Editing Integrator shape properties

About Flow rules

Purpose

A Integrator task identifies an activity that connects your Process Commander system to an external system to send or receive data.

For example, an integrator task can connect to a customer master database to retrieve account balances or verify account numbers and status. Integrator tasks use activities (with Connect as the Activity Type) that call connector rules (Rule-Connect- rule types).

Adding an Integrator task to the flow

1. Drag the Integrator shape (Integrator) and drop it onto the flow.

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

Field

Description

Name

Assign a name to the Integrator task. Choose a name meaningful to application users who see this on the work object history display, the breadcrumbs control (for entry points), and the Where-Am-I? diagram. .

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

Rule

SmartPromptSelect an activity with an Activity Type of Connect.

Application

SmartPromptOptional. Select the name of the application that you want to link to the flow 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 flow shape. The value of this field is referenced with the flow diagram in application documents.

Use Case

SmartPromptOptional. Select the name of the use case for the application and work type that details the implementation requirements for the flow shape. The value of this field is referenced with the flow diagram in application documents and on the Implementation tab of the corresponding Rule-Application-UseCase instance.

Parameters

If the activity requires parameters, a list of parameters appears. Enter parameter values.

Service Level

SmartPromptOptional. Select a service level rule to apply to this task. 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 object history (the "audit trail") when a flow execution completes this shape. Process Commander includes a few dozen standard messages in the Work- class. (Through field value rules, the corresponding text on work object history displays can be localized. 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 object history. See Controlling the volume of generated work object history instances and the Pega Developer Network article PDNPRKB-25196 How to control history instances written to the audit trail.

Entry Point?

Select to indicate that this Integrator task 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 check box works with Perform harness rules that include a breadcrumbs display and with assignments that offer the Work-.Previous flow action. In other cases, the check box has no effect.

Because an Integrator task presents no user form, if a user clicks a breadcrumbs control to return to this entry point, flow processing resumes and pauses at the next assignment or other task that requires user input.

Only going back?

This check box appears only when you select the Entry Point? check box. Select to restrict users at runtime who are at this entry point to choose only those entry points (on the breadcrumbs display) that identify earlier steps in the flow.

Leave unselected to allow users to select any entry point of the flow when at this entry point. They can click the breadcrumbs control or tab to complete or visit an earlier or later step.

TipFor maximum user flexibility, leave this check box 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.

3. Click  Apply   when finished.

4. Connect at least one incoming connector to the shape. Ordinarily, connect one (and only 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.)

Definitions activity type, breadcrumbs control, connector, entry point
Related topics How to create activities for use in flows
TaskStatus-Set method
Standard rules Standard activities for flows

zzz About Flow rules