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

核心提示： 创建草稿工作项同创建一般的工作项一样，只需将发送的目标 URL 改为如下：https://localhost:9443/jazz/oslc/contexts/_9BHm0EqVEd6HXO10niqZpg/drafts/workitems更新工作项更新工作项的过程为：首先以某种媒体格式获取资源数

创建草稿工作项同创建一般的工作项一样，只需将发送的目标 URL 改为如下：

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

更新工作项

更新工作项的过程为：首先以某种媒体格式获取资源数据，接着根据需要对数据进行修改，最后发送 PUT 或者 PATCH 请求。可能会出现在你获取资源并且提交修期间其他客户端也修改了该资源的情况，如果没有采取任何措施，那么你的提交就会覆盖先前那个客户端的修改内容，从而造成数据丢失。为防止此现象的发生，你可以在获取资源后获取并保存它的 ETag 属性值，并在发送 PUT 或者 PATCH 请求的 If-Match 头信息中设置该 ETag 值。那么，倘若其他客户端在期间做了修改，你将会收到 HTTP 响应的 412 返回代码。此时，你应该重新获取数据并修改后重新提交。

更新工作项的部分属性

有时我们需要更新工作项的部分属性（或许这样更加安全）。你可以通过以下两种方式：

方法一：发送 URL 中带有 oslc_cm.properties 的 PUT 请求

例如，发送 PUT 请求到：

https://localhost:9443/jazz/resource/　
itemName/com.ibm.team.workitem.WorkItem/821?oslc_cm.properties=dc:type

无论发送的数据中包含多少更改，都只更新 dc:type 属性。

方法二：发送 PATCH 请求

例如，发送仅包含 dc:type 属性的数据的 PATCH 请求到：

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

也将只更改其 dc:type 属性。

增加 / 删除链接

通过在发送的工作项表象数据中包含链接更新整个工作项是一增加链接的方式，除此以外，你还可以采用发送包含如下的 JSON 或者 XML 数据的 POST 请求到形如：