Skip to main content

id3globalsupport.com

Implementing Our Service Via SOAPUI

What You’ll Need

SOAP UI allows you to quickly and easily integrate via our API.

What you will need:

1. Get SOAP UI here:

https://www.soapui.org/downloads/soapui.html

Installation Guide:

https://www.soapui.org/getting-started/installing-soapui.html

sl1.png

2. Credentials

Our service is accessed via credentials.

These can be checked via this URL: https://pilot.id3global.com/GlobalID/loginPage.aspx

The password will require changing on first login.

1-700x407.png

3. A Profile ID

This is available from the admin site:

https://pilot.id3global.com/GlobalAdmin/loginPage.aspx

Sending a SOAP Request

Step 1: Create the SOAP Project

  1. After SoapUI has loaded click on “File”

  2. The click “New SOAP Project”

  3. This will load a box in the centre of the screen which needs the following filled out:

  4. Click "OK"

Step 2: Calling our Main Method

r3.png
  1. This will load up the various bindings. Due to the compatibility issues with SoapUI (it cannot handle SOAP 1.2 without a workaround) you will need to use the “basic” bindings

  2. For the purpose of this document the method that will be examined is the AuthenticateSP method.

    1. Expand “basicHttpBinding_GlobalAuthenticate”

    2. Double click “Request 1”

  3. This will load a XML request for the AuthenticateSP method

    r4-700x573.png
  4. Remove the irrelevant fields in the XML as ID3global will throw an error is a “?” is processed in most of the fields due to input validation

    r5.png
  5. Until the request is trimmed down to the needed fields as below

    r6-700x511.png
  6. Enter in the data so that there are no questions marks left.

    Please note that “Version” should be entered as 0 as this will pick up the most recent version of the profile rather than this having to be changed if any changed are saved to the profile

    r7-700x506.png

Step 3: Setting the Credentials

7. Under “Request Properties enter Username and Password

e1.png

8. Also the “WSS-Password Type” needs to be set to PasswordText

c2.png

9. Once the request is complete click on the play button

r1-700x375.png

Alternatively…

A SOAP header can be used instead of the credentials being entered into “Request Properties” by using the below:

Username goes here

Password goes here

Step 4: Reviewing the Results

f1-700x405.png

At this stage you should have successfully made a call to the web service.

The XML response with provide a breakdown of all the item checks that have been triggered.

However, it is recommended to interpret the overall ‘Band Text’ as this has been set by the compliance team.

band-text.png