Integrating with Rational Change through OSLC
- Properties that are specific to Rational Change
are defined in the namespace:
http://www.ibm.com/xmlns/prod/rational/change/1.0/
The namespace prefix is required to be change. XML results returned from Rational Change define this prefix in the XML document. JSON results use the change prefix without defining it. Requests sent to Rational Change must follow the same convention. The oslc_cm.properties parameters assume that any properties without an explicit namespace are in the change namespace.
- HTTP basic authentication and OAuth is supported.
- Rational Change specific
properties are defined in the namespace:
http://www.ibm.com/xmlns/prod/rational/change/2.0/
You must change the namespace prefix. This namespace prefix change must always be used when getting or setting Rational Change specific properties.
- Only HTTP basic authentication is supported.
OSLC terms in Rational Change
- Change Request
- In Rational Change, this term is the same as a normal Rational Change change request. Other OSLC-CM tools might use this term to describe other, similar resources.
- Property
- OSLC-CM properties are equivalent to Rational Change attributes and CR-to-CR relationships. When requesting properties, you can use the existing attribute names you are already familiar with from your lifecycle. Additionally, there are a few OSLC-CM common properties (for example, dc:title and dc:identifier), that Rational Change automatically maps to existing attributes.
- Link
- OSLC-CM links are special types of properties that represent links between different OSLC resources. In Rational Change, they are normally used for traditional CR-to-CR relationships. However, when used with attributes with the OSLC_LINK web type, they can also be used to store hyperlinks to OSLC-CM resources in other CM repositories. Remote hyperlinks can be viewed from show forms. However, they can be created only through this API.
Customizing common OSLC properties for your lifecycle
OSLC defines a number of property names that can be used with most OSLC providers without knowing the specifics of each provider. For example, in Rational Change you get the change:problem_synopsis attribute from the common attribute dc:title for OSLC-CM 1.0 or dcterms:title for OSLC-CM 2.0.
These common properties are automatically mapped to Rational Change attributes and relationships common to most Rational Change lifecycles. If the mapping does not work for your lifecycle, override them by creating an app.user.properties file as described in WEB-INF/wsconfig/system/app.properties. See the dc_title in the app.properties key for more details.