IBM Support

Customizing ClearQuest fields for the Change Management Integration (CMI)

Question & Answer


Question

Which ClearQuest default record fields are required when using CMI and how can they be changed?

Answer

In the default ClearQuest out-of-the-box schema, the "Headline" field is mapped to the OSLC field dcterms:title. Both fields are required for CMI, but the "Headline" requirement can be customized with the customQueryField key in CMI:
  1. Choose the ClearQuest field in your record type to use instead of "Headline." This field is displayed when you run a query through CMI.
  2. Add that field to the "Query Presentation" of the ClearQuest query that you plan to use with CMI (this means that the field must be displayed when you run the query).
  3. Map the field to dcterms:title in oslc-mappings.xml on the ClearQuest Web Server. Refer to the ClearQuest Knowledge Center for instructions: http://www-01.ibm.com/support/knowledgecenter/SSSH5A_8.0.0/com.ibm.rational.clearquest.cli.doc/topics/r_oslc_mappings_xml.htm.
  4. For the -context option of the mkcmprovider command (on a branch type or UCM stream) set the key queryuri to the query you modified in step 2 and set the key customQueryField to the chosen ClearQuest field.

Example
For the record type Defect, this example substitutes the field "Summary" for the field "Headline."

1. Edit oslc-mappings.xml:

<oslcRecordConfig type="cq.record:Defect@CQDBSET/DB1">
<oslcFieldMapping name="dcterms:title" field="Summary"/>
</oslcRecordConfig>



2. Run the mkcmprovider command for a UCM stream or base ClearCase branch type, as applicable:
  • UCM stream:
    cleartool mkcmprovider -stream test_dev@\test_pvob -context “queryuri:query,customQueryField:Summary” test_provider
  • Branch type:
    cleartool mkcmprovider -brtype main@\test_vob -context “queryuri:query,customQueryField:Summary” test_provider

[{"Product":{"code":"SSSH27","label":"Rational ClearCase"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Integrations","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.0.17;8.0.1.10","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
26 February 2019

UID

swg21971611