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

核心提示： 简单来说，RTC REST API 提供了如下功能：以多种格式（如 JSON、XML、ATOM 以及 HTML）在不同粒度级别上获取工作项通过更新 JSON 或者 XML 的方式修改工作项的属性通过获取 HTML 的创建对话框模块来创建工作项通过发送带有 JSON 或者 XML 格式数据的 Po

简单来说，RTC REST API 提供了如下功能：

以多种格式（如 JSON、XML、ATOM 以及 HTML）在不同粒度级别上获取工作项

通过更新 JSON 或者 XML 的方式修改工作项的属性

通过获取 HTML 的创建对话框模块来创建工作项

通过发送带有 JSON 或者 XML 格式数据的 Post 请求创建工作项

增加或者删除链接

通过全文检索和指定属性查询工作项

通过获取 HTML 的选择器模块查询工作项

RTC REST API 详解

下面对 RTC REST API 的功能做更为具体的介绍。

服务发现

RTC 提供了服务发现机制。用户应当通过该机制获得需要的服务 URL 而不是将服务 URL 硬编码在自己的程序中。根服务发现 URL 格式如下：

https://<server>:<port>/<app>/rootservices

实例如：

https://localhost:9443/jazz/rootservices

该 URL 将返回一个 XML 文档，其中对主要的服务资源入口做了定义。该机制是一个链式机制，也就是说，当你获得了根服务描述文档后，可以根据其中包含的资源的 URL 进一步获取子集中的服务 URL。

获取资源表象

通过如下两种 URL 格式可以获取资源表象。

格式一（位置 URI）：

https://<server>:<port>/jazz/resource/itemName/　
com.ibm.team.workitem.WorkItem/<resource　identifier>

实例如：

https://localhost:9443/jazz/resource/itemName/　
com.ibm.team.workitem.WorkItem/262

以及

https://localhost:9443/jazz/resource/itemOid/　
com.ibm.team.workitem.WorkItem/_Kk8YQFElEd6wrL4Qi7w25Q