Table of Contents

Search

  1. Preface
  2. Workflow Manager
  3. Workflows and Worklets
  4. Sessions
  5. Session Configuration Object
  6. Tasks
  7. Sources
  8. Targets
  9. Connection Objects
  10. Validation
  11. Scheduling and Running Workflows
  12. Sending Email
  13. Workflow Monitor
  14. Workflow Monitor Details
  15. Session and Workflow Logs
  16. Session Properties Reference
  17. Workflow Properties Reference

PowerExchange for Web Services Connections

PowerExchange for Web Services Connections

Use a Web Services Consumer application connection for each web service source or target that you want to access. Use a Web Services Consumer application connection for each Web Services Consumer transformation as well. Web Services Consumer application connections allow you to control connection properties, including the endpoint URL and authentication parameters.
To connect to a web service, the Integration Service requires an endpoint URL. If you do not configure a Web Services Consumer application connection or if you configure one without providing an endpoint URL, the Integration Service uses the endpoint URL contained in the WSDL file on which the source, target, or Web Services Consumer transformation is based.
Use the following guidelines to determine when to configure a Web Services Consumer application connection:
  • Configure a Web Services Consumer application connection with an endpoint URL if the web service you connect to requires authentication or if you want to use an endpoint URL that differs from the one contained in the WSDL file.
  • Configure a Web Services Consumer application connection without an endpoint URL if the web service you connect to requires authentication but you want to use the endpoint URL contained in the WSDL file.
  • You do not need to configure a Web Services Consumer application connection if the web service you connect to does not require authentication and you want to use the endpoint URL contained in the WSDL file.
If you need to configure SSL authentication, enter values for the SSL authentication-related properties in the Web Services Consumer application connection.
The following table describes the properties that you configure for a Web Services Consumer application connection:
Property
Description
User Name
User name that the web service requires. If the web service does not require a user name, enter PmNullUser.
To define the user name in the parameter file, enter session parameter $Param
Name
as the user name, and define the value in the session or workflow parameter file. The Integration Service interprets user names that start with $Param as session parameters.
Use Parameter in Password
Indicates the web service password is a session parameter, $Param
Name
. Define the password in the workflow or session parameter file, and encrypt it by using the
pmpasswd
CRYPT_DATA option. Default is disabled.
Password
Password that the web service requires. If the web service does not require a password, enter PmNullPasswd.
Code Page
Connection code page. The Repository Service uses the character set encoded in the repository code page when writing data to the repository.
End Point URL
Endpoint URL for the web service that you want to access. The WSDL file specifies this URL in the location element.
You can use session parameter $Param
Name
, a mapping parameter, or a mapping variable as the endpoint URL. For example, you can use a session parameter, $ParamMyURL, as the endpoint URL, and set $ParamMyURL to the URL in the parameter file.
Domain
Domain for authentication.
Timeout
Number of seconds the Integration Service waits for a connection to the web service provider before it closes the connection and fails the session. Also, the number of seconds the Integration Service waits for a SOAP response after sending a SOAP request before it fails the session. Default is 60 seconds.
Trust Certificates File
File containing the bundle of trusted certificates that the Integration Service uses when authenticating the SSL certificate of the web services provider. Default is ca-bundle.crt.
Certificate File
Client certificate that a web service provider uses when authenticating a client. You specify the client certificate file if the web service provider needs to authenticate the Integration Service.
Certificate File Password
Password for the client certificate. You specify the certificate file password if the web service provider needs to authenticate the Integration Service.
Certificate File Type
File type of the client certificate. You specify the certificate file type if the web service provider needs to authenticate the Integration Service. The file type can be either PEM or DER.
Private Key File
Private key file for the client certificate. You specify the private key file if the web service provider needs to authenticate the Integration Service.
Key Password
Password for the private key of the client certificate. You specify the key password if the web service provider needs to authenticate the Integration Service.
Key File Type
File type of the private key of the client certificate. You specify the key file type if the web service provider needs to authenticate the Integration Service. PowerExchange for Web Services requires the PEM file type for SSL authentication.
Authentication Type
Select one of the following authentication types to use when the web service provider does not return an authentication type to the Integration Service:
  • Auto. The Integration Service attempts to determine the authentication type of the web service provider.
  • Basic. Based on a non-encrypted user name and password.
  • Digest. Based on a non-encrypted user name and encrypted password.
  • NTLM. Based on encrypted user name, password, and domain.
Default is Auto.