Back Forward SOAP Connector Form
Completing the Advanced tab

About Connect SOAP rules

  Show all 

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 model rules that define the schema, and to enable Web Service Security for the connector.

 Client Properties

The Process Commander 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 V5.5 or later use AXIS version 2.
(Connect SOAP rules created in earlier versions may use AXIS 1.2.1.)

SOAP Version

SmartPrompt is available.Specify which version of the SOAP specification is implemented by the Web service this connector communicates with. If you used the Accelerator to generate this connector, it is set to 1.1. If you specify 1.2, set the Axis Version to Axis2.

HTTP Version

SmartPrompt is available.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.

 Web Service Security

If your application requires a secure SOAP connection, you can enable Web Services Security (WSS).GRP-692

Field

Description

Enable WS Security

Select this option to enable Web Services Security on this connector.

Enable WS Addressing

Select this option to include routing information in the SOAP header.

Security Profile

Specify the WSS profile to use with this connection. See About WS Security Profile data instances.

  NTLM Security

Schema Definitions

C-500 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 model rules 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 models specified on this tab is set to XML Page.

  • If this rule was not created using the Connector and Metadata accelerator, leave this section blank. You cannot configure a mapping for a XML object except by using the Connector and Metadata accelerator. BURND 7/31/06
  • If this rule was created using the Connector and Metadata accelerator, make changes carefully. You can update the Page Name and the Model name fields. Do not change the Class Name field.

Field

Description

Page Key

Identify the clipboard page that contains the data values to be mapped to or from the XML object.

Class Name

SmartPrompt is available.Specify the class of that page.

Model Name

SmartPrompt is available.Specify a model rule to use as the schema description of the XML object.

In most cases, the generated model specified in this field is appropriate. However, the generated models 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 model that specifies the properties to map in the order they are to be mapped. Then select that model rule in this field.

 Compensating Action

Advanced featureOptional. Use the Compensating Action and Compensating Action Data section of this tab to associate a compensating action with a work object when the connector rule succeeds. For more information, see PDNUsing Compensating Actions, a document on the Integration section of the Pega Developer Network.

Field

Description

Work Page Name

C-766 R-11238 Optional. Specify the name the page that holds the work object. Typically this is pyWorkPage.

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

SmartPrompt Optional. Identify the Applies to class — first key part — of the activity that performs the compensating action.

Action Activity Name

SmartPrompt Optional. Identify the Activity Name — second key part — of the activity that performs the compensating action.

Compensating
Action Data

Optional. Use this section to store information about the current state of the work object as parameter-value pairs when the purpose of running the compensating action activity is to restore the work object to the state it is in directly after the connector rule runs.

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.

Up About SOAP Connector Rules