Discovering services

You can find OSLC services through a series of linked XML documents.

This process is known as service discovery and is explained in the OSLC Service Description Specification.

The process is similar in OSLC-CM 2.0 and is mentioned in the OSLC 2.0 Core Specification.

In Rational® Change, the root service discovery document for 1.0 and 2.0 can be found at:

http://change_host:port/context/oslc

For example: http://myserver:8600/change/oslc

The 2.0 document is requested by passing the OSLC-Core-Version HTTP header with a value of 2.0 as described in the OSLC core specification.

You can set up a tool that integrates with Rational Change by using the OSLC-CM API tool. In this situation, you might not need to examine the services. The tool discovers the services on its own from the root document. If you are setting up a tool that works with RESTful web services but does not know specifically about OSLC-CM, then examine the service documents.

The root discovery document contains a URL for each of your Rational Change databases. Opening a database URL lists all of your login interfaces, and opening an interfaces URL lists the available services.

For OSLC-CM 1.0, Rational Change supports the services described in the OSLC-CM 1.0 API specification. It also supports Rational Change specific queries and reports services so that you can access your saved queries and reports.

For OSLC-CM 2.0, Rational Change supports the requirements listed under Compliance in the OSLC-CM 2.0 specification. It does not support Partial Update.

Tools based on the Jazz™ platform expect a slightly different root discovery document, which is found at:

http://change_host:port/context/rootservices

For example: http://myserver:8600/change/rootservices


Feedback