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

核心提示： 例如，下面这个查询是一个编码过的全文检索查询，运用 REST API 集成及扩展 IBM Rational Team Concert(5)，用来获取所有包含“NPE”文本的工作项，https://localhost:9443/jazz/oslc/contexts/_9BH

例如，下面这个查询是一个编码过的全文检索查询，用来获取所有包含“NPE”文本的工作项。

https://localhost:9443/jazz/oslc/contexts/_9BHm0EqVEd6HXO10niqZpg/workitems　
?oslc_cm.query=oslc_cm%3AsearchTerms%3D%22NPE%22

同样，你可以通过添加 oslc_cm.properties 语句限制结果返回的属性值，并且还可以使用“/sort” 指定查询返回结果的排序方式。分页查询也是支持的，例如使用 oslc_cm.pageSize 参数就可以指定查询结果每页返回的条目数。

使用预定义的查询语句

通过形如 https://localhost:9443/jazz/oslc/queries.xml（当然你可以用 queries.json）的 URL 可以获得所有预定义的查询语句。增加 oslc_cm.query 参数则可以根据指定的查询参数过滤返回的查询语句结果。获取查询语句的唯一标识符之后，便可进而通过如下的 URL 获取该查询的返回结果。

https://localhost:9443/jazz/oslc/queries/_vS4rsF5eEd6EzYK1TPZjDw/rtc_cm:results.atom

创建工作项

构造并发送包含某种媒体类型（例如 JSON）的工作项表象数据的 POST 请求到形如下的 URL 即可创建一个工作项：

https://localhost:9443/jazz/oslc/contexts/_9BHm0EqVEd6HXO10niqZpg/workitems

其中，_9BHm0EqVEd6HXO10niqZpg 是项目区域唯一标识符。那么，如何得知媒体类型的具体格式规范呢？当然，你可以通过查看 OSLC-CM 规范获得。但是，一个更为直观快捷的方式是你先用那种媒体类型获得某个工作项的数据，然后查看其格式。例如，你可以通过以下的 URL 返回的数据得知如何定义一个工作项的 JSON 格式表象。

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