使用 URL 向生命周期查询引擎添加数据提供程序

任何支持跟踪资源集(TRS)规范的生命周期管理工具都可以成为生命周期查询引擎索引的数据提供者。 当生命周期管理应用程序在不同于生命周期查询引擎 的Jazz®团队服务器上运行时,您可以使用URL 将其添加为生命周期查询引擎的数据提供程序。 如果应用程序没有根服务文档,您可以通过输入 OAuth 格式的 URL,将 TRS 数据源注册为 Lifecycle Query Engine 的数据提供程序。 这是向生命周期查询引擎添加数据提供程序的最复杂方法。 仅当您熟悉解决方案的结构时,才可使用此程序。 当数据提供程序 URL 被注册后 ,生命周期查询引擎将直接与 TRS 提供程序(即生命周期管理应用程序)进行通信。

开始之前

确保生命周期查询引擎或LDX功能用户( lqe_user )已在 JTS 中创建,如将生命周期查询引擎或链接索引提供程序连接到使用不同Jazz Team Server的应用程序中所述。

过程

  1. 生命周期查询引擎管理页面,转到 "http://<host_name>:<port>/lqe/web/admin/data-sources处的数据提供程序。
    此页面显示Lifecycle Query Engine所连接的数据提供者的实时状态。
  2. 点击 添加数据提供商 并选择 手册 URL
  3. 输入您应用程序的跟踪资源URL ,例如 https://server:port/tool/trs 。 选择要添加的数据提供程序。
  4. 添加访问上下文列表的 URL,供连接到 TRS 提供程序时使用。
  5. 输入诊断页面 URL。 某些 TRS 提供程序会发布诊断页面,供您用于验证 TRS 订阅源数据。 如需了解详情,请阅读 《验证TRS源》和《生命周期查询引擎》或《链接索引提供程序索引 》。 TRS 订阅源验证可以帮助您对建立索引期间跳过资源时发生的报告问题进行故障诊断。
  6. 选择要添加的 TRS 馈电类型。
    请注意:从7.0 版开始,Design Management(DM) 应用程序不再是IBM Engineering Lifecycle Management解决方案的一部分。 如果使用的是 DM 版本6.0.6.1,请选择架构或Design Management选项,将数据提供程序手动添加到生命周期查询引擎

    如果计划使用报告生成器,请为数据提供程序选择工件类型。 当 TRS 源在设置过程中自动添加到生命周期查询引擎时,生命周期查询引擎会检查 TRS 提供程序的 "dcterms:type属性,以确定源提供的工件类型。 但是,当您手动添加 TRS 源时,生命周期查询引擎可能无法自动确定类型。

    选择类型时,不同项目区域中定义的工件属性会全部合并,并列在报告生成器的 "选择工件"部分。 如果未指定订阅源类型,您在列表中可能会看到同一工件类型的多个实例。

  7. 添加标签作为数据提供者的标识符。
  8. 可选:"调度字段允许您设置初始索引的时间。 如果将字段保留为空,那么向导完成后就会立即创建索引。 在测试实验室环境中,生命周期查询引擎可在 1 小时内为 50 000 件工件编制索引。 根据硬件和配置,您建立索引的速度可能较慢。
    注意:您可以同时为多个数据提供程序建立索引。 每一个数据源的建立索引操作都在自己的线程中运行。 或者,您也可以安排多个 TRS 数据提供程序的初始索引编制,让它们一个接一个地运行。
  9. 输入认证详细信息。
  10. 在 "指定身份验证详细信息"窗格中,输入应用程序的身份验证信息。
    1. 在另一个浏览器窗口中,找到为 LQE 生成的密钥: . 例如,如果要添加Engineering Test Management,请进入 QM 管理面板: https://<server>:<port>/QM/admin#action=com.ibm.team.repository.admin.configureOAuth.
      注意:除非您的身份验证委托给了JTS,否则请转到您添加为数据提供者的应用程序的管理面板,而不是JTS管理面板。
    2. 授权密钥列表中,找到并复制 "lqe_user密钥和秘密。
    3. 返回 LQE 浏览器窗口,输入用户密钥秘密
    4. 输入应用程序的 OAuth URL。
      URL 与下面的示例类似,其中application_context_root是您要添加为数据提供程序的特定应用程序,如 "ccm、"rm或 "qm
      • https://server:port/application_context_root/oauth-request-token
      • https://server:port/application_context_root/oauth-authorize
      • https://server:port/application_context_root/oauth-access-token
  11. 配置数据提供程序。
    将鼠标悬停在属性标签旁边的问号上,可了解有关属性及其值的详细信息。
    • 刷新率指定Lifecycle Query Engine或 LDX 尝试访问数据提供程序以刷新索引的频率。 不经常更新的数据提供者的刷新率可能比持续更新的数据提供者慢。 提高刷新率会影响性能。
    • 刷新率指定Lifecycle Query Engine或 LDX 尝试访问数据提供程序以刷新索引的频率。 不经常更新的数据提供者的刷新率可能比持续更新的数据提供者慢。 提高刷新率会影响性能。
    • 添加或重新索引数据提供程序时,获取工件的线程数量必须在2到4之间。 每条线大致相当于一个使用生命周期查询引擎或LDX服务器的用户。 在英特尔系统上,如果使用超过 4 个线程,数据检索速度的提高就微乎其微了。
    • 在跳过资源的情况下继续处理更改日志的选项允许生命周期查询引擎或 LDX 在遇到无法索引的资源时记录错误并继续索引。 此选项在缺省情况下已选中。 如果将其禁用,那么无法为资源建立索引时,建立索引的过程就会停止。
    • 重试设置指定了与获取资源和TRS文档相关的以下配置:
      • 在重新尝试失败的补丁或跳过的资源之前等待的时间。
      • 重试次数。
      • 重试时间间隔乘数。
      • TRS文档的重试次数。
      • TRS文档的重试间隔乘数。
      • 最大重试等待时间。
      • 如果数据提供商暂时可用,则重试次数。

下一步操作

要停止索引数据提供程序,请单击列表中的数据提供程序名称,然后单击暂停索引图标。