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 CenterPuede 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
- 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.
- En la aplicación Document Studio,
cree
una plantilla de documento.
- 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:
- En Document Studio, pulse .
- En el campo Predefinido, seleccione el
esquema de la base de datos Doors.
- En Tipo, seleccione el tipo de esquema en la lista. Para
Rational DOORS, seleccione DOORS.
- Edite el campo Esquema
si es necesario o pulse Examinar para
seleccionar la vía de acceso del archivo de esquema.
- Si el recurso está en un servidor protegido, especifique el nombre de Usuario.
- Si el recurso está en un servidor protegido, especifique la Contraseña.
- 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:
- En Document Studio, pulse .
- 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.
- Seleccione una vista:
- Vista de base de datos
- Vista de proyecto
- Pulse Siguiente.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Revise la información de la ventana de resumen y pulse Finalizar.
- 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ú
para acceder a la lista de atributos incluidos en el módulo.
- 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:
TableCellWidth –
Ancho de
celda en píxeles de pantalla. Existen 2 formas para
extraer información de columna de
Rational DOORS:
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.
- 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.
- Añada
formato
y estilo a los elementos para controlar cómo se muestran en la
salida.
- 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.
- 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.