Calling activity
An HTTP connector is called by a connector activity —
an activity with the Activity Type set to
Connect
that applies to a class derived from the
Work- base class. Such activities can be referenced in an
Integrator shape () in a flow rule.
Connector activities have the following kinds of steps:
- A step that creates a named page for the class that the
connector rule applies to. This page becomes the primary page
for the connector.
- A step that sets property values and input parameter
values that serve as the input for the connector's
message sent to the external application.
- A step that calls the connector rule. This step uses the
Connect-HTTP method. The step page is the primary page of the
connector.
- A step that processes the reply message that the
connector rule receives.
Asynchronous execution by the Pega-IntSvcs agents
To perform HTTP connector processing asynchronously:
- Create a Connector Request Processor data instance that defines the characteristics and classes of queued requests. Associate this data instance with the RuleSet that contains the Connect HTTP rules.
- On the Service tab of the Connect HTTP rule, select
queuing
in the Intended for field and identify the Connector Request Processor created in step 1. Leave the Response tab blank; it is not used.
- Update one or more Data-Admin-Queue instances to ensure that the ProcessConnectQueue agent entry within the Pega-IntSvcs agent is enabled with an appropriate time period.
- In the activity steps that execute the Connect-HTTP method, set the Execution Mode parameter value to
Queue
.
- Test.
Performance Statistics
For information on
gathering performance information about this connector see
Testing Services and
Connectors, a document on the Integration pages of the Pega
Developer Network.
Simulation and debugging
You can simulate an HTTP connector when the external system
is unavailable or when you need to test an application but lack
a test environment.
For more information on testing connectors, see Testing Services and Connectors, a
document on the Integration pages of the Pega Developer
Network.
About Connect HTTP rules