设置 ALM-ALM Octane 集成

本主题描述如何设置 ALM-ALM Octane 集成。

在 ALM Octane 端配置集成

ALM Octane 端的配置包括以下内容。

  1. 在 ALM Octane 中创建一个与 ALM 中的发布相同的发布。
  2. 要设置集成,您必须有权访问服务器。ALM Octane 通过 API 访问密钥授予此权限。

有关详细信息,请参阅 ALM Octane 帮助

在 ALM 端配置集成

ALM 端的配置包括以下内容。

启用 ALM- Octane 集成
  1. 在“站点管理”中,单击“站点配置”选项卡。
  2. OCTANE_INTEGRATION_ENABLED 设置为 Y

    有关详细信息,请参见设置配置参数站点参数

计划 ALM-Octane 集成

确定将 ALM 测试集的运行结果同步到 ALM Octane 的频率。

  1. 在“站点管理”中,单击“站点配置”选项卡。
  2. OCTANE_INTEGRATION_JOB_INTERVAL 设置为首选值。

    有关详细信息,请参见设置配置参数站点参数

返回页首

配置 octane-int-config.xml 文件

配置 {ALM 存储库}\sa\DomsInfo\CommonData\octane-integration\ 目录中的 octane-int-config.xml 文件。

不得更改文件名。否则,文件将无法正常工作。

octane-int-config.xml 文件中,指定以下信息。有关配置的说明和示例,请转到 octane-int-config.template.xml 模板文件以获取参考。请参见octane-int-config.template.xml

代理服务器

是否必需?
描述

host: 基于 HTTP 的代理服务器所在的主机的 IP 地址。

port: 代理服务器的端口号。

username: 代理服务器的用户名。

password: 代理服务器的密码。

示例
<proxy>
  <host>your-web-proxy.net</host>
  <port>8080</port>
  <username>sa</username>
  <password>sa</password>
</proxy>

ALM Octane 服务器

是否必需?
描述

clientId: 由 ALM Octane 生成的用于 API 访问的客户端 ID。

clientSecret: 由 ALM Octane 生成的用于 API 访问的客户端密钥。

serverUrl: ALM Octane 服务器的 URL。

sharedSpaceId: ALM Octane 共享空间 ID

有关创建 Octane API 访问密钥的详细信息,请参阅 ALM Octane 帮助中心

示例
<octane>
  <clientId>your-octane-client-ID</clientId>  
  <clientSecret>your-client-secret</clientSecret>
  <serverUrl>http://shcappsvm153.hpeswlab.net:8080/</serverUrl>
  <sharedSpaceId>1001</sharedSpaceId>
</octane>

ALM 和 ALM Octane 项目映射

是否必需?
描述

domain: ALM 域名

project: ALM 项目名称

workspaceId: ALM Octane 项目的工作区 ID

示例
<projects>
  <project>
    <domain>DEFAULT</domain>
    <project>first</project>
    <workspaceId>1002</workspaceId>
    ...
  </project>
</projects>

ALM 测试实例筛选

是否必需?
描述

如果要仅将某些测试实例的测试运行同步到 ALM Octane,请指定测试实例筛选。否则,所有测试实例的测试运行将同步到 ALM Octane。

您可以通过从 ALM 项目复制筛选设置来进行筛选。有关详细信息,请参见筛选对话框

示例
<projects>
  <project>
    <domain>DEFAULT</domain>
    <project>first</project>
    <workspaceId>1002</workspaceId>
    <filters>    
      <filter>
      [Filter]{       
         TableName:TESTCYCL,  
         ColumnName:TC_SUBTYPE_ID,
         LogicalFilter:\0000001e\Not hp.qc.test-instance.MANUAL,
         VisualFilter:\0000001e\Not hp.qc.test-instance.MANUAL,
         NO_CASE: 
         }
         
       </filter>
      </filters>
	
...
  </project>
</projects>

ALM 和 ALM Octane 字段映射和字段值映射

是否必需?
描述

almDbFieldName: ALM 字段名称 (数据库列名称)

octaneName: ALM Octane 字段名称。

almValue: ALM 项目的字段值

octaneValue: ALM Octane 项目的字段值

示例
<projects>
  <project>
    <domain>DEFAULT</domain>
    <project>first</project>
    <workspaceId>1002</workspaceId>
  <fields>
    <field almDbFieldName="RN_STATUS" octaneName="status">
       <values>
         <value almValue="Passed" octaneValue="Passed"/>
         <value almValue="Bypassed" octaneValue="Skipped"/>
	  <value almValue="Failed" octaneValue="Failed"/>
       </values>
    </field>
     <field almDbFieldName="TS_TYPE" octaneName="Testing_Tool_Type">	
       <values>
          <value almValue="FLOW" octaneValue="FLOW-TEST" />
       </values>
     </field>
  </fields>
...
  </project>
</projects>

下表列出了受支持的 ALM-Octane 字段映射。

ALM 字段 Octane 字段
RN_STATUS status

将 ALM 运行状态映射到 ALM Octane 运行状态。

映射支持的 ALM Octane 运行状态值为: PassedFailedPlannedSkipped

  • ALM "Passed" 状态自动映射到 ALM Octane 的 "Passed" 状态。不能将 ALM "Passed" 状态映射到任何其他 ALM Octane 状态。
  • ALM "Failed" 状态自动映射到 ALM Octane 的 "Failed" 状态。不能将 ALM "Failed" 状态映射到任何其他 ALM Octane 状态。
  • ALM "No Run" 状态自动映射到 ALM Octane 的 "No Run" 状态。不能将 ALM "No Run" 状态映射到任何其他 ALM Octane 状态。
  • 如果要将 ALM 运行状态映射到 ALM Octane 运行状态 "Skipped",则应将 ALM 用户定义的状态映射到 "Skipped"。

TS_TYPE

Testing_Tool_Type

 

将 ALM 测试类型映射到 ALM Octane 测试类型。

如果 ALM 测试类型未映射到 ALM Octane 测试类型,则将该类型的测试同步到 ALM Octane 时,该测试类型将自动添加到 ALM Octane 测试类型列表中,并分配给 ALM Octane 中的相应测试。

<系统字段>

<用户定义的字段>

class

将 ALM 系统字段或用户定义的字段 (“测试”、“测试集”、“运行”或“测试配置”实体) 映射到 ALM Octane 的字段 "class"。

ALM 字段类型应为字符串。

它不需要字段值映射。

启用自动修复

是否必需?
描述

是否为 ALM 中的“Octane 测试套件 URL”字段的值启用自动修复。将 ALM 测试集同步到 ALM Octane 时,ALM 将检查字段值的格式是否有效,以及是否为此字段启用了自动修复。

  • true: 启用自动修复。如果字段值无效,则当同步运行时,它将在 ALM Octane 中创建新的测试套件,并用新测试套件的 URL 填充该字段。

    备注: 如果“Octane 测试套件 URL”字段中的 URL 格式正确,但是按此 URL 无法在 ALM Octane 中找到测试套件,则不会自动修复该 URL。

  • false: 禁用自动修复。如果字段值无效,则在同步运行时,将不会更新字段值。
示例
<projects>
  <project>
    <domain>DEFAULT</domain>
    <project>first</project>
    <workspaceId>1002</workspaceId>
  <fields>
     <field almDbFieldName="Testing_Tool_Type" octaneName="TS_TYPE">	
       <values>
          <value almValue="FLOW" octaneValue="FLOW-TEST" />
       </values>
     </field>
  </fields>
...
<isAutoFix>true</isAutoFix>
...
  </project>
</projects>

返回页首