运用 REST API 集成及扩展 IBM Rational Team Concert

格式二：

https://<server>:<port>/jazz/oslc/workitems/　
<resource　identifier>.<media　type　extension>

实例如：

https://localhost:9443/jazz/oslc/workitems/821.xml

以及

https://localhost:9443/jazz/oslc/workitems/_Kk8YQFElEd6wrL4Qi7w25Q.json

此此格式主要用于开发阶段。

除了 .xml 和 .json，其他几种支持的媒体类型扩展包括：.hover.html，.atom 以及 .xhtml。如若要返回一个资源的多种表象则需要通过指定 HTTP 的 Accept 头信息或者在 URL 中指定 _mediaType 参数，例如：

https://localhost:9443/jazz/resource/itemName/　
com.ibm.team.workitem.WorkItem/821?_mediaType=application/x-oslc-cm-changerequest%2Bjson

该 URL 将返回工作项 821 的 JSON 格式数据。

获取资源表象部分属性

有时我们只需要获取一个资源部分属性数据，尤其在移动设备应用中，出于减少带宽消耗的考虑，我们通常只获取我们真正需要的数据。通过在 URL 中添加 oslc_cm.properties=propA,propB 可以实现资源部分属性数据的获取。例如：

https://localhost:9443/jazz/oslc/workitems/　
821.json?oslc_cm.properties=dc:identifier,dc:title

将仅返回资源的 dc:identifier 和 dc:title 属性值。

查询工作项

查询工作项通过在 https://<host>:<port>/jazz/oslc/contexts/<project area id>/workitems 的后面添加 ?oslc_cm.query=[query] 语句实现。[query] 是一个 CM Query 语句。详细语法请参见 变更管理查询语法讲解。