Connect SOAP form
|
Use the Service tab to identify the properties of the remote SOAP service. Complete this tab first.
Field |
Description |
Authentication | |
Use Authentication? |
If selected, Process Commander includes authentication credentials in the HTTP header of the SOAP request message. If your application requires SOAP headers that conform to a WS-Security format rather than using HTTP Basic/NTLMv1 authentication, you can configure the header directly on the Request tab. If you open a Connect SOAP instance configured in a version prior to Version 6.2, the rule form will contain a Username Property and Password Property field. To update the rule to use the Authentication Profile, save the rule and refresh rule form. The Username Property and Password Property fields will be replaced with the Authentication Profile field populated with a new profile. |
Authentication Profile |
Required, if Use Authentication? is selected. Select the Authentication Profile that contains the authentication details required by the remote service. |
Field |
Description |
HTTP Connection | |
Service Endpoint URL |
Enter the URL of the remote service provider to which the SOAP request message is sent. This field supports the Global Resource Settings syntax
(=.PageName.PropertyName). The default property name
for this field is |
Response Timeout |
Optional. Enter a number of milliseconds after which, if no response is received, this rule times out with a failure message. Enter zero or leave blank to wait indefinitely. 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 is share one 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 session data. |
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
|
Field |
Description |
Error Handling |
The properties in this section hold status and exception information returned by the Connect-SOAP method. To map SOAP fault messages returned by the external web service to the clipboard, use the Faults tab. |
Status Value Property |
Optional. Specify a single-value string property to hold the status code that the Connect-SOAP method returns. When you generate a connector rule with the Accelerator, this field is set to the standard property .pyStatusValue. 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. Specify a single-value string property to hold the status description for the status code that the Connect-SOAP method returns. When you generate a connector rule with the Accelerator, this field is set to the standard property .pyStatusMessage. |
Invocation Exception Property |
Optional. Specify a property of mode |
Error Handler Flow |
C-1075 Optional. Identify a flow rule that routes to an appropriate place a work object 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. |
You can allow connector requests from this Connect SOAP 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-SOAP method, as enabled by the values in these two fields.)5.5 GRP-255
Field |
Description |
Processing Options | |
Intended For |
Optional. Select:
Blank is equivalent to Queuing, when selected, occurs only if also specified in the Connect-SOAP 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 SOAP rule. See More about SOAP Connector rules. |
Test Connectivity |
Click this button at any time after you have completed and saved the form to confirm that Process Commander can connect to the Java class identified. 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 Connect Simulators. |