Connect HTTP form
|
Use the Service tab to identify the external system with which this connector rule communicates.
Field |
Description |
Service Properties | |
Endpoint URL |
Enter the URL of the external system to which this rule connects. This URL can change over time, or can change when you move between a test system and a production system. However, after the RuleSet version containing this connector rule is locked, you cannot update this field. If your application needs to override the value in this field, complete the EndPointURL parameter of the Connect-HTTP method in the connector activity that calls this connector rule. This field supports the Global Resource Settings syntax (=.PageName.PropertyName). For more information, see Using the Global Resource Settings feature. |
HTTP Method |
Select
which HTTP method to use to send the string: |
HTTP Version |
Select a version known to be compatible with the server that this connector is connecting to. Because HTTP Versions are backward compatible, it is recommended to set the HTTP Version to the lowest known compatible version. For example, if it is not known if the server is 1.1 compatible, set the connector HTTP Version to 1.0.V55SP2 |
Request Only |
When the HTTP Method is set to
|
Allow Redirects? |
Select to enable the connector to, based on information returned from the service, retry a request using a different service address.GRP-1905 PROJ-215 V55SP2 |
Field |
Description |
Authentication | |
Use Authentication? |
If selected, Process Commander includes authentication credentials in the HTTP header of the message. The credentials are encrypted according to section 11 (Basic Authentication Scheme) of the HTTP 1.0 specification. |
Username Property |
Required, if Use Authentication? is selected. Select the property that contains the user name for the remote services that require authentication. |
Password Property |
Required, if Use Authentication? is selected. Select the property that contains the password for the remote services that require authentication.
Do not use a property of
HTML type |
Field |
Description |
Connection |
Use the fields in this section only when the Request Only field is cleared. |
Response Timeout |
Optional. Enter the number of milliseconds after which this rule times out with a failure message if it does not receive a response. Enter zero or leave blank to wait indefinitely. This field is disabled and ignored at runtime when the
Intended for field is set to
|
Maintain Session? |
Select to use HTTP token-passing as the mechanism for maintaining a stateful session with the Web service provider. If selected, enter a Connection ID value in the previous field. This field is disabled and ignored at runtime when the Intended for field is set to |
Connection ID |
Optional. If the external system uses HTTP token passing to maintain stateful session data between requests, you can use this field to specify that a group of logically related connectors are to share a single session. Enter an arbitrary text value in this field, and enter the same text value in the other HTTP connector rules that are to share the session data. |
Field |
Description |
Error Handling | |
Status Value Property |
Optional. Select a property to hold the status code of the Connect-HTTP method. Use this field and the Status Message Property field when you want to manage exceptions in the connector activity rather than with an error handler flow. |
Status Message Property |
Optional. Select a property to hold status descriptions or return values from the external system returned by the Connect-HTTP method. |
Error Handler Flow |
C-1075 Optional. Identify a flow rule to route work objects that cannot continue in its current flow because this connector rule was unable to connect to the external system. The default flow rule Work-.ConnectionProblem provides one approach for handling such problems. See Handling connector exceptions. |
Field |
Description |
Processing Options |
You can allow connector requests from this Connect HTTP to be processed asynchronously in parallel with the calling activity, or in background by an agent. (The mode of execution of each connector request is determined by the Execution Mode parameter of the Connect-HTTP method, as enabled by the values in these two fields.)5.5 GRP-255 |
Intended For |
Optional. Select:
Blank is equivalent to Queuing, when selected, occurs only if also specified in the Connect-HTTP method. |
Request Processor |
Optional. If you selected queuing for the Intended for field, identify here a Connect Request Processor data instance that defines the classes and other characteristics of the queued connector requests, and for which the RuleSet key part matches the RuleSet of this Connect HTTP rule. See More about HTTP Connector rules. |
Field |
Description |
Test Connectivity |
After you complete and save this rule, click this button to test whether Process Commander can connect to the external system. C-1704The system presents test results in a separate window, identifying the parameters used in the test, the steps attempted, and the outcome of each step. |
Simulations |
Click to create a simulator for this connect rule. See Creating connect simulators. |