您可以创建 REST URI 以提交用户数据库中的记录。
过程
- 在 Rational® ClearQuest® Web 工具栏上,单击新建变更请求旁边的箭头,然后选择新建 REST URI。 “新建 REST URI”模板窗口随即打开。
- 从 REST URI 类型列表中选择提交记录。
- 从记录类型列表中选择记录类型。
- 可选:从自动填充的记录字段列表中选择要作为参数添加到 REST URI 的记录字段。
- 可选:要保存对记录所作的所有更改,请选中自动保存更改复选框。
- 可选:要将 Rational ClearQuest Web 登录参数添加到 REST URI 中,请选中自动登录复选框。
- 可选:要将条幅、工作空间树和主工具栏包含到运行 REST URI 时打开的窗口中,请选中包含条幅、工作空间树和主工具栏复选框。
- 单击创建。 REST URI 模板将出现在 REST URI 模板字段中。
- 将该模板复制到文本编辑器中,然后用适当的值替换占位符,占位符用双大括号 {{ }} 括起。
可选:将资源请求的缺省格式从 HTML 更改为 XML 或 ATOM。
- 将修改后的模板复制到 Web 应用程序或另一个 Web 浏览器窗口中。
- 单击复位创建新的 REST URI 模板或单击关闭退出。
示例
示例
用于提交记录的以下 REST URI 模板使用“新建 REST URI”向导创建。在该示例中,从记录类型列表中选择了 ALMActivity,并选中了自动保存更改、自动登录和包含条幅、工作空间树和主工具栏复选框以创建 REST URI。
http://CQWebServerHost/cqweb/restapi/YourConnection/YourUserDB/RECORD?format=HTML&recordType=ALMActivity&fieldsXml=&autoSave=true&loginId={{loginid}}&password={{password}}
变量和模板占位符具有以下含义:
- CQWebServerHost
- ClearQuest Web 服务器主机系统的 Web 地址。该值在创建 REST URI 模板时定义。
- YourConnection
- 您的 ClearQuest 连接。该值在创建 REST URI 模板时定义。
- YourUserDB
- 您的 ClearQuest 用户数据库。该值在创建 REST URI 模板时定义。
- format
- 资源请求的缺省格式是 HTML。您可以根据需要将格式更改为 XML 或 ATOM。
- {{loginid}}
- 用您的登录标识替换。
- {{password}}
- 用您的密码替换。
以下示例显示如何将日期字段、引用字段、引用列表和多行字段值作为参数输入到 REST URI 中。
- 该示例显示如何在 REST URI 中将日期字段值作为参数提供来提交或修改记录:
fieldsXML=<Field><Name>f_datetime</Name><Value><![CDATA[2008-09-08%2009%3A44%3A34]]></Value></Field>
结果:记录字段 f_datetime 设置为 08/09/08 09:44:34。
- 下一个示例显示如何在 REST URI 中将引用字段或引用列表值作为参数提供来提交或修改记录:
fieldsXML=<Field><Name>customer</Name><Value><!CDATA[Joe%20Lee]]></Value><Value><!CDATA[Jane%20Smith]]></Value></Field><Field><Name>Project</Name><Value><!CDATA[Classics]]></Value></Field>
结果:在记录中的引用列表 customer 中添加了 Joe Lee 和 Jane Smith,在引用字段 Project 中添加了 Classics。
- 该示例显示如何在 REST URI 中将多行字段值作为参数提供来提交或修改记录:
fieldsXML=<Field><Name>Description</Name><Value><![CDATA[firstline%0Asecondline]]></Value></Field>
结果:在记录字段 Description 中,文本 firstline 和 secondline 格式化为显示在不同行中。