Creating SOAP API calls

SOAP web service calls are typically created using Visual Studio.

Perform this procedure using Visual Studio:

Note: The procedure for creating a SOAP web service call assumes that you have added a reference to your project for the IDO .NET web service, as follows.
  1. Perform one of these actions:
    • Right-click the References node in the Solution Explorer.
    • From the Project menu, select Add Service Reference.
  2. Provide the URL for your .NET web service, using this syntax:
    http://server/IDORequestService/IDOWebService.asmx

    where server is the name of DNS or IP address of the server that hosts your web service.

  3. Set the Namespace to IDOWebServiceReference.
  4. Click OK.
You can redirect calls at runtime (for instance, to a production server rather than a test server) by passing two parameters to the constructor, for example:

IDOWebServiceReference.DOWebServiceSoapClient idoWS = new

IDOWebServiceReference.DOWebServiceSoapClient( "IDOWebServiceSoap", "http://other_server_name/IDORequestService/IDOWebService.asmx" );

Note: You can add a query parameter to the .NET web service URL to specify the configuration group, which applies to the GetConfigurationNames web service API; for example: http://server /IDORequestService/IDOWebService.asmx?configgroup=group-name

where group-name corresponds to the name of a configuration group created with the Configuration Manager utility.

When creating your SOAP web service API calls, we recommend that you use the prototypes in this document as examples. All the prototype examples are given in C#.