More about
Service HTTP rules
|
|
To send a request to an HTTP service rule, use the URL of
the PRHTTPService servlet. Append the three-part
key to the rule to the URL. Use the following syntax:
http://servername:portnumber/contextroot/PRHTTPService/packageName/className/methodName
For example:
http://MyServer:8080/prweb/PRHTTPService/SampleHTTP/Phonebook/AddContact
When the service runs as an authenticated user, the external
application sending the request must include the username and
password of an Operator ID in the request. The external
application can send these values either in an HTTP header, or
appended to the URL as name/value pairs for the parameters
UserIdentifier and Password. The
value of the password must be base64-encoded.
When the session state in a service package is set to
Stateful, the service returns a cookie in the
response with the Set-Cookie HTTP header. The cookie contains
the Requestor ID of the requestor that processed the first
request, with the prefix "PegaRULES." For another
request to access the same session data, the external
application must include the PegaRULES cookie in the header of
that request.
A response can contain only one Set-Cookie header. If a Set-Cookie is set in the data mapping on the Response tab, Process Commander does not set the PegaRULES cookie for you. So if the services run in a stateful session and you need to return custom cookies, your rules are also responsible for constructing the PegaRULES cookie.
Create the cookie string by concatenating all the cookies to
be sent, including the PegaRULES cookie, into one string. The value of the PegaRULES cookie must be the requestor
ID. For example:
PegaRULES=H40F706525721982DE3C8530D6DC64FCD.
Get the value of the requestor ID from the
pzRequestorId property on the
pxRequestor page, which is always present on the
clipboard. This can be accomplished either by having the
service activity set a clipboard property, or through a
Rule-Utility-Function. Then, use the Response tab to configure a
Set-Cookie header that contains the string with
the values of all the cookies.
