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
|
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
|
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-692Field | 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
If your application requires a secure SOAP connection, you can enable
Web Services Security (WSS).
GRP-692Field | Description |
Use Authentication? | If selected, authentication credentials are included 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 define such header contents using the Request tab. |
Authentication Profile | Required. If Use Authentication? is selected, select the Authentication Profile that contains the authentication details required by the remote service. |
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
|
Specify the class of that page.
|
Model Name
|
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
Optional. 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 Using 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
|
Optional. Identify the Applies to class
— first key part — of the activity that performs
the compensating action.
|
|
Action Activity
Name
|
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.
|
About SOAP Connector
Rules