Web Service (SOAP) Data Connector

SmartIQ supports Web Services that are writen under Simple Object Access Protocol, allowing to query external applications in real time.

Key Concepts

Simple Object Access Protocol (SOAP) defines a standard communication protocol specification for XML-based message exchange. The standard protocol HTTP makes it easier for SOAP model to tunnel across firewalls and proxies without any modifications to the SOAP protocol and has been extensively used.

w3.org

SOAP Version 1.2 Part 1: Messaging Framework (Second Edition)

Configuration

The configuration of SOAP Web Services is very straightforward as the only WSDL is to be specified in Connection String, either pointing to a URL or a local Path.

For this example, we will use a free currency converter available online.

http://www.webservicex.com/CurrencyConvertor.asmx?wsdl

Credentials have to be specified using one of this options:

• User Name and Password.
• Windows Authentication.
• Access Token.
• No Credentials required.

For this particular example, there's no need to specify credentials.

After saving Web Service Data Source in Manage, click on "Data Objects" button. This will bring a new window with all available Data Objects for this particular Data Source.

1. Click on **"New Data Object". Provide following information:

   Object Type: Method
   Data Object Name / Definition: ConversionRate
   Display Name: Conversion Rate

2. Add all filter fields clicking on "Add All >>" button.

3. Click "Save" button.

You should be able to pull live data providing FromCurrency and ToCurrency as Data Source Filter Fields in SmartIQ Design.

Connection URL Overrides

The base URL for the Web Service connection can be defined in both an uploaded WSDL and in the Connection Attributes of the data source. As the WSDL can be exported between environments, the Connection Attributes definition is used as an environment-specific override of the WSDL value.