Creating SOAP API calls

SOAP web service calls are created 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. In Visual Studio, perform one of these actions:
    • In the Solution Explorer, right-click on the References node.
    • From the Project menu, select Add Service Reference.
  2. Specify the URL for your .NET web service. Use 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 you create SOAP web service API calls, we recommend that you use the prototypes as examples. All the prototype examples are given in C#.