Diseño de plantillas con Rational DOORS como origen de datos

Los diseñadores de informes pueden utilizar Document Studio para importar esquemas de origen de datos y plantillas del informe de compilación.

Antes de empezar

Examine el módulo de Rational DOORS que tiene previsto utilizar y su contenido. Para localizar la documentación de producto para su versión de Rational DOORS, consulte Acerca del Rational DOORS Information Center

Puede utilizar la combinación de propiedades de módulo, atributos de objeto y vistas que están almacenados en los módulos. Revise las vistas disponibles en un módulo para columnas calculadas incluyendo vistas de rastreabilidad o, quizás, columnas de DXL de diseño. Estas vistas no corresponden a atributos de Rational DOORS, pero podrían ser algo que desee incluir en el informe.

Procedimiento

  1. Revise Diseño de plantillas de documentos para ver una visión general del proceso de desarrollo de plantilla. Inicie la planificación de la estructura del documento y los datos podrían estar incluidos. Por ejemplo, decida si el documento final se generará a partir de una plantilla o de varios archivos de plantilla que pueden contener cada uno partes reutilizables de contenido.
  2. En la aplicación Document Studio, cree una plantilla de documento.
  3. Identifique un esquema de origen de datos en el origen de datos. Existen dos formas para añadir un origen de datos: a través del asistente de descubrimiento de esquema DOORS o el asistente de esquema de origen de datos. Para añadir un origen de datos utilizando el asistente de esquema de origen de datos:
    1. En Document Studio, pulse Datos > Añadir esquema de origen de datos.
    2. En el campo Predefinido, seleccione el esquema de la base de datos Doors.
    3. En Tipo, seleccione el tipo de esquema en la lista. Para Rational DOORS, seleccione DOORS.
    4. Edite el campo Esquema si es necesario o pulse Examinar para seleccionar la vía de acceso del archivo de esquema.
    5. Si el recurso está en un servidor protegido, especifique el nombre de Usuario.
    6. Si el recurso está en un servidor protegido, especifique la Contraseña.
    7. Seleccione el Tipo de autenticación en la lista. Para Rational DOORS, el tipo de autenticación es OAuth-OSLC. Si no selecciona OAuth-OSLC, se prueba cada tipo de autenticación, hasta que se encuentra el tipo correcto, lo que podría aumentar el tiempo de generación de documentos.

    Para añadir un origen de datos utilizando el esquema de descubrimiento de esquema DOORS:

    1. En Document Studio, pulse Datos > Descubrimiento de esquemas > Descubrimiento de esquemas de DOORS.
    2. Especifique los detalles de conexión:
      • Para utilizar una instancia de Rational DOORS en ejecución, seleccione Utilizar la instancia de DOORS en ejecución.
      • Para ejecutar Rational DOORS en segundo plano, seleccione Ejecutar un nuevo proceso de DOORS en segundo plano. Especifique el nombre de usuario, la contraseña, la base de datos y la vía de acceso a doors.exe.
    3. Seleccione una vista:
      • Vista de base de datos
      • Vista de proyecto
    4. Pulse Siguiente.
    5. Seleccione el tipo de atributo:
      • Para añadir atributos a los objetos principales, elementos de esquema Módulo/Objeto, seleccione Atributos de objetos y módulo.
      • Para añadir atributos de objetos enlazados, elemento de esquema Módulo/Object/Enlace/Enlazado, seleccione Atributos de objetos enlazados.
    6. En la ventana Selección del módulo de DOORS, seleccione un módulo de la estructura de base de datos de Rational DOORS y pulse Siguiente.
    7. En la ventana Línea base de DOORS, seleccione una línea base para el módulo. La línea base que seleccione determinará qué conjunto de atributos debe utilizarse.
    8. En la ventana Atributos de DOORS, se visualiza la siguiente información de atributos:
      • Nombre de atributo: lista los atributos disponibles en la línea base seleccionada.
      • Ámbito: muestra el ámbito del atributo como un módulo o un objeto.
      • Nombre de elevación: el nombre elevado del atributo es el nombre utilizado en las expresiones de script. Se genera un nombre válido a partir del nombre de atributo de Rational DOORS para evitar la especificación de un valor no válido. Un atributo elevado permite el acceso directo a dicho valor de atributo desde un contexto Módulo/Objeto. Los valores de atributo no elevados sólo están disponibles desde un contexto Módulo/Objeto/Atributo.

      Marque un recuadro de selección para especificar un atributo o pulse Seleccionar todo para seleccionar todos los atributos. La opción Deseleccionar todo borra todos los atributos. Pulse Siguiente.

    9. En la ventana Vistas y columnas de DOORS, seleccione la vista. A continuación, marque el recuadro de selección correspondiente a un nombre de columna para seleccionarla o pulse Seleccionar todo para seleccionar todos los nombres de columna. Pulse Siguiente.
      Nota: se visualizará un nombre de elevación de la columna en la columna Nombre de elevación. Puede elevar las columnas a partir de cualquier número de vistas. Puede elevar los atributos más adelante, al diseñar la plantilla. Los atributos añaden información declarativa a los elementos más allá de las palabras clave predefinidas habituales. Los atributos de Rational DOORS definidos por el usuario sólo son accesibles a través de los nodos Atributo del archivo de esquema estándar de Rational DOORS. Para utilizar estos atributos, los valores de atributo pueden elevarse como atributos XML utilizando el asistente de descubrimiento de esquemas XML. Un atributo puede tener una sola aparición, por ejemplo, Nombre de módulo, y la propiedad Última modificación. Los atributos pueden aplicarse a un objeto, pero tener varias apariciones, como por ejemplo Cabecera de objeto y Texto de objeto.
    10. En la ventana Seleccionar opciones de esquema, especifique los detalles de los campos siguientes:
      • Seleccionar ubicación de esquema: Pulse Examinar para seleccionar la ubicación para guardar el esquema de origen de datos.
      • ID de esquema de origen de datos: Especifique el ID para el esquema de origen de datos.
      • Seleccione el recuadro Añadir esquema de origen de datos a la plantilla actual para añadir este esquema a la plantilla abierta. Pulse Siguiente.
      • Guarde los esquemas para reutilizarlos en otras plantillas sin volver a ejecutar el Asistente de descubrimiento de esquema.
    11. Revise la información de la ventana de resumen y pulse Finalizar.
  4. Trabaje con atributos. Puede descubrir qué atributos de objeto están presentes en el módulo de Rational DOORS y, después, valorar si deben aparecen en el informe de Rational Publishing Engine. Utilice la selección del menú Editar > Atributos para acceder a la lista de atributos incluidos en el módulo.
  5. Añada elementos a la plantilla. Rational Publishing Engine tiene un conjunto integral de elementos de plantilla que puede utilizar para estructurar el documento. Puede arrastrar elementos hasta el editor de contenidos de plantilla. Por ejemplo, puede añadir un elemento de contenedor para contener varios párrafos. Cada párrafo podría estar controlado por una condición de prueba que solo se asocia con datos específicos. Si desea más información, consulte Elementos de plantillas en la vista Paleta u Añadir elementos a una plantilla.
    Elementos de contenedor
    Puede utilizar elementos de contenedor, en lugar de tablas para los diagramas de Rational DOORS Analyst que están incluidos en una tabla 1x1.
    Elementos de imagen
    Las imágenes se extraen de un módulo de Rational DOORS con los valores para el atributo. No puede consultar solo las imágenes.
    Para configurar el tamaño de las imágenes extraídas, especifique las propiedades ancho máx de imagen y altura máx de imagen. Estas propiedades se pueden especificar en dos lugares:
    • La información de formato del elemento define el tamaño para las imágenes incluidas en dicho elemento de plantilla. Disponible solo para elementos de plantilla de texto.
    • Los metadatos de especificación de documento definen el tamaño para las imágenes en todas las plantillas. Los valores del formato de elemento alteran temporalmente estos valores globales.
    Elementos de tabla
    Es posible que no puede reproducir una tabla de Rational DOORS en Rational Publishing Engine exactamente como aparece en Rational DOORS; puede utilizar los atributos disponibles de la tabla Rational DOORS y generar una tabla nueva.
    Utilice el asistente de esquema de Rational DOORS para extraer información sobre las tablas de Rational DOORS. Ejemplo: TableCellWidthAncho de celda en píxeles de pantalla. Existen 2 formas para extraer información de columna de Rational DOORS:
    • Utilización de módulo/objeto/columna para obtener los nombres y valores de columna en una consulta de objeto. Esto es útil cuando los datos de Rational DOORS se iteran mediante objeto.
    • Utilización de módulo/vista/columna para obtener los nombres de columna de la vista Rational DOORS utilizada para la generación de documentos. La iteración por vista es útil cuando son necesarias las columnas definidas en la vista actual, y sus propiedades. Puede utilizar plantillas de ejemplo de Rational Publishing Engine para probar estos métodos.
      Nota: Para acceder a datos de columna, utilice módulo/objeto/columna/(@Column Text) en la consulta.

    Si tiene celdas en tablas de Rational DOORS que abarcan varias filas, Rational Publishing Engine genera la primera celda y las celdas restantes de la expansión se eliminan.

    Consulte Añadir un elemento de tabla si desea más información sobre tablas.

  6. Utilice consultas, atributos, y variables para añadir datos a una plantilla. Estos elementos especifican qué partes de información se generan en el informe. Las consultas en IBM® Rational DOORS empiezan con el elemento raíz (módulo), continúa con su elemento hijo (Objeto) y, después, con el atributo hijo del objeto. Por ejemplo, Módulo/Objeto/Atributo/Nombre. Consulte el apartado Esquema de Rational DOORS para obtener más información.
  7. Añada formato y estilo a los elementos para controlar cómo se muestran en la salida.
  8. Cree filtros para limitar los datos que se extraen del informe. Puede utilizar filtros, que son versiones detalladas del URI de origen de datos general, para señalar a subconjuntos específicos de datos, de forma que Rational Publishing Engine no intenta recuperar más información de la necesaria del origen de datos durante la generación de informes. Estos filtros deben ser lo bastante amplios para recuperar todos los datos necesarios referenciados por la plantilla o el informe generado no podrá incluir datos completos. Puede definir filtros nativos en consultas de enlace. Consulte el apartado Ejemplo: Filtros nativos de Rational DOORS para obtener más información.
  9. Cree clasificaciones para organizar los datos en el informe. Para Rational DOORS, el texto de clasificación nativa debe tener el formato de la clasificación de Rational DOORS. Consulte el apartado Ejemplo: Clasificaciones nativas en Rational DOORS para obtener más información.

Qué hacer a continuación

Si obtiene una vista previa de datos desde la aplicación Document Studio, se utilizan la línea base y la vista predeterminadas para recuperar los datos.