Diseño de plantillas con Rational DOORS Next Generation 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. Las prestaciones proporcionadas por la aplicación Gestión de requisitos (RM) se licencian como IBM® Rational DOORS Next Generation. La información sobre la integración de la aplicación RM se aplica a Rational DOORS Next Generation y a versiones específicas de IBM Rational Requirements Composer.

Antes de empezar

Consejo: La instalación de Rational Publishing Engine incluye un conjunto de informes de ejemplo. Antes de empezar a publicar documentos, puede explorar este escenario de generación de documentos de ejemplo. Consulte Creación de la plantilla de ejemplo REST.
Familiarícese con el servicio REST de la aplicación RM y los distintos URL necesarios para poder extraer datos de la aplicación RM al utilizar Rational Publishing Engine. Para localizar el Information Center para la versión de la aplicación RM, consulte la documentación del producto Rational DOORS Next Generation

Acerca de esta tarea

Los datos se extraen utilizando la API REST. Esta interfaz se instala e implementa con la aplicación de origen de datos y funciona independientemente de Rational Publishing Engine. Si desea más información sobre la API REST para un origen de datos, consulte la documentación para el origen de datos.

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. Para añadir fragmentos de datos específicos del proyecto de la aplicación RM, especifique el URL en este formato:
    • https://servidor:puerto/rm/publish/artefacto
    Ejemplo:
    • https://servidor:puerto/rm/publish/resources
  4. Añada un esquema de origen de datos a la plantilla de documento. Para la aplicación RM, puede completar los pasos siguientes:
    1. En Document Studio, pulse Datos > Añadir esquema de origen de datos.
    2. En el campo Predefinido, seleccione Texto DNG o Módulo DNG.
    3. En Tipo, seleccione el tipo de esquema en la lista. Para la aplicación RM, seleccione XML genérico.
    4. Edite el campo Esquema si es necesario o pulse Examinar para seleccionar la vía de acceso del archivo de esquema. Ejemplo: https://servidor:puerto/rm/publish/artifact?metadata=schema.

      Para CLM 6.0.2 y posteriores, puede obtener el enlace permanente pulsando el icono Mostrar enlace permanente al final del rastro de navegación para el artefacto en Rational DOORS Next Generation. El URL se muestra en la ventana Mostrar enlace permanente. Pegue el URL en el campo Esquema y añada &metadata=schema al final del URL.

    5. (Solo perfil POX - para CLM 6.0.2 y posteriores) En el campo Cabeceras adicionales, seleccione la cabecera del perfil POX. Si desea más información sobre el perfil POX, consulte Creación de documentos de rastreabilidad de aplicaciones CLM utilizando el perfil POX.
    6. Pulse Siguiente y, después, Finalizar.
    7. Si el recurso está en un servidor protegido, especifique el nombre de Usuario.
    8. Si el recurso está en un servidor protegido, especifique la Contraseña.
    9. Seleccione el Tipo de autenticación en la lista. Para la aplicación RM, el tipo de autenticación es OAuth. Si no selecciona OAuth, se prueba cada tipo de autenticación, hasta que se encuentra el tipo correcto, que podría aumentar el tiempo de generación de documentos.
  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 tabla
    Cuando los datos de tabla son la entrada de la aplicación RM, se deben especificar los anchos en el nivel de columna, al igual que para cada celda, y no en el nivel de tabla que procesará Rational Publishing Engine.
  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.
  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. Consulte Orígenes de datos de Rational Requirements Composer para obtener más información.
  9. Cree clasificaciones para organizar los datos en el informe.