使用模式发现向导添加 REST 数据源模式

可以为 REST 数据源创建数据源模式。创建模式可以简化针对具有相同结构以及相同或相似属性列表的模块编写文档模板的过程。
使用“模式发现”向导来创建数据源模式时,可以从应用程序可能支持的两个可报告 REST 选项(REST API 1.0 或 REST API 2.0)中选择。如果不知道应用程序所支持的 REST API 版本,请与系统管理员联系。

模式发现 (REST API 1.0)

  1. 在 Document Studio 中,单击数据 > 模式发现 > REST 模式发现
  2. 指定连接详细信息:
    1. 为数据源输入名称
    2. 为数据源输入描述
    3. 指定资源的基本 URL
    4. 从列表中选择认证类型 如果未选择任何类型,那么会测试每种类型,直至找到正确的类型。指定类型允许消除此过程。
    5. 如果资源位于受保护的服务器中,请指定用户名
    6. 如果资源位于受保护的服务器中,请指定密码
  3. 单击下一步
  4. 根据数据源是否使用数据服务,会显示下列其中一个窗口:

    如果数据源没有使用数据服务,那么“创建资源”窗口会显示。

    1. 为新资源输入名称
    2. 为新资源输入描述
    3. 为新资源输入相对路径
    如果可通过 Reporting Data Services 适配器访问 REST 数据源,那么“使用数据服务进行定位”窗口会显示。
    1. 在 XML 模式树中选择一个元素。
    2. 从属性列表中选择 href 值。
    3. 单击下一步。此时,会显示所选资源的资源 URL。
  5. 选择 URL 并单击完成,或者使用 URL 来定位子资源。要定位子资源,请执行下列操作:
    1. 选择资源 URL 并单击下一步
    2. 在 XML 模式窗格中选择元素。
    3. 从属性列表中选择 href
  6. 如果已定位子资源,请单击完成。 此时,向导会完成,并且 URL 会显示在“配置”窗口中。如果资源位于受保护的服务器上,请在“配置”窗口中输入用户名和密码。

模式发现 (REST API 2.0)

注: Rational® Publishing Engine 仅支持缩写的 RDF。提供者必须接受并采用 application/xml 请求。请参阅 Open Services for Lifecycle Collaboration Core Specification V 2.0
Rational Publishing Engine 仅支持遵循可报告 REST V2 规范的 OSLC V2 提供者。
  • OSLC 服务必须在预期用于报告的所有资源的服务资源中定义查询功能。
  • 用于报告的每项查询功能:
    • 必须让 oslc:queryBase 指向资源,该资源具有预期用于报告的资源列表。在列表资源的资源形状资源中,必须将列表中的资源标识为 oslc:isMemberProperty
    • 必须具有 oslc:resourceShape 以描述列表资源。
  1. 单击数据 > 模式发现 > REST V2 模式发现
  2. 指定连接详细信息:
    1. 指定资源的基本 URL
      必须知道要接受的服务提供者的 URL。此 URL 是可报告 REST 数据源的 Reporting Data Services 应用程序 URL 的等效项。Rational Publishing Engine 以查询列表的形式从数据源访存数据。可以从中查询和解释数据的服务会存储这些资源。该服务也提供查询服务来帮助依照设定的条件进行数据过滤,或者帮助优化数据子集。这些查询适用于一种资源,并且可让您访问特定类型的资源。可报告 ID2 服务可以显示许多资源类型,例如产品或用户变更请求。查询服务帮助用户有效地检索数据或数据子集,但不是必需的。查询服务适用于所有资源。每个产品都可以定义其资源以及访问这些资源的查询。
    2. 从列表中选择认证类型
    3. 如果资源位于受保护的服务器中,请指定用户名
    4. 如果资源位于受保护的服务器中,请指定密码
  3. 单击下一步
  4. 选择 REST V2 服务及其相应的查询,然后单击下一步 此时,会显示所选服务的属性。
  5. 从列表中选择必需的属性,然后单击测试 oslc.select 此时,“结果确认”窗口会显示所选服务。请确认服务是否正确。如果单击正确,那么测试 oslc.select 字段状态会更改为 true。单击下一步

    通常不使用测试 oslc.properties 字段。

  6. 查询包含 oslc.where 子句查询包含 oslc.orderBy 子句中,只能输入查询的过滤器或排序子句,例如 cq:Product{cq:Product=“Rational Publishing Engine”}
  7. 单击测试 oslc.where 测试 oslc.orderBy 以验证连接。 Rational Publishing Engine 使用定义的选项来创建完整请求。
  8. 单击下一步。此时,会显示查询的摘要。单击完成。此时,向导会完成,并且 URL 会显示在“配置”窗口中。如果资源位于受保护的服务器上,那么可以在“配置”窗口中提供用户名和密码。

反馈