Invoke Web Services

  • Article

Applies To: Opalis 6.3

The Invoke Web Service object will execute a web service with XML parameters that you specify.

You can use the Invoke Web Service object to invoke a web service that converts a date from the North American format to a standard format that is used in all data center operations.

Configuring the Invoke Web Service Object

When configuring the Invoke Web Service object you need to know specific information about the web service that you are invoking. For any web service that you want to invoke, you must have access to the following information:

  • WSDL file of the web service

  • Web service method name

  • Input SOAP message body format

  • Output SOAP message body format

Once you have obtained a WSDL document, you can search it for the other information that you need. However, reading a WSDL file can be difficult for inexperienced users and it may be worth while to find the other information from sources that are more human-readable.

Opalis Integration Server enables you to configure HTTPS certificate options in case certificate validation fails.

To configure HTTPS certificate options

  1. In the Opalis Client, click the Options menu and select Invoke Web Services. The Invoke Web Services dialog appears. Do one of the following:

    Accept all certificates - Accept certificates from all hosts.

    Accept certificates from trusted hosts - Specify the hosts that you want to accept certificates from. Select this option and click Add. The Trusted Host dialog appears. Type the trusted host name in the Value field and click OK. The host appears in the list. To edit or remove hosts, click Edit or Remove.

  2. Click Finish.

To configure the Invoke Web Service object

  1. From the Objects pane, drag a object to the active policy.

  2. Double-click the object icon. The Properties dialog opens.

  3. For information about the settings on the Details tab, the Advanced tab, and Security tab, see the following tables.

  4. For information about the settings on the General tab, the Run Behavior tab, and other tabs if applicable, see Common Tabs.

Details Tab

Element Configuration Instructions

WSDL

Type the path of the WSDL file or use the ellipsis (...) button to browse for the file.

Method

Type the name of the method that you are invoking on the web service, or click the ellipsis button (...) and browse for it. Make sure that you match the casing of the method.

XML Request Payload

Type the parameters that you are sending to the web service method. Make sure that the format matches what is described in the WSDL document.

Format Hint

Click this button to receive hints on formatting the XML request payload. Replace the placeholder values with your own.

Advanced Tab

Element Configuration Instructions

Save

To save the responses, select the Save check box and specify the folder where the responses will be saved.

URL

To specify the URL location of the web service, select the URL check box and type the URL location.

Value

Select the SOAP protocol that the web service uses.

Security Tab

Element Configuration Instructions

Enable

Select the Enable check box to enable HTTP authentication, and fill in the fields.

User name

Type the user name to access the secured web service.

Password

Type the password to access the secured web service.

Invoke Web Service Published Data

The following table lists the element names and descriptions of the data published by this object. For information about the published data elements that are common to all objects, see Policy Workflow Rules.

Element Name Description

WSDL Path

The WSDL path.

Method Name

The name of the web method.

XML Request Payload

The text of the XML request payload.

XML Response Payload

The text of the XML response payload.

Response File

The path and filename of the response.

Web Service URL

The URL of the web service.

Web Service protocol

The protocol that the web service uses.