Referencia de salida PDF para diseñar plantillas

Revise esta información para obtener más información sobre la generación de documentos PDF con el controlador PDF de Rational Publishing Engine.

Finalidad

Generar la plantilla en un documento .pdf.

Visores de contenido soportados

Para ver una lista de los productos soportados para visualizar este tipo de salida:
  1. Abra Requisitos del sistema .
  2. En la sección Por tipo, pulse Software.
  3. Desplácese a la sección Visores de contenido. Se listan los nombres y versiones de producto soportados para visualizar la salida de Rational Publishing Engine.

El controlador de PDF predeterminado genera archivos PDF versión 1.5. El controlador de PDF de herencia ya no está soportado. Si la especificación de documento apunta al controlador de PDF heredado antiguo, modifique la especificación para que haga referencia al controlador de PDF predeterminado.

Elementos de plantilla

Tabla 1. Elementos de plantilla disponibles para su uso para el formato de salida PDF
Elemento Descripción Puede contener otros elementos Puede contener valores de contenido y expresiones

Icono Párrafo Párrafo

Se utiliza para agrupar una sección de elementos. Añada un retorno de carro alrededor de sus elementos hijo en la salida.

No

Icono Contenedor Contenedor

Se utiliza para agrupar una sección de elementos. No se le puede aplicar un estilo y no afecta al formato de la salida.

Cuando se utiliza dentro de otros elementos, los elementos hijo disponibles para utilizar dentro del contenedor podrían estar limitados. Por ejemplo:
  • Dentro de filas, los contenedores solo pueden alojar celdas
  • Dentro de listas, los contenedores solo pueden alojar elementos de detalle de lista

No

Icono Texto Texto

El contenido se representa con el mismo formato especificado.

No

Icono Texto con estilo Texto con estilo

Un bloque de texto que puede tener un formato exclusivo en palabras individuales. Utilice la negrita, cursiva, subrayado, tachado o formato de color en una selección de palabras dentro del elemento. El texto es estático.

No

Icono Hiperenlace Hiperenlace

Crea un hiperenlace en la salida. El hiperenlace puede señalar a una ubicación dentro del documento o a una ubicación externa.

No

Icono Imagen Imagen

Muestra una imagen .gif, .png, .jpg, emf o wmf en la salida. El diseñador de informes puede especificar la vía de acceso de imagen en la plantilla o el generador de informes puede especificar la vía de acceso durante el tiempo de ejecución.

No

Icono Tabla Tabla

Crea una tabla en la salida. Una tabla puede contener filas o elementos de contenedor.

No

Icono Fila Fila

Crea una fila en la tabla actual.

No

Icono celda celda

Crea una celda en la fila actual de la tabla actual.

No

Icono Lista Lista

Crea una lista con viñetas o numérica en la salida.

No

Icono Elemento de lista Detalle de lista

Crea un elemento de lista en la lista actual de la salida.

No

Icono Configuración de origen de datos Configuración de origen de datos

Consulte Añadir un elemento de configuración de origen de datos.

No

No

Icono Archivo de inclusión Archivo de inclusión

Incluye el archivo especificado en la salida como un campo INCLUDETEXT.

  • El archivo incluido puede tener una extensión .doc, .docx, .txt o .rtf.
  • Para la salida de Microsoft Word, debe actualizar todos los campos con la macro para ver el archivo incluido.
  • Para la salida HTML y XSL-FO, el archivo incluido es un hiperenlace al documento.

No

Icono Región Región

Las regiones son elementos estáticos que le permiten alterar el flujo de salida redirigiendo el contenido de otros elementos o grupos de elementos. Si un elemento tiene la propiedad región de destino especificada con el nombre de un elemento de región, su contenido se representa en la región especificada, en lugar de en su posición del documento.

No

No

Icono Marcador Marcador

Define un marcador en el documento. El nombre del marcador generador es el contenido para el marcador. Al generar los documentos, Rational Publishing Engine genera un nombre exclusivo para cada marcador. El nombre se basa en el nombre proporcionado durante el tiempo de diseño y un identificador exclusivo generado durante el tiempo de ejecución.

No

Icono Salto de página Salto de página

Añade un salto de página a la salida.

No

No

Icono Salto de sección Salto de sección

Añade un salto de sección a la salida.

No

No

Icono Tabla de contenido Tabla de contenido

Añade una tabla de contenido a la salida.

No

No

Icono Número de página Número de página

Añade un número de página en la salida. Solo soportado en la salida de Microsoft Word y PDF.

No

No

Icono Número total de páginas Número total de páginas

Añade el número total de páginas en la salida. Solo está soportado para la salida de Microsoft Word y PDF.

No

No

Si el PDF tarda en generarse, añada Icono de elemento Salto de sección elementos Salto de sección a la plantilla a fin de mejorar el rendimiento.

Propiedades de elementos

Revise estas notas para obtener más información sobre la especificación de propiedades de elemento en las plantillas que están diseñadas para generar documentos PDF.
Tabla 2. Propiedades de celda
Propiedades de celda Notas
Ancho del borde Debe especificar un valor de ancho del borde entre 1 y 30 píxeles para crear un borde en la salida.
Alineación de celda Esta propiedad especifica la posición del texto dentro de la celda. El valor justify no está soportado para este formato de salida.
Anchura de celda Especifique un valor en puntos o píxeles. Si especifica un valor en píxeles, el valor se convierte en puntos y se supone que la visualización es de 96 ppp. Si especifica un valor como un porcentaje, el valor se ignora. Cuando se combinan tablas, debe establecer la propiedad Anchura de celda para asegurarse de que los tamaño de columna son iguales.
Distribución de columnas Todas las filas y columnas debe contener el mismo número de celdas. Los bordes entre celdas se eliminan y se aplica a la salida sólo el contenido o las propiedades especificadas para la primera celda. Evite el solapamiento de distribuciones.
Espacio de fila Todas las filas y columnas debe contener el mismo número de celdas. Los bordes entre celdas se eliminan y se aplica a la salida sólo el contenido o las propiedades especificadas para la primera celda. Evite el solapamiento de distribuciones.
Tabla 3. Propiedades de comentario
Propiedades de comentario Notas
Contenido Si incluye hiperenlaces en la propiedad Contenido de los elementos Comentario, los hiperenlaces se pueden pulsar en la salida PDF.
Tabla 4. Propiedades de título de figura
Propiedades de título de figura Notas
Ancho del borde No debe utilizarse para este formato de salida.
Campo de código Aparecen números arábigos o romanos secuencialmente en cada título.
Tabla 5. Propiedades de nota a pie de página
Propiedades de nota a pie de página Notas
Nombre de estilo Si aplica un estilo a elementos en línea como, por ejemplo, notas a pie de página, texto, texto con estilo o tablas, el estilo se aplica a todos los elementos en línea hasta el siguiente elemento de bloque como, por ejemplo, un párrafo. Por ejemplo, si añade un estilo a un elemento de nota a pie de página y hay un elemento de texto con estilo antes que él, el estilo también se aplica al elemento de texto con estilo.
Tabla 6. Propiedades de las imágenes
Propiedades de las imágenes Notas
Ancho del borde No debe utilizarse para este formato de salida.
Contenido Formatos de imagen soportados: .bmp, .emf, .gif, .jpg, .png, .wmf

Las imágenes .svg están soportadas por Rational Publishing Engine, pero no están soportadas por Microsoft Word. El controlador PDF utiliza la funcionalidad de Microsoft Word. Para generar el documento correctamente en la salida PDF, las imágenes .svg se convierten en imágenes .png. El proceso de conversión puede distorsionar la visualización de la imagen en la salida.

Tabla 7. Propiedades de la lista
Propiedades de la lista Notas
Estilo de numeración Puede utilizar los siguientes estilos:
  • Bullet: listas desordenadas
  • Arabic: listas numeradas
  • Uppercase roman: números romanos en mayúsculas
  • Lowercase roman: números romanos en minúsculas
  • Uppercase alpha: letras en mayúsculas
  • Lowercase alpha: letras en minúsculas
Espaciado de carácter de numeración No debe utilizarse para este formato de salida.
Tabla 8. Propiedades de detalles de lista
Propiedades de detalles de lista Notas
Ancho del borde No debe utilizarse para este formato de salida.
Tabla 9. Propiedades de números de página
Propiedades de números de página Notas
Ancho del borde No debe utilizarse para este formato de salida.
Tabla 10. Propiedades de párrafos
Propiedades de párrafos Notas
Ancho del borde Debe especificar un valor de ancho del borde entre 1 y 30 píxeles para crear un borde en la salida.
Alineación de párrafo Espacia el texto en la página con una determinada alineación.

Las alineaciones left, right y center crean bordes de párrafo desiguales, ajustando tantas palabras en un párrafo como sea posible. Justify crea bordes de párrafo iguales al insertar un espacio adicional entre las palabras en todas las líneas, excepto en la última.

No utilice distributed para este formato de salida.

Control de viudas/huérfanas Cuando se establece en true, se ajusta el interlineado para evitar los siguientes resultados de formato:
  • Una sola palabra al final de un párrafo en una nueva línea
  • Una sola línea al final de un párrafo en una nueva página

Cuando se establece en false, el espaciado no se ajusta.

Tabla 11. Propiedades de filas
Propiedades de filas Notas
Salto de fila entre páginas Cuando se establece en true, el contenido de una fila al final de una página se divide, si es necesario. El contenido que no cabe en la página pasa a la siguiente página como una nueva fila.

Cuando se establece en false, el contenido de una fila al final de la página no se divide. Toda la fila pasa a la página siguiente.

Tabla 12. Propiedades de texto con estilo
Propiedades de texto con estilo Notas
Nombre de estilo Si aplica un estilo a elementos en línea como, por ejemplo, notas a pie de página, texto, texto con estilo o tablas, el estilo se aplica a todos los elementos en línea hasta el siguiente elemento de bloque como, por ejemplo, un párrafo. Por ejemplo, si añade un estilo a un elemento de nota a pie de página y hay un elemento de texto con estilo antes que él, el estilo también se aplica al elemento de texto con estilo.
Tabla 13. Propiedades de tabla
Propiedades de tabla Notas
Ajuste automático al contenido Cambia la tabla para ajustarse al contenido de cada celda. Cuando utilice esta propiedad, establezca también la propiedad Cambiar el tamaño para ajustarse al contenido en true.
Ajuste automático en ventana Cambia el tamaño de la tabla al ancho de página. Borrar esta propiedad cuando Cambiar el tamaño para ajustarse al contenido sea false.
Ancho del borde Debe especificar un valor de ancho del borde entre 1 y 30 píxeles para crear un borde en la salida.
Estilo de borde Utilice el valor single en lugar de thick, hairline, inset u outset. Se aplica el mismo formato para todos estos valores y se parece mucho más a lo que esperaría ver para single.
Espaciado de celdas No debe utilizarse para este formato de salida.
Anchura de celda fija en la columna Especifique un valor en píxeles para asegurarse de que todas las celdas de una columna tengan la misma anchura.
Cambiar el tamaño para ajustarse al contenido Cuando el valor es true y se borran ancho y ajuste automático en ventana, el ancho de columna se ajusta al contenido. Si se establece ajuste automático al contenido, debe establecer cambiar el tamaño para ajustarse al contenido en true.

Cuando el valor es false, borre las propiedades ancho y ajuste automático en ventana de la tabla. La tabla se genera con el tamaño de la columna predeterminado de una pulgada.

Nombre de estilo Si aplica un estilo a elementos en línea como, por ejemplo, notas a pie de página, texto, texto con estilo o tablas, el estilo se aplica a todos los elementos en línea hasta el siguiente elemento de bloque como, por ejemplo, un párrafo. Por ejemplo, si añade un estilo a un elemento de nota a pie de página y hay un elemento de texto con estilo antes que él, el estilo también se aplica al elemento de texto con estilo.
Ajuste automático de la tabla Cuando se establece en true, se cambia el tamaño de la tabla para ajustarse a la anchura de la página. Cuando cambiar el tamaño para ajustarse al contenido también se establece en true, las anchuras de celda se ignoran y se cambia el tamaño de la página para ajustarse al contenido.

No puede especificar anchura de columna fija como valor. Utilice la propiedad anchura de celda fija en su lugar.

Ancho Debe especificar un valor, a menos que establezca la propiedad Cambiar el tamaño para ajustarse al contenido en false.
Tabla 14. Propiedades de títulos de tabla
Propiedades de títulos de tabla Notas
Ancho del borde No debe utilizarse para este formato de salida.
Campo de código Aparecen números arábigos o romanos secuencialmente en cada título.
Tabla 15. Propiedades de texto
Propiedades de texto Notas
Ancho del borde Debe especificar un valor de ancho del borde entre 1 y 30 píxeles para crear un borde en la salida.
Nombre de estilo Si aplica un estilo a elementos en línea como, por ejemplo, notas a pie de página, texto, texto con estilo o tablas, el estilo se aplica a todos los elementos en línea hasta el siguiente elemento de bloque como, por ejemplo, un párrafo. Por ejemplo, si añade un estilo a un elemento de nota a pie de página y hay un elemento de texto con estilo antes que él, el estilo también se aplica al elemento de texto con estilo.
Tabla 16. Propiedades de número total de páginas
Propiedades de número total de páginas Notas
Ancho del borde No debe utilizarse para este formato de salida.

Elemento de archivo de inclusión

Puede elegir enlazar el archivo o incorporar físicamente el archivo en el documento de salida. Sin embargo, la forma como se manejan los elementos de archivo de inclusión depende del formato de salida y la ubicación desde la que recupera el archivo. Para la salida PDF, el archivo incluido se importa y se muestra el contenido completo del documento.

Estilos de cabecera

Los formatos de salida PDF no tienen estilos de cabecera; sin embargo, Rational Publishing Engine utiliza estilos de cabecera definidos internamente.

Datos Unicode en la salida

Todos los datos Unicode se representan si el font que se utiliza da soporte a Unicode. Para la salida PDF, se necesita una configuración adicional. Consulte Valores de salida PDF para obtener más detalles. Si ha utilizado un font no de Unicode, vuelva a generar el documento utilizando fonts True Type Unicode y establezca las propiedades de salida adecuadas.

Objetos OLE

Puede extraer objetos incorporados como, por ejemplo, la inclusión y el enlace de objetos (objetos OLE) desde los atributos en un origen de datos. No obstante, los objetos OLE siempre se representan como imágenes en la salida PDF, ya que el formato no admite objetos OLE.