Creating RA Web Service SOAP Agent Connection Objects

To link the RA Web Service SOAP Agent to an RA Web Service SOAP Agent Job's web service, you must create a Connection object.

RA Web Service SOAP Agent Connection objects store all the connection information to a service end-point. They define the security protocol and corresponding credential information. RA Web Service SOAP Agent Connection objects also contain the URL of the WSDL. You assign RA Web Service SOAP Agent Connection objects to your RA Web Service SOAP Agent Jobs. RA Web Service SOAP Agent Connection objects can also contain global headers that can be used in your Job definitions.

To create RA Web Service SOAP Agent Connection object:

  1. Add a Connection object of type WEBSERVICESOAP > SOAP.
  2. Select the Web Service object tab.
  3. Specify the WSDL file for the Connection object by either: 
    • Typing it into the WSDL field.
    • Using the browse icon to browse URL for a WSDL file for this Connection object.

      • You can browse for the WSDL file on the Agent machine using the WSDL dialog.

    Security authentication or proxy settings may be required to retrieve the WSDL. You specify security settings selecting a security authentication from the authentication field in the authentication panel and specifying its details. For more information on security authentication settings, see Specifying Authentication Settings for RA Web Service SOAP Agent Connection Objects. In some rare cases, you may need to specify authentication settings to retrieve the WSDL, and then later specify different authentication settings for the end URL. For more information on proxy settings, see Using a Proxy Server for RA Web Service SOAP Agent Connection Objects.

    If your WSDL file includes umlauts characters on UNIX/Linux java distribution, a special parameter for javac is required. In this case, it's necessary to export an environment variable as shown below so that this settings will be automatically active:

    export JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF8

  4. Click the Retrieve button.

    5. The RA Web Service SOAP Agent lists all the services defined in the .wsdl file in the Service field.

  5. Select a service from the Service field.
  6. Select a port from the Ports field.

    7. The RA Web Service SOAP Agent lists all the available methods in the Operations Preview box.

  7. To override the service endpoint defined in the .wsdl file, check the Overwrite, URL Endpoint checkbox and enter a new endpoint in the URL Endpoint field.
  8. Optionally specify security settings using the Authentication section of the page. For more information, see Specifying Authentication Settings for RA Web Service SOAP Agent Connection Objects.
  9. Optionally add HTTP headers to the Connection object to pre-populate them in Jobs using the HTTP Request Headers section of the page. For more information,,see Defining HTTP Headers for RA Web Service SOAP Agent Connection Objects.
  10. Optionally add SOAP headers to the Connection object to pre-populate them in Jobs using the SOAP Request Headers section of the page. For more information, see Defining SOAP Headers for RA Web Service SOAP Agent Connection Objects.
  11. Optionally specify proxy settings using the Proxy section of the page. For more information, see Using a Proxy Server for RA Web Service SOAP Agent Connection Objects.
  12. Optionally specify advanced settings on using the Advanced section of the page. For more information, see Specifying Advanced Settings for RA Web Service SOAP Agent Connection Objects.
  13. Click Save.

The Login field on the Attributes page is not used for Automation Engine Jobs of the Web Service SOAP Agent.