Plantillas de documento

Una plantilla de documento es un proyecto para generar documentos. La plantilla define qué datos se van a extraer del origen de datos y cómo se fomatean estos datos en la salida.

Las plantillas de documento son archivos de archivado autónomos con la extensión .dta (archivado de plantilla de documento). Las plantillas de Rational Publishing Engine son ligeramente diferentes de las plantillas que se podrían proporcionar con otros productos. Con otros productos, las plantillas son artefactos de ejemplo que se han llenado previamente con información que se obtiene y que se personaliza. En Rational Publishing Engine, las plantillas son los archivos base para estructurar la salida de informe. Las plantillas podrían tener información llenada previamente incluidos, si empieza con el archivo de plantilla de otra persona como base, pero una plantilla nueva está en blanco.

Las plantillas de documento que se crean con versiones anteriores de IBM® Rational Publishing Engine funcionan con la última versión. Sin embargo, si el proveedor de datos no admite la última versión de la estructura de la plantilla de Rational Publishing Engine, puede establecer la versión de plantilla para utilizar la estructura de plantilla de versiones anteriores de Rational Publishing Engine.

Puede añadir ambos contenidos, estático y dinámico, a una plantilla de documento. El contenido estático incluye el texto y las imágenes que se proporcionan cuando se diseña la plantilla. El contenido dinámico se representa mediante datos obtenidos de los orígenes de datos cuando se genera el documento. Además, la plantilla define información de formato, aunque algunos datos podrían conservar la información de formato que está incluida en el origen de datos.

Una plantilla de documento podría contener:

Esquema de origen de datos en plantillas

Cuando defina la plantilla, utilice la definición de la estructura de datos, llamada esquema, en lugar de datos estáticos. Un esquema permite que la plantilla se aplique a cualquier origen de datos cuya estructura coincida con la estructura de la definición de origen de datos. Una plantilla puede contener cualquier número de esquemas de origen de datos.

Cuando un origen de datos no coincide exactamente con el esquema de origen de datos, Rational Publishing Engine procesa los elementos que coinciden con el esquema e ignora los errores no críticos. Por ejemplo, si se utiliza un atributo de Rational DOORS status en la plantilla, y el origen de datos real (un módulo Rational DOORS) no tiene este atributo, la generación de documentos sigue de forma predeterminada.

Rational Publishing Engine proporciona los mecanismos para crear u obtener esquemas para varios tipos de origen de datos como, por ejemplo, IBM Rational DOORS y orígenes de datos de Rational REST. Si desea más información sobre la definición de esquema estándar, consulte http://www.w3.org/XML/Schema. Puede utilizar una aplicación de terceros para generar un esquema a partir de datos XML.

Reutilización de plantilla

Puede reutilizar estructuras de plantilla de plantillas que están almacenadas de forma local o remota en el Creador de documentos. Tras crear una nueva plantilla, puede importar plantillas enteras en una plantilla maestra en la que está trabajando, cuando las plantillas que está importando no hacen referencia a otras plantillas. Cree fragmentos de código para secciones de documentos que suele reutilizar, como cabeceras y pies de página.

Cuando se importan plantillas, se puede hacer referencia a las mismas de forma dinámica o se pueden incorporar de forma física. Al hacer referencia dinámicamente a una plantilla o un archivo incluido, en función del tipo de salida en el que genera la plantilla, está añadiendo un enlace a dicha plantilla o archivo o cargando el contenido de la plantilla importada cuando genera la salida. Cuando se incorpora físicamente una plantilla o un archivo, se importa su contenido en la plantilla maestra inmediatamente, en lugar de durante el tiempo de ejecución.

Si existe algún conflicto entre la plantilla maestra y la plantilla a la que está haciendo referencia o que está incorporando, se le pedirá que resuelva los conflictos. Por ejemplo, los conflictos podrían incluir distintos esquemas de origen de datos. Cuando los esquemas de origen de datos son diferentes, el esquema de la plantilla importada se puede añadir a la plantilla maestra para resolver el conflicto.

Especificaciones de documento predeterminadas

Cada plantilla se asocia a una especificación de documento en blanco de forma predeterminada. Cuando se obtiene una vista previa de o se publica una plantilla desde la aplicación Document Studio, esta especificación de documento en blanco se puede personalizar o utilizar sin personalización para generar la salida. Document Studio mantiene la plantilla sincronizada con la especificación de documento predeterminada al abrir o guardar la plantilla.