To preserve business data integrity across multiple Pega Platform instances, you can send messages asynchronously from one system to another. If the receiving system is unable to receive the message, you can queue the message until it can be resent later.
- Create a SOAP connector. For more information, see Creating a Connect SOAP rule.
- Select a queue. You can either use the default queue (System-Queue-ExecutionRequest-Connect-Default) or create a queue by defining a new concrete class within the System-Queue-ExecutionRequest-Connect- class.
- Create a connect request processor. The connect request processor defines the queue location and dequeuing options for the queued connection. For more information, see Connect Request Processor data instances.
To enable web service queuing, you must complete the following steps:
- Open the SOAP connector rule to specify that the request must be queued instead
of processed immediately.
- In the navigation pane of Dev Studio, click Records.
- Expand the Integration-Connectors category, and then click Connect SOAP.
- Click the SOAP connector rule that you want to open.
- On the Service tab of the SOAP connector, in the Processing options section, in the Intended for field, select queuing (response will not be available).
- In the Request processor field, enter the request processor that you created to define the queue location and dequeuing options.
- Open the connect activity.
- On the Steps page, expand the step that runs the web service.
- In the Method Parameters section, in the ExecutionMode field, select Queue.
- Add a Commit step in one of the following ways:
Queuing a connection request is a database operation. Even if the activity does not contain any explicit database operations, you cannot save the queue to the database without a Commit step. For more information, see Configuring steps in an activity.
- After the web service invocation step in this activity
- In the parent activity that calls the connect activity
- Run the process that invokes the web service.
- View the instances of the queue class that you specified in the connect request
processor. The Instances dialog box shows the instance and its status.
Note: If you do not configure your connect request processor to keep items in the queue after successful completion, queue instances with a success status are not displayed.