Cuando exporte un artefacto de prueba de Microsoft Word, deberá tener un archivo de configuración que defina cómo se correlaciona el archivo XML con un artefacto de gestión de calidad.
Procedimiento
Nota: El lado derecho del signo de igual de una entrada de configuración deberá contener una cadena literal, una tabla o una definición de esquema. Una tabla se denota mediante una entrada Table(. Una lista se denota mediante una entrada List(. Ambas entradas deben terminar con un paréntesis de cierre ")".
Para crear una correlación:
- Cree una definición de esquema: la definición de contenido de una lista de esquemas puede constar del nivel de sangrado o del único comodín denotado mediante un asterisco (*). Un nivel de sangrado es un entero, mientras que el comodín debe entrecomillarse. Cualquiera de los dos puede definirse aún más con un número de párrafo específico después de una coma.
El ejemplo siguiente indica al programa de utilidad de exportación que encuentre un esquema cuyo titular coincida con el patrón "1.*."
y se quede solo con el primer párrafo de dicho esquema para que sea el título del caso de prueba:
testcase.dc:title=List("1.*.",1)
Si omite la coma y el número, todo el contenido del nivel de esquema se colocará en el campo del título.
Si utiliza un entero sin entrecomillar, el programa de utilidad de exportación utilizará el contenido en el número especificado de sangrías:
testcase.dc:title=List(1,1)
- Cree una definición de tabla: una tabla se define por el número en el que existe, o por el
contenido de la primera celda. Una tabla definida mediante un número es estática, de modo que todo artefacto que referencie dicha tabla siempre se referirá exactamente a ella.
Una tabla nombrada es dinámica, lo que significa que si se tiene más de una tabla en el documento que coincida con el texto,
se crea más de un artefacto. Después de definir una tabla, deberá ir seguida de un punto y una referencia de celda o columna,
de la misma forma que se define una celda o columna de Excel.
El ejemplo siguiente define una tabla estática y una celda estática:
testscript.dc:title=Table(1).B3
Una tabla dinámica coincide con el inicio del texto en la primera celda de la tabla. La función de coincidencia es sensible a mayúsculas y minúsculas, pero ignora los espacios. Este ejemplo extrae la información de las columnas B de todas las tablas cuyas primeras celdas empiezan por "Step":
testscript.steps.title=Table("Step").B
- Cree enlaces autoreferentes: para definir una autoreferencia, especifique la información del lado izquierdo del signo igual de una línea previamente definida:
testscript.dc:title= Table(1).G
testcase.dc:title=testscript.dc:title
Consejo: Utilice las autoreferencias para crear artefactos que utilicen datos que ya estén siendo utilizados por otro artefacto y para crear un enlace a dicho artefacto.
- Utilice palabras clave: la palabra clave XLSLink indica que el artefacto se
enlace a todos los artefactos del tipo especificado en el documento. En este ejemplo, todos los scripts de prueba del documento se enlazan a todos los casos de prueba:
testcase.XLSLink=testscript
Utilice las palabras clave
DOCStart y
DOCStop para especificar en qué definición de lista iniciar y parar.
Estas palabras clave solo se utilizan para los tipos de lista y deben contener una literal de cadena.
En el siguiente ejemplo, la entrada de configuración empieza a procesar la lista cuando se encuentra el quinto elemento, y detiene el proceso cuando se encuentra el duodécimo elemento de la lista. Estas coincidencias son exactas; el elemento de lista "12.1" no finaliza el proceso.
testscript.DOCStart="5."
testscript.DOCStop="12."
- Modifique los datos: cualquier definición de destino puede envolverse en un modificador Pre().
Los siguientes ejemplos envuelven los datos resultantes en etiquetas <div> y <pre>, conservando la información de formato:
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")
Las secciones con un caso especial para simplificar su uso y para evitar que interfieran con la notación de puntos que se utilizaría en otro caso.
Para actualizar una sección, utilice este formato:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=Table(1).C
La entrada anterior llena la sección de criterios de aceptación construida en la aplicación Gestión de calidad.
Puede consultarse el procedimiento de especificación del nombre o del nombre de visualización de las secciones predefinidas en el tema
Creación de archivos de configuración para exportar artefactos de prueba de Excel. Para definir una sección personalizada, sustituya el primer parámetro con un nombre válido, y sustituya el segundo parámetro con un nombre de visualización:
testcase.Section("myns:mysection","my custom section")=Table(1).C
Las categorías se definen con la notación
categoría term=nombre_categoría.value=valor_categoría. El nombre de la categoría se entrecomilla:
testcase.category term="Funcion".value=Table(1).H
Utilice el carácter ampersand (
&) para añadir dos o más bits de datos al mismo campo. Los datos pueden ser una mezcla de elementos. Este ejemplo muestra datos añadidos:
testcase.description=”mi descripcion:” & Table(1).H & testscript.description
- Acceda a las propiedades del documento del archivo a exportar:
siga estos ejemplos para acceder a las propiedades del archivo del documento Word:
- requirement.dc:title=property(“Title”)
- requirement.dc:creator=property(“Author”)
- requirement.jzalm:owner=property(“Company”)
Puede encontrar las propiedades disponibles incorporadas en Microsoft Office en http://msdn.microsoft.com/en-us/library/microsoft.office.core.documentproperty.aspx.
Otras tres propiedades están disponibles: “Name” [nombre], “Full Name” [nombre completo] y “Location” [ubicación].
Si la propiedad no se ha establecido o si Word no soporta dicha propiedad, la propiedad (" nombre de propiedad ")
devuelve la serie vacía “”.
Los archivos de ejemplo relacionados .xls y .cfg se denominan “Script de prueba en tablas utilizando propiedades de documento”.
Ejemplo
Para la versión 4.0: el diseño y artefacto de la lista se cambia para que se espere separación mediante
\n, y que no tenga
\n dentro de un artefacto, según se muestra en este ejemplo:
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
La línea en blanco entre los dos títulos
de caso de prueba denota la separación del caso de prueba.