|
|
Use the Advanced tab to change which version of Axis or SOAP is used, to associate a compensating action with the connector, to specify the data transforms that define the schema, and to enable Web Service Security for the connector.
The PRPC SOAP connector architecture uses an Axis client to make the SOAP call and process the SOAP response. Use the fields in this section to specify settings for the Axis client.
Field |
Description |
| Axis Version |
Connect SOAP rules created in version 5.5 or later use AXIS version 2. (Connect SOAP rules created in earlier versions may use AXIS 1.2.1.) |
| SOAP Version |
|
| HTTP Version |
As a best practice, because HTTP Versions are backward compatible, 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. |
| Enable MTOM? |
Select to enable the Message Transmission Optimization mechanism for this connector. |
If your application requires a secure SOAP connection, you can enable Web Services Security (WSS).
Field |
Description |
| Enable WS-Security |
Select this option to enable Web Services Security on this connector. |
| Enable WS-Policy |
Select this option if the web service exposes a WS-Policy. Specify the policy using a Webservice Policy data instance to interact with service. |
| Security Profile |
This security profile is also used for SSL enabled SOAP services. In the Security Profile you specify a Truststore which contains the server certificates to be used in the SSL handshake, and a Keystore which stores the client’s private/public key pair used by the server to authenticate the client. See About WS-Security Profile data instances. |
| Service Policy |
|
The following fields address configuration of the SOAP addressing headers. If you use the Connector and Metadata Accelerator on a Metadata Type WSDL file that contains WS-Addressing data, the fields in this section are pre-populated.
Note: you must save, close, and reopen the SOAP service record before setting up header mappings.
Field |
Description |
| Enable WS-Addressing |
Select this option to include routing information in the SOAP header. |
| Must Understand |
Select |
| Namespace |
|
| Action |
Enter the unique identifier for the intent of the request. This entry in this field should match the SOAPAction Header field if WS-Addressing is enabled, as per section 2.4 of WS-Addressing 1.0 specification for SOAP binding, http://www.w3.org/TR/ws-addr-soap/. If the SOAP Action is blank, this field's value should be calculated based on the default action pattern mentioned in WS-Addressing specification at http://www.w3.org/TR/2006/WD-ws-addr-wsdl-20060216/#defactionwsdl11. Use property references to override this field dynamically. |
| From |
Enter information about the message sender. |
| Reply To |
Enter the location the reply for the message should be sent to. If not present, reply is sent back to the endpoint the request came from. If the server is to respond to the sender synchronously, enter If the message is a one-way request, enter Use property references to override this field dynamically. |
| Fault To |
Provides the fault endpoint reference. Indicate where a fault message should be sent. If not present, the fault is sent back to the endpoint where the request came from. Use property references to override this field dynamically. |
| Relates To |
Use to relate to a previously sent message, so the service can determine who the sent the message. |
| Relationship Type |
Used in conjunction with the Relates To field, the type of relationship is identified by an absolute IRI. The related message is identified by an absolute IRI that corresponds to the related message's [message id] property. If not otherwise pre-populated: For Submission Namespace, enter Use property references to override this field dynamically. |
| Message ID |
Assign each message a unique identity. This identity can be used for duplicate detection, message correlation, and many other purposes. Use property references to override this field dynamically. |
Complete these optional fields to use Secure Token Service.
Field |
Description |
| STS Service Policy |
|
| WS Trust Version |
Optional. Select the appropriate WS-trust version to be used to construct the RequestSecurityToken:
|
Field | Description |
| Transport Name |
|
If you used the Connector and Metadata accelerator to generate the SOAP connector rule and the WSDL file of the Web service contains a schema description with complex types, this section of the Advanced tab specifies the data transforms that define the schema of the incoming and outgoing XML objects. (Typically, this indicates that the SOAP operation style is document-literal.)
On the Request and Response tabs, the Data Type of the XML objects described by the data transforms specified on this tab is set to XML Page.
Field | Description |
| Page Key |
|
| Class Name |
|
| Data Transform |
In most cases, the generated rule specified in this field is appropriate. However, the generated data transforms list every property in the class; you may not want to map a value for every property in the class. If you do not need all the properties, create a new data transform that specifies the properties to map in the order they are to be mapped. Then select that rule in this field. |
Optional. Use the Compensating Action and Compensating Action Data section of this tab to associate a compensating action with a work item when the connector rule succeeds. For more information, see Using Compensating Actions, a document on the Integration section of the PDN.
Field | Description |
| Work Page Name | Optional. Specify the name the page that holds the work item. Typically this is |
| Action Label | Optional. Enter a string that describes the purpose of the compensating action. For example, "Cancels Flight Reservation." PublicAPI methods can use this label to identify this compensating action within a Java step of an activity. |
| Action Activity Class |
|
| Action Activity Name |
|
| Compensating Action Data |
Click the none button and enter the name of a parameter used by the compensating action activity. Then, in the value field, select the property that is to be the source of the parameter value. |
SOAP Connector Form
Specify which version of the SOAP specification is implemented by the Web service this connector communicates with. If you used the Connector and Metadata Accelerator to generate this connector, and selected a SOAP 1.2 binding port, it is set to 
If Enable WS-Policy is not checked, specify the WS-Security Profile instance to be used to communicate with WS-Security enabled web services.
The WS-Addressing namespace takes precedence over the Dynamic System Setting wsa/versionURI.
Identify the clipboard page that contains the data values to be mapped to or from the XML object.
About SOAP Connector Rules