当您导出 Microsoft Word 测试工件时,必须有配置文件用来定义如何将 XML 文件映射至质量管理工件。
过程
注: 配置条目的等号右侧必须包含文字字符串、表或大纲定义。表由 Table( 条目表示。列表由 List( 条目表示。这两个条目都必须以右圆括号(即,))结尾。
要创建映射,请完成下列步骤:
- 创建大纲定义:大纲列表的内容定义可以包含缩进级别或者用星号 (*) 表示的单个通配符。缩进级别是一个整数,而通配符必须放在是双引号中。这两者都可以使用逗号后加特定段落号来进一步定义。
以下示例指导 Export 实用程序查找标题与 "1.*." 模式相匹配的大纲,并仅采取该大纲的第一段作为测试用例标题:
testcase.dc:title=List("1.*.",1)
如果忽略逗号和数字,整个大纲级别的内容将放入标题字段。
如果您使用整数而不带双引号,那么 Export 实用程序将使用指定缩进数处的内容:
testcase.dc:title=List(1,1)
- 创建表定义:表是使用其存在所依赖的数字或第一个单元格中的内容定义的。使用数字定义的表是静态的,因此使用该表的每个工件始终准确地引用该表。命名表是动态的,这意味着如果文档中有多个与文本相匹配的表,那么将创建多个工件。定义某个表之后,它后面必须接着是句点以及单元格或列引用,Excel 单元格或列也是以同样的方式定义的。此示例定义了一个静态表和一个静态单元格:
testscript.dc:title=Table(1).B3
动态表匹配第一个表单元格中的文本开头。匹配函数区分大小写,但是忽略空格。
以下示例从第一个单元格以“step”开头的所有表中的 B 列获取信息:
testscript.steps.title=Table("Step").B
- 创建自引用链接:要定义自引用,请指定先前定义的行中等号左侧的信息:
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
提示: 使用自引用来创建将使用另一个工件已经在使用的数据的工件,以及创建指向该工件的链接。
- 使用关键字:XLSLink 关键字指定工件将链接至文档中所指定类型的所有工件。在此示例中,文档中的所有测试脚本将与所有测试用例链接:
testcase.XLSLink=testscript
使用
DOCStart 和
DOCStop 关键字来指定列表定义的启动和停止位置。这些关键字仅用于列表类型,且必须包含字符串字面值。在以下示例中,配置条目在找到第五个项时开始处理列表,在找到第十二个列表项时停止处理。
这些匹配项是精确匹配的;列表项“12.1”不会结束处理。
testscript.DOCStart="5."
testscript.DOCStop="12."
- 修改数据:任何目标定义都可以包含在 Pre() 修饰符中。下列示例将结果数据包含在 <div> 和 <pre> 标记中,并保留格式信息:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre(Table(1).C)
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Pre("this is my text")
“部分”是一种特殊情况,用于简化其使用以及防止它们的定义干扰另外使用的句点符号。要更新部分,请使用此格式:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
前一条目将填充已构建到“质量管理”应用程序中的接受条件部分。
请参阅此主题中有关指定预定义部分的名称或显示名称的步骤:
创建用于导出 Excel 测试工件的配置文件。要定义定制部分,可使用有效名称替换首个参数,使用显示名称替换第二个参数:
testcase.Section("myns:mysection","my custom section")=Table(1).C
使用
category term=category_name.value=category_value 表示法定义类别。
类别名称放在双引号中:
testcase.category term="Function".value=Table(1).H
使用和号 (
&) 在同一字段中添加两个或更多数据位。数据中可以混合各种项。此示例显示添加的数据:
testcase.description=”my description:” & Table(1).H & testscript.description
- 访问要导出的文件的文档属性:按照下列示例来访问文件 Word 文档属性:
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
您可在以下网址查找内置到 Microsoft Office 中的可用属性:http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx。
还有另外三个可用属性:“Name”、“Full Name”和“Location”。如果尚未设置该属性,或者 Word 不支持该属性,那么属性 (“property name”) 将返回空字符串:“”。
相关的样本 .xls 和 .cfg 文件称为“Testscript in Tables using Document Properties”。
示例
对于 V4.0:列表中的设计和工件更改为由
\n 分隔,而不是让一个工件中具有
\n 来分隔,如以下示例中所示:
1. title
1.1 testcase1 title
1.1.1 testscript1 reference to the testcase1
1.1.1.1 testscript1 step1 title
1.1.1.1.1 testscript1 step1 description
1.1.1.1.2 testscript1 step1 expectresuit
1.1.1.2 testscript1 step2 title
1.1.1.2.1 testscript1 step2 description
1.1.1.2.2 testscript1 step2 expectresuit
1.1.1.3 testscript1 step3 title
1.1.1.3.1 testscript1 step3 description
1.1.1.3.2 testscript1 step3 expectresuit
1.1.1.4 testscript1 step4 title
1.1.1.4.1 testscript1 step4 description
1.1.1.4.2 testscript1 step4 expectresuit
1.2 testcase2 title
1.2.1 testscript2 reference to the testcase2
1.2.1.1 testscript2 step1 title
1.2.1.1.1 testscript2 step1 description
1.2.1.1.2 testscript2 step1 expectresuit
1.2.1.2 testscript2 step2 title
1.2.1.2.1 testscript2 step2 description
1.2.1.2.2 testscript2 step2 expectresuit
1.2.1.3 testscript2 step3 title
1.2.1.3.1 testscript2 step3 description
1.2.1.3.2 testscript2 step3 expectresuit
1.2.1.4 testscript2 step4 title
1.2.1.4.1 testscript2 step4 description
1.2.1.4.2 testscript2 step4 expectresuit
两个测试用例标题之间的空白行表示测试用例的间隔。