Creación de archivos de configuración para exportar artefactos de prueba de Excel

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.
  1. Una definición de celda o columna como, por ejemplo, D o D4
  2. Una serie literal como, por ejemplo, "execution"
  3. 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:
    • Utilice la palabra clave XLSArtifactID para especificar un ID externo exclusivo para cada operación de exportación.
    • Cambie el nombre del archivo Excel o el nombre de la hoja de cálculo de Excel cada vez que exporte.
    • Utilice la opción Exportar a archivo cuando inicie el proceso de exportación y modifique el nombre de los archivos XML, y luego importe los archivos XML en Gestión de calidad: inicie sesión en Gestión de calidad y pulse uno de estos mandatos:
      • Planificación > Importar planes de prueba
      • Construcción > Importar casos de prueba
      • Construcción > Importar scripts de prueba
      Consejo: Puede utilizar el método anterior para importar planes de prueba, casos de prueba y scripts de prueba exclusivamente.
  • 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.

Procedimiento


Feedback