Connect-Atom method

XXXXXXXXXXXXXXXXXXXXXXX REVISE FOR CONNECT-ATOM XXXXXXXXXXXXXXXXXXXX

C-2651 5.2 Use the Connect-HTTP method to start an HTTP request/response interaction between Process Commander and the external system identified by a Connect HTTP rule (Rule-Connect-HTTP rule type).

Parameters

This method operates on a named clipboard page that is the source and destination of data mappings. Make sure the Step Page specified in the activity step that calls this method is set to the appropriate page name.

This method has one required and two optional parameters:

Parameter	Description
ServiceName	Required. Enter the Service Name — second key part — of the Connect HTTP rule you want to invoke. The system uses the class of the step page as the first key part.

Results

The Connect-HTTP method works as follows:

1. Using rule resolution, locates the Connect HTTP rule identified by the ServiceName parameter and the class of the step page or primary page.
2. Uses request information to assemble a HTTP request message for the Web service.
3. If the step page does not exist, creates a new page, of the class identified in the Pages & Classes tab.
4. Checks whether simulation is in force for this rule. If true, results depend on the Execution mode value: ABLAL 11/14/08

• Run — Executes the simulation activity synchronously
• Run In Parallel — Executes the simulation activity in a separate requestor
• Queue — Queues the simulation activity

5. If simulation is not in force, calls the Web service, or queues the request, depending on the Execution mode value:
   • Run — Calls the Web service and waits for a response.
   • Run In Parallel — Executes in a separate requestor. (This temporary requestor has the same access group and clipboard as the original. At most 10 such child requestor sessions can be active at once.) GAJNJ 4/13/04 maxRequestorChildren? B-18807
   • Queue — Creates a queue item based on the class and other characteristics identified in the Connect Request Processor, for later background processing by the Pega-IntSvcs agent.
6. Processes the HTTP response message when it is received. (No response is available for queued connector requests.)

Checking the method status

This method updates the pxMethodStatus property. See How to test method results using a transition.

Design the activity to detect and handle exceptions. If the Connect-HTTP method with the RunInParallel checkbox selected fails in a way that causes the Connect-Wait method to be skipped, the child requestor can fail. If the limit of parallel requestors is then eventually reached, the parent requestor will fail as well. B-20430 TANDP By default, the limit is 10 requestors in parallel; you can establish a higher or lower value in the prconfig.xml file using the services/maxRequestorChildren setting.

About Connect HTTP rules Connect-Wait method

Methods and instructions by function