Checklist: Creating a custom Web Services client

You can create custom Web Services client applications to connect and conduct transactions with the Service Manager Web service. Any custom clients you create must be able to send and receive from the Service Manager server valid SOAP messages.

  1. Publish the Service Manager tables to which you want the custom client to connect as Web Services. You can use Service Manager Web Services API out-of-the-box, or customize the Web Services to meet your business needs.
  2. Obtain a Web Services client development tool that can create a complete Web service application, such as Microsoft .NET™ or Apache Axis™, or obtain a tool that generates a complete Web Service application by evaluating the target WSDL file, such as GotDotNet™ WebServiceStudio™.
  3. Browse to the URL of your Service Manager server and download the WSDL files for the services you want your custom clients to use. Use your Web Services client development tool to browse the WSDL and determine which features you want your custom client to use.

    Note The URL of your server must include the listener port and the Web service name. For example, http://smserver:13081/IncidentManagement.wsdl connects to the smserver host on port 13081 and requests the IncidentManagement WSDL.

    Caution Do not use the Load Balancer listener port for all incoming Web Services requests. Instead, dedicate one or more Service Manager server processes to serve Web Services requests by adding the "debugnode" parameter to the process you wish to dedicate to serve Web Services requests.

  4. Use your Web Services client development tool to generate the programming language client code that invokes the Service Manager Web Services for the Service Manager Web Services. Tools such as .NET wsdl.exe or Axis wsdl2java can generate client code that can be used to invoke the Service Manager Web Service from the WSDL.
  5. Write a client application in the appropriate language of your client development tool. For example, .NET requires Microsoft C#™ or Visual Basic™; Axis requires Java.

    Tip The Service Manager installation DVD contains source code for several sample Web Services client applications you can use as templates for your own custom clients. The source code includes Axis and .NET examples.

    Note There are many Web Service application development tools available such as Microsoft Visual Studio .NET™, Systinet WASP™, Glue™, Apache Axis™, or Sun Web Services Developer Pack™. Service Manager users and application designers can choose any third-party tool with the understanding that Micro Focus publishes only the WSDL files for the web service. Troubleshooting the client application is the responsibility of the application developer, and outside the scope of Service Manager Customer Support.

Technical support for custom Web Services clients

Custom Web Services clients and any code or scripting that you add to interface with the Service Manager products are outside the scope of the Micro Focus product suite and are not covered under maintenance and support contracts. Ensure that you have full access to the appropriate resources to assist you with training, debugging, and maintaining any code that you add to your Service Manager environment.

We provide a working example database and several sample Web Services clients that can help you troubleshoot your custom clients and determine where errors occur.