如果应用程序支持 RESTful API,您可以根据 IBM® Rational® Focal Point™ 中的业务需求,在该应用程序中创建工件。
例如,您可以根据 Rational Focal Point 中的业务需求,在 Rational solution for
Collaborative Lifecycle Management 的“需求管理”应用程序中创建需求。
过程
- 在 Rational Focal Point 中,打开工作空间。
- 单击,然后单击添加视图命令。
- 选择要添加视图命令的视图。
- 在“REST 客户机命令配置”部分中,完成以下步骤:
- 在 REST 客户机连接符名称中,输入用于标识连接的名称。
- 在 REST 请求方法中,选择 POST 方法。 有关使用每种方法的信息,请参阅“受支持的资源管理方法”主题。
- 在好友列表中,选择作为好友添加到 Rational Focal Point 中的应用程序。
- 在选择 POST 的唯一属性中,单击选择,然后选择属性。 该属性为空。执行首个 POST 操作后,会存储应用程序的响应 URL。因此,对于后续 POST 操作,如果 URL 相同,那么将不会针对该 URL 执行 POST 操作。
- 在 REST 应用程序请求 URL 中,输入用于创建工件的应用程序区域的顶级 URL。 例如,对于“需求管理”应用程序,使用需求创建工厂 URL。要获取此 URL,通常可使用根服务 URL 来获取 RMCatalog URL。您可以使用 RMCatalog URL 来获取项目区域 URL;然后使用项目区域 URL 来获取需求工厂 URL。
- 在“REST 客户机模板 XML 配置”部分中,完成以下步骤:
- 在模板 XML 的 REST 应用程序 URL 中,输入指向应用程序中工件的 URL,然后单击获取模板 XML。 该 XML 将装入到 REST 应用程序模板 XML 文本框中。如果不希望动态装入 XML,可将该 XML 复制到 REST 应用程序模板 XML 文本框中。
注: 对于 POST 操作,您必须知道发布工件所在应用程序的 XML 结构。
因此,您可以动态或手动获取 XML。获取代码后,该 XML 必须支持将新数据发布至应用程序。在某些应用程序中,如果该 XML 不支持该操作,您必须手动创建或编辑该 XML。
- 在 REST 应用程序工件的根 XPath 中,单击选择,然后选择属性的根 XPath。 只有在 REST 应用程序模板 XML 中的 XML 正确无误时,才会启用选择按钮。
- 在属性映射部分中,单击添加,并将 Rational Focal Point 属性映射到应用程序的属性。 例如,如果将 Rational Focal Point 的“标题”属性映射到应用程序的“名称”属性,那么在执行 POST 操作后,应用程序中的“名称”属性会更改为标题。
- 在“响应”部分中,完成以下步骤:
- 在 REST 应用程序模板 XML 中,指定为响应 GET 方法而接收的 XML,或者指定应用程序的其他任何 XML。在 REST 应用程序工件的根 XPath 中,指定属性的根 XPath,然后在响应属性映射中,单击添加以映射属性。
- 在“响应头映射”部分中,单击添加以将应用程序头映射到 Rational Focal Point 属性。 应用程序头会存储该应用程序的 XML。通常,Rational solution for CLM 应用程序头为 Location.
- 在“配置”部分中,完成以下步骤:
- 在 REST 应用程序支持的日期格式中,输入外部应用程序使用的日期格式。
- 在 Focal Point 分隔符中,输入分隔符值,如逗号 (,) 或分号 (;)。
“多项选择”和“链接列表”项目将由指定的分隔符隔开。
- 要在 Rational Focal Point 和该应用程序间映射属性标识,请在“请求参数表”部分中单击添加,然后选择 Rational Focal Point 属性。
在密钥列中输入该应用程序标识。 例如,如果选择 Rational Focal Point 的项目标识,请在密钥列中输入将用作该应用程序中项目标识的标识。
- 在“请求头映射”部分中,单击添加,然后输入该头的名称和值。 对于 Rational solution for CLM 应用程序,这些头如下:
| 头名称 |
头值 |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- 单击保存。
- 在显示菜单中,选择要在其他应用程序中创建其元素的视图。
- 要创建视图中的所有可用工件,请从视图工具栏中单击下拉列表,选择 POST 视图命令,然后单击执行图标
。
- 要创建一个工件,请从工件工具栏中,选择 POST 视图命令,然后单击执行图标
。