关于此任务
配置文件中包含用于使“质量管理”工件信息与数据位置相关联的语句。配置文件中的每个语句都有由等号连接的两端。语句的左端由一些关键字组成。配置的等号右端可能有三种可能性。
- 列或单元格定义,例如,D 或 D4
- 文字串,例如,"execution"
- 对另一个工件的引用(也就是自引用),例如,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 文件导出到同一个存储库时,要创建新的工件,请完成以下其中一个步骤:
- 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
此示例配置条目将填充已构建到“质量管理”应用程序中的接受条件部分。
- 要确定预定义部分的名称或显示名称:
- 在“质量管理”中更新资源的预定义部分。
- 读取资源(以 XML 形式,且 abbreviate=false)。
- 在 XML 文档中找到具有部分名称的元素,例如 com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria。
- 在包含部分显示名称的元素中找到 extensionDisplayName 属性,例如 RQM-KEY-TC-ACCEPT-CRITERIA-TITLE。
- 要定义定制部分,可使用有效名称替换首个参数,使用显示名称替换第二个参数:
testcase.Section("myns:mysection","my custom section")=C
- 要定义类别,请使用 category term=category_name.value=category_value 格式:
testcase.category term="Function".value=H
- 要向一个工件添加定制属性,请完成下列步骤: 如果有两个 customAttributes,testcaseCustomAttribute1 和 testcaseCustomAttribute1 在一个测试用例中,那么在运行“质量管理 Excel 导入器”之前,应在“质量管理”中创建 customAttributes testcaseCustomAttribute1 和 testcaseCustomAttribute2。
我们可以按如下所示配置 .cfg 文件:
testcase.customAttributes.type="SMALL_STRING" //设置
定制属性类型(数据类型)。
testcase.customAttributes.identifier=A //将标识放到
Excel 的 A 列中。标识是您创建属性时的属性名称。例如,当您使用名称“name1”
创建 customerAttribute 并稍后将其改为“name2”时,标识在“质量管理”
服务器中仍保留为“name1”。
如果您将定制属性标识设置为 Custom_attribute_number_,并且第一个属性为
Custom_attribute_0_,第二个属性为 Custom_attribute_1_,那么在您将标识
放入 Excel 单元格中时,该标识为正确的。
testcase.customAttributes.name=B //将属性名称放在 B 列
testcase.customAttributes.value=C //将属性值放在 C 列结果为:
<customAttributes>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_0_</identifier>
<name>testcaseCustomAttribute1</name>
<value>111111111111111111111111111</value>
</customAttribute>
<customAttribute type="SMALL_STRING">
<identifier>Custom_attribute_1_</identifier>
<name>testcaseCustomAttribute2</name>
<value>3333333333333333333333333</value>
</customAttribute>
</customAttributes>
已经添加了具有定制 attributes.xls 的新样本 TestCases 001 以及具有定制 attributes.cfg 的 TestCases 001。
- 要访问您正在处理的电子表格的属性,请使用下列各行:
还有另外三个可用属性:“Name”、“Full Name”和“Location”。如果尚未设置该属性,或者 Excel 不支持该属性,那么属性 (“property name”) 将返回空字符串:“”。
相关样本 .xls 和 .cfg 文件称为 Requirements001 using document properties。
- 要从 Excel 导出图像,需了解电子表格中的图像的以下几个方面:
图像在 Excel 中的位置由包含图像左上角的单元格表示。
即使图像占据多个单元格,也必须指定包含图像左上角的单元格以导出图像。
单元格中可以包含的图像数量不受限制。如果您指定某个包含所有图像的左上角的单元格,那么将导出所有图像。
在 Excel 中,有两种导出图像的方法。
第一种方法是使用 image 函数。在配置文件条目中,图像被设置为放在等号右边的函数。
可以使用单元格或行指定图像。image 函数会将图像插入所分配到的富文本格式字段。
如果属性不使用富文本格式字段,将忽略 image 函数。
请参阅以下 image 函数示例:
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
第二种方法是使用 attachment 属性:
- testcase.attachment=C4
- testcase.attachment=C
attachment 属性会将图像作为附件添加到工件中,而不是将图像插入富文本格式字段。
相关的样本 .xls 文件和 .cfg 文件分别称为 Test Cases made from scripts with images 和 Test Cases made from scripts with attachments。