Configuring the Integrator shape

An Integrator shape identifies an activity that connects your Pega 7 Platform system to an external system to send or receive data.

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

1. Double-click the Integrator shape.

2. Complete the fields in the property panel as described in the following table.

   Options include:

   Field	Description
   Rule	Select an activity with an Activity Type of Connect.
   Parameters	If the connector requires parameters, response and request data transforms generated by the accelerator are listed. Use the generated "Request Data Transform" to define the mapping of application (source) properties to connector request (target) properties. Use the generated "Response Data Transform" to define the mapping of connector response (source) properties to application (target) properties.
   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.
   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. The Pega 7 Platform 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. See About the Localization wizard.) 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 How to control history instances written to the audit trail.
   Entry Point	Select to indicate that this Integrator 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 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. Because an Integrator shape 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 shape 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 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. For 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 decision shapes, or that have intermediate shapes that are not entry points.
   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.

3. Click OK to close the panel.

4. Hover on an existing shape in the flow and drag a connector from it to the Integrator shape.

5. Hover on the Integrator shape and drag a connector to an existing shape in the flow.

Tip: Right-click an Integrator shape to view more configuration options.

Open topic with navigation