Use the Request tab to map data for the
request message.
Header Fields
Use the fields in this section to map data for HTTP
header fields. The data type of a header field is
String
.
Field
|
Description
|
Name
|
Enter the external name of the header field.
|
Description
|
Enter a short description of the header field.
|
Map
From
|
Specify
the source or the type of source of the value:
Clipboard — Map from the page name or
property on the clipboard specified by the Map From
Key field.
Constant — The data is a fixed value
that does not change.
If additional choices appear, they identify a custom function
rule in a MapFrom library. Review the function rule to determine
what it does.
|
Map From
Key
|
Specify
the key to locating the property or rule in the source specified
in the Map From field.
- If the Map From value is
Clipboard , enter the property name from which
the data is mapped at runtime.
- If the Map From value is a
Rule-Utility-Function from a
MapFrom library,
either select the property that holds the value to be
processed by the function at runtime or leave this field
blank, as appropriate for the function.
- If the Map From value is
Constant , enter the value of the constant
surrounded by double quote characters.
|
Query String Parameters
When the HTTP method specified on the Service tab is GET
, use the fields in this
section to specify name/value pairs to append as a query string to the
URL of the target system.
Field
|
Description
|
Name
|
Enter the name to use for the parameter. The data type of a
query string parameter is String .
|
Description
|
Enter a short description of the parameter.
|
Map
From
|
Specify
the source or the type of source of the value in Process
Commander. For descriptions of the Map From
options, see the definition of the Map From
field in the Header Fields section.
|
Map From
Key
|
Specify
the key to locating the property or rule in the source specified
in the Map From field. For descriptions of the
Map From Key options, see the definition of the
Map From Key field in the Header
Fields section.
|
Message Data
When the HTTP Method field on the Service tab is set to POST
, use the fields
in this section to specify the data to include in the POST
message.
Field
|
Description
|
Description
|
The data type of the message data is String .
Enter a short description of the string in the response.
|
Map From
|
Specify
the source or the type of source of the value:
Clipboard — The source is a property
or a page on the clipboard.
Constant — The source is a fixed
value.
XML Stream — The source is a stream of
XML data formatted by an XML Stream rule.
HTML Stream — The source is a stream
of HTML data formatted by an HTML rule.
If additional choices appear, they identify a custom function
rule in a MapFrom library. Review the function rule
to determine what it does.
|
Map From
Key
|
Specify
the key to locating the property or rule in the source specified
in the Map From field:
- If the Map From value is
Clipboard , enter the reference to the property
from which the data is mapped at runtime.
- If the Map From value is
Constant , enter a literal text string. To
include blank spaces in your text string, surround the string
with double quotes.
- If the Map From value is
XML
Stream , enter either the Stream Name
(second key) of the appropriate XML Stream rule or a page
name and stream name using the syntax PageName.StreamName.
(The page must be present on the clipboard when the connector
rule runs for rule resolution to find the rule.) If you
specify the stream name only, the system uses the
Applies To class of this connector rule as
the first key part of the XML Stream rule.
- If the Map From value is
HTML
Stream , enter either the Stream Name
(second key) of the appropriate HTML rule or a page name and
stream name using the syntax PageName.StreamName. (The page
must be present on the clipboard when the service rule runs
for rule resolution to find the rule.) If you specify the
stream name only, the system uses the Applies
To class of this connector rule as the first key
part of the HTML rule.
- If the Map From value is a
Rule-Utility-Function from a
MapFrom library,
enter or select the property that holds the value to pass to
the custom function at runtime.
|
Binary
Attachments
Field
|
Description
|
Send attachments
with request
|
Select to specify that the connector is to send
attachments with the outgoing HTTP message. For more
information, see the Pega
Developer Network article PRKB-25026 How to configure a
SOAP or dotNET connector to send or receive SOAP with
attachments. 5.4
|
About Connect HTTP
rules