创建用于导出 Excel 测试工件的配置文件

当您导出 Microsoft Excel 测试工件时,必须有配置文件用来定义如何将 XML 文件映射至质量管理工件。

关于此任务

配置文件中包含用于使“质量管理”工件信息与数据位置相关联的语句。配置文件中的每个语句都有由等号连接的两端。语句的左端由一些关键字组成。配置的等号右端可能有三种可能性。
  1. 列或单元格定义,例如,D 或 D4
  2. 文字串,例如,"execution"
  3. 对另一个工件的引用(也就是自引用),例如,testscript.description
要定义行或单元格,只需输入列标识或单元格标识:
testscript.dc:title=G
要定义文字串,只需将其用引号引起来:
testscript.steps.type="execution"
要定义自引用,只需填入先前定义的行中等号左侧的信息:
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
注: 自引用用来创建将使用另一个工件已经在使用的数据的工件,并且将创建指向该工件的链接。无法对自引用使用 XLSLink 关键字。

关键字和特殊情况

在等号左侧可以使用多个关键字。这些关键字都以“XLS”开头,并代替工件后面的字段。这些关键字定义为:
  • XLSStartRow,定义工件数据从哪一行之后开始。
  • XLSDelimeter,定义用于表示下一个工件的元素(当前仅支持 \n)。
  • XLSLink,指定工件将与工作表中所有指定类型的工件链接。
  • XLSLinkReverse,指导 Export 实用程序将链接 XML 放入工件,而不是用来指定链接的一方。此关键字仅与自我引用的链接配合使用。在基于另一工件创建工件(例如,requirement.dc:title=testcase.dc:title),但是要求所创建的链接在原始工件(即等号右端的工件)中时使用此关键字。指定 requirement.XLSLinkReverse=true 将使链接被放入主工件中,而不是放入指定自我引用链接的工件中。
  • XLSArtifactID 指定工件的外部标识。如果未指定工件的外部标识,那么将按以下格式来指定缺省外部标识:
    Excel file name_Excel worksheet name[_artifact_count].xml
    其中,artifact_count 是在电子表格中包含两个或更多工件时,单个电子表格中的工件数量。如果电子表格中仅包含一个工件,那么不需要此参数。
    要点: 如果电子表格中包含的某个工件的外部标识与另一工件的外部标识相同,将使用电子表格的内容更新该工件。例如,如果您多次导出具有相同配置的同一 Excel 电子表格,那么每次都会更新外部标识。
    警告:
    当将值指定为字符串(而不是单元格)时,如果您正在使用 artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2",请确保没有空白表,也未使用 artifact.XLSWorksheetID 来指定工作表以读取 XLSArtifactID。
    将相同 Excel 文件导出到同一个存储库时,要创建新的工件,请完成以下其中一个步骤:
    • 使用 XLSArtifactID 关键字为每项导出操作指定唯一的外部标识。
    • 每次导出时更改 Excel 文件名或 Excel 工作表名称。
    • 在开始执行导出过程时使用导出到文件选项,更改 XML 文件的名称,然后将该 XML 文件导入到“质量管理”:登录“质量管理”,然后单击下列其中一个命令:
      • 计划 > 导入测试计划
      • 构造 > 导入测试用例
      • 构造 > 导入测试脚本
      提示: 可使用上述方法导入测试计划、测试用例和测试脚本。
  • XLSWorksheetID,指定要处理的工作表的名称。此关键字必须使用文字字符串。
    注: 从 V4.0 开始,与 testcases 链接的 testsuite 的语法已从以下内容:
    testsuite.testcases=testcase
    更改为:
    testsuite.XLSLink=testcase
  • 以下是一些示例:
    • testscript.XLSStartRow=7
    • testscript.title=B
    • testscript.steps.type="execution"
    • testscript.steps.description=B
    • testscript.steps.title=B
    • testscript.steps.name=B
    • testscript.steps.expectedResult=F
    • testscript.XLSDelimeter=\n
    • testcase.dc:title=C1
    • testcase.dc:description=C2
    • testcase.XLSLink=testscript
    • testcase.XLSArtifactID=D1
    • testcase.XLSWorksheetID="test_case_1"

    脚本步骤、类别、部分、图像导出、动态搜索词汇或短语以及电子表格属性访问权是特殊情况。 脚本步骤的每个步骤需要多个字段。 因为脚本可以包含多个步骤,所有的行都被视为单独的步骤,直到遇到空行,遇到空行后将开始下一个步骤。

    “部分”是一种特殊情况。简化其用法和防止它们的定义干扰其他用法的句点符号。要更新部分,请使用此格式:
    testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
    此示例配置条目将填充已构建到“质量管理”应用程序中的接受条件部分。

过程


反馈