Cuando exporte un artefacto de prueba de Microsoft Excel, deberá tener un archivo de configuración que defina cómo se correlaciona el archivo XML con un artefacto de gestión de calidad.
Acerca de esta tarea
Los archivos de configuración contienen sentencias que asocian la información de artefactos de Gestión de calidad a ubicaciones de datos. Cada sentencia de un archivo de configuración tiene dos lados unidos mediante un signo igual. El lado izquierdo de la sentencia consta de palabras clave. La parte derecha
del signo igual de una configuración puede constar de tres posibilidades.
- Una definición de celda o columna como, por ejemplo, D o D4
- Una serie literal como, por ejemplo, "execution"
- Una referencia a otro artefacto (autoreferencia) como, por ejemplo, testscript.description
Para definir una fila o columna, ponga simplemente el identificador de columna o celda:
testscript.dc:title=G
Para definir una serie literal, simplemente póngalo entre comillas:
testscript.steps.type="execution"
Para definir una autoreferencia, simplemente especifique la información del lado izquierdo del igual de una línea previamente definida:
testscript.dc:title=G
testcase.dc:title=testscript.dc:title
Nota: Las autoreferencias se utilizan para crear artefactos que van a utilizar datos que ya están siendo utilizados por otro artefacto, y crearán un enlace a dicho artefacto.
Las autoreferencias no pueden utilizarse con la palabra clave XLSLink.
Palabras clave y casos especiales
Hay varias palabras clave que van en la parte izquierda del signo igual. Todas ellas empiezan con "XLS"
y toman el lugar de un campo tras el artefacto. Están definidas como:
- XLSStartRow indica la fila tras la cual empiezan los datos del artefacto.
- XLSDelimeter indica el elemento que denota la aparición del siguiente artefacto (actualmente solo admite \n).
- XLSLink especifica que el artefacto se enlace a todos los artefactos del tipo especificado dentro de la hoja de trabajo.
- XLSLinkReverse indica al programa de utilidad de exportación que ponga el XML del enlace dentro del artefacto en vez del que hace el enlace.
Utilice esta palabra clave solo con enlaces autoreferentes. Utilice esta palabra clave cuando cree un artefacto basado en otro (por ejemplo, requirement.dc:title=testcase.dc:title), pero necesita que el enlace se cree en el artefacto original (el que está a derecha del signo igual). Al especificar requirement.XLSLinkReverse=true se coloca el enlace en el artefacto principal, en lugar de en el que especifica el enlace autoreferente.
- XLSArtifactID especifica el
ID externo del artefacto. Si el ID externo del artefacto no se especifica, se asignará un ID externo predeterminado con este formato:
nombre del archivo Excel_nombre de la hoja de Excel[_recuento_artefacto].xml
donde recuento_artefacto es el número de artefactos en una única hoja de cálculo si la hoja de cálculo contiene dos o más artefactos. Si la hoja de cálculo contiene un artefacto, este argumento no es necesario. Importante: Si la hoja de cálculo contiene un artefacto con el mismo
ID externo que otro artefacto, el artefacto se actualizará desde el contenido de la hoja de cálculo. Por ejemplo, si exporta la misma hoja de cálculo Excel con la misma configuración varias veces, el
ID externo se actualiza cada vez.
PRECAUCIÓN:
Si está utilizando artifact.XLSArtifactID="urn:com.ibm.rqm:testplan:2" cuando el valor especificado es una serie y no una celda,
asegúrese de que no hay hojas en blanco ni se esté utilizando artifact.XLSWorksheetID para especificar la hoja de cálculo para leer XLSArtifactID.
Para crear artefactos nuevos al exportar los mismos archivos Excel al mismo repositorio, complete uno de estos pasos:
- XLSWorksheetID especifica el nombre de la hoja de cálculo a procesar. Debe utilizarse una cadena literal para esta palabra clave.
Nota: A partir de la versión 4.0, la sintaxis para
testsuite enlazada con
testcases ha cambiado de
testsuite.testcases=testcase
a
testsuite.XLSLink=testcase
- A continuación, se muestran algunos ejemplos:
- 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"
Pasos de script, categorías, secciones, exportaciones de imagen, búsquedas dinámicas de una palabra o frase y el acceso a propiedades de hoja de cálculo son casos especiales.
Un paso de script requiere varios campos para cada paso. Puesto que un script puede tener muchos pasos, todas las líneas se considerarán un único paso hasta que se encuentre una línea en blanco, que dará comienzo al paso siguiente.
Las secciones son un caso especial. Para simplificar su uso y evitar que sus definiciones interfieran con la notación de puntos que se utiliza. Para actualizar una sección, utilice este formato:
testcase.Section("myns:com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria", "RQM-KEY-TC-ACCEPT-CRITERIA-TITLE")=C
Esta entrada de configuración de ejemplo llena la sección de criterios de aceptación construida en la aplicación Gestión de calidad.
- Para determinar el nombre o el nombre de visualización de las secciones predefinidas:
- Actualice la sección predefinida de un recurso en Gestión de calidad.
- Lea el recurso como XML con abbreviate=false.
- Localice el elemento en el documento XML que tenga el nombre de sección como, por ejemplo, com.ibm.rqm.planning.editor.section.testCaseAcceptanceCriteria.
- Busque el atributo extensionDisplayName en el elemento que contiene el nombre de visualización de la sección como, por ejemplo, RQM-KEY-TC-ACCEPT-CRITERIA-TITLE.
- Para definir una sección personalizada, sustituya el primer parámetro con un nombre válido y el segundo parámetro con un nombre de visualización:
testcase.Section("myns:miseccion","mi seccion personalizada")=C
- Para definir una categoría, utilice el formato category term=nombre_categoría.value=valor_categoría:
testcase.category term="Funcion".value=H
- Para añadir un atributo personalizado a un artefacto: si hay dos customAttributes, testcaseCustomAttribute1 y testcaseCustomAttribute1 en
un testcase (caso de prueba), los customAttributes testcaseCustomAttribute1 y testcaseCustomAttribute2 deberían estar creados en Gestión de calidad antes de ejecutar el Importador de Excel de Gestión de calidad.
Se puede configurar el archivo .cfg de la forma siguiente:
testcase.customAttributes.type="SMALL_STRING" //establece el tipo de atributo personalizado (el tipo de datos).
testcase.customAttributes.identifier=A //pone un identificador en la columna A en Excel. El identificador es el nombre del atributo cuando se crea. Por ejemplo, al crear customerAttribute con el nombre "name1" y cambiarlo a "name2" posteriormente, el identificador continúa siendo "name1" en el servidor de Gestión de calidad.
Si establece el identificador de atributo personalizado como Custom_attribute_number_,
y el primer atributo es Custom_attribute_0_ y el segundo es
Custom_attribute_1_ , este identificador será correcto al colocarlo en la celda de Excel.
testcase.customAttributes.name=B //establece el nombre del atributo en la columna B
testcase.customAttributes.value=C //establece el valor del atributo en la columna Cel resultado será:
<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>
Se ha añadido una nueva muestra TestCases 001 con atributos.xls personalizados y
TestCases 001 con atributos.cfg personalizados.
- Para acceder a las propiedades de la hoja de cálculo en la que se esté trabajando, utilice las siguientes líneas:
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 Excel no soporta dicha propiedad, la propiedad (" nombre de propiedad ")
devuelve la serie vacía “”.
Los archivos de ejemplo relacionados .xls y .cfg se denominan Requisitos001 utilizando propiedades de documento.
- Para exportar imágenes desde Excel, tenga en cuenta lo siguiente respecto de las imágenes en las hojas de cálculo:
La ubicación de las imágenes en Excel está representada por la celda que contiene la esquina superior izquierda de la imagen. Incluso si una imagen ocupa varias celdas, deberá especificar la celda que contiene la esquina superior izquierda de dicha imagen para poder exportarla. Las celdas puede contener un número ilimitado de imágenes. Si especifica la celda que contiene el ángulo superior izquierdo de todas las imágenes, se exportarán todas las imágenes.
En Excel, se pueden exportar las imágenes de dos maneras. El primer método consiste en utilizar la función image. La imagen se configura como una función que se coloca detrás del signo igual en una entrada del archivo de configuración.
Las imágenes pueden especificarse por celda o por fila. La función image inserta una imagen en el campo de texto enriquecido al que está asignada. Si el atributo no utiliza un campo de texto enriquecido, la función image se ignorará. Vea estos ejemplos de la función image:
- testscript.steps.expectedResult=image(G)
- testscript.steps.description=image(C4)
El segundo método consiste en utilizar el atributo attachment [anexo]:
- testcase.attachment=C4
- testcase.attachment=C
El atributo attachment añade imágenes como archivos adjuntos al artefacto en lugar de insertar la imagen en campos de texto enriquecido.
Los archivos de ejemplo relacionados .xls y .cfg se denominan respectivamente Casos de prueba hechos a partir de scripts con imágenes y Casos de prueba hechos a partir de scripts con anexos.