Diseño de plantillas con Design Management 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

Familiarícese con el servicio REST de Design Management y los distintos URL necesarios para extraer datos de Design Management utilizando Rational Publishing Engine. Para localizar el Information Center para su versión de Design Management, consulte los Information Centers de la familia de productos Rational Software Architect.

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. Añada un esquema de origen de datos a la plantilla de documento utilizando el perfil POX (CLM 6.0.2 y posteriores): Si desea más información sobre el perfil POX, consulte Creación de documentos de rastreabilidad de aplicaciones CLM utilizando el perfil POX
    1. En Design Management, copie el URL del artefacto pulsando el icono Mostrar enlace permanente en el rastro de navegación.
    2. En Document Studio, pulse Datos > Añadir esquema de origen de datos.
    3. En el campo Predefinido, seleccione DS1.
    4. En Tipo, seleccione REST.
    5. Pegue el URL en el campo Esquema y añada &metadata=schema al final del URL.
    6. En el campo Cabeceras adicionales, seleccione la cabecera del perfil POX.
    7. Pulse Siguiente y, después, Finalizar. El esquema de origen de datos que ha seleccionado se muestra en la vista de origen de datos.
  4. Añada un esquema de origen de datos a la plantilla de documento utilizando el descubrimiento de esquema REST (CLM 6.0.1 y anteriores): Para Design Management, puede descubrir el esquema de origen de datos especificando el URL base para la aplicación.
    1. En Document Studio, pulse Datos > Descubrimiento de esquemas > Descubrimiento de esquemas de REST.
    2. Especifique un Nombre para el origen de datos.
    3. Especifique una Descripción para el origen de datos.
    4. Especifique el URL base para el recurso. El URL base para Design Management es: https://servidor:puerto/dm/reporting
    5. Seleccione el Tipo de autenticación en la lista.
      Importante: Para Design Management, debe especificar un tipo de autenticación para acceder a datos para el informe. El tipo de autenticación no se puede detectar automáticamente mediante Rational Publishing Engine.
    6. Si el recurso está en un servidor protegido, especifique el nombre de Usuario.
    7. Si el recurso está en un servidor protegido, especifique la Contraseña.
    8. Pulse Siguiente. El URL base que ha especificado se añade automáticamente con ?metadata=schema. Ejemplo: https://servidor:puerto/dm/reporting?metadata=schema
    9. Pulse Finalizar. El esquema de origen de datos que ha seleccionado se muestra en la vista de origen de datos.
  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.
  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. Design Management da soporte al filtrado nativo de orígenes de datos Reportable Rest v1. En los filtros de Reportable Rest v1, sólo es necesario especificar el texto entre corchetes []. Rational Publishing Engine genera el resto del filtro. Para obtener más información, consulte Reportable Rest v1.
  9. Cree clasificaciones para organizar los datos en el informe.