Registering the BMC Helix ITSM web service

You can integrate external applications with BMC Helix ITSM by using web services that eliminate the need to create API applications. For example, you might want to have an event occur in an event-based system that causes the web services client to connect to BMC Helix ITSM and create an incident, problem, change, or purchase order ticket.

To work with BMC Helix CMDB web services, you must register your services. The BMC Helix CMDB Web Services Registry enables clients to obtain information about available services. The services registry is compliant with the Universal Description, Discovery and Integration (UDDI) standard. For more information about the Web Services Registry, see  Learning about BMC Helix CMDB web services . 

The AR System Web Services Registry form and its workflow provide an interface to the BMC Helix CMDB Web Services Registry. A web service is registered by creating a request in the form and enabling it. Changing a setting removes the registration. If the registry is unavailable, the workflow attempts to register or deregister the web service later. The form also reports whether the web service is registered.

Before you begin

Ensure that the Java plug-in server is installed and operating.

You must configure a connection to the BMC Atrium Web Services Registry in the WS Registry Integration tab of the AR System Administration: Server Information form. For more information, see  Configuring the Web Services Registry integration .

To register a BMC Helix ITSM web service

1. From the Applications menu, select AR System Administration > AR System Administration console.
2. From the AR System console, select System > General > Web Services Registry.
   
   
3. Perform a search for services by using the following criteria:
   • Type BMC in the Business Name field.
   • Select No for Publish to Registry?.

   • Select Yes for Recommended Value.
     The list of BMC Helix ITSM services that are shipped with the product is returned.
     
     

     Important

     If you have created entries since installing BMC Helix ITSM, these are also returned in the list.

4. Select a registry from the list.
   The fields of the form are populated with information about this registry.
5. Make the following updates in the Build WSDL URL section:
   1. If you want the WSDL URL to be built and displayed in the WSDL URL field, select Yes for the Build WSDL URL field.
   2. In the Web Server Address field, replace WebServerAddress with the URL of the web server that provides the WSDL.
   3. (Optional) Include the port number.
      The syntax is http:<webServer>:<port>.
   4. In the ARServer field, enter the name of the AR System server that hosts the web service.
6. Make the following updates in the Build End Point URL section:
   • If you want the end point URL to be built and displayed in the End Point URL field, select Yes for the Build End Point URL field.
   1. In the Web Server Address field for the end point URL, replace webServerAddress with the URL of the web server that provides the end point URL.
   2. (Optional) Include the port number.
      The syntax is http://<webServer>:<port>.
7. In the ARServer field, enter the name of the AR Systemserver that hosts the end point URL for the web service.
8. For the Publish to Registry field, select Yes.
9. Save the form.
10. Complete step 4 through step 8 for all the BMC Helix ITSM services returned in your search.