Referência de saída de PDF para projetar modelos

Revise estas informações para aprender mais sobre como gerar documentos PDF com o driver PDF do Rational Publishing Engine.

Finalidade

Para gerar a saída do modelo em um documento .pdf.

Visualizadores de conteúdo suportados

Para obter uma lista dos produtos suportados para visualização desse tipo de saída:
  1. Abra o Requisitos do sistema .
  2. Na seção Por Tipo, clique em Software.
  3. Role para a seção Visualizadores de Conteúdo. São listados os nomes e versões dos produtos que são suportados para visualização da saída da Rational Publishing Engine.

O driver PDF padrão produz arquivos PDF da versão 1.5. O driver PDF anterior não é mais suportado. Se sua especificação de documento apontar para o driver PDF anterior, modifique a especificação para se referir ao driver PDF padrão.

Elementos do Modelo

Tabela 1. Elementos do modelo disponíveis para uso para o formato de saída PDF
Element Descrição Pode conter outros elementos Pode conter valores de conteúdo e expressões

ícone Parágrafo Parágrafo

Use para agrupar uma seção de elementos. Inclui um retorno de linha em seus elementos filhos na saída.

Sim

No

ícone Contêiner Contêiner

Use para agrupar uma seção de elementos. Não pode ser estilizado e não afeta a formatação da saída.

Quando usados em outros elementos, os elementos filhos disponíveis para uso no contêiner podem ser limitados. Por exemplo:
  • Em linhas, os contêineres podem hospedar apenas células
  • Em listas, os contêineres podem hospedar apenas elementos de detalhes da lista de hosts

Sim

No

ícone Texto Texto

O conteúdo é renderizado com a mesma formatação especificada.

No

Sim

ícone Texto estilizado Texto estilizado

Um bloco de texto que pode ter formatação exclusiva em palavras individuais. Use negrito, itálico, sublinhado, riscado ou formatação de cor em uma seleção de palavras no elemento. O texto é estático.

No

Sim

ícone Hiperlink Hiperlink

Cria um hiperlink na saída. O hiperlink pode apontar para um local dentro do documento ou para um local externo.

No

Sim

ícone Imagem Imagem

Exibe uma imagem .gif, .png, .jpg, emf ou wmf na saída. O designer de relatório pode especificar o caminho da imagem no modelo ou o gerador de relatórios pode especificar o caminho no tempo de execução.

No

Sim

ícone Tabela Tabela

Cria uma tabela na saída. Uma tabela pode conter linhas ou elementos do contêiner.

Sim

No

ícone Linha Linha

Cria uma linha na tabela atual.

Sim

No

ícone Célula Célula

Cria uma célula na linha atual da tabela atual.

Sim

No

ícone Lista Lista

Cria uma lista com marcadores ou numérica na saída.

Sim

No

ícone Item da lista Detalhes da lista

Cria um item da lista na lista atual na saída.

Sim

No

ícone Configuração da origem de dados Configuração da origem de dados

Consulte Incluindo um elemento de configuração de origem de dados.

No

No

ícone Arquivo include Arquivo include

Inclui o arquivo especificado na saída como um campo INCLUDETEXT.

  • O arquivo incluído pode ter uma extensão .doc, .docx, .txt ou .rtf.
  • Para saída do Microsoft Word, você deve atualizar todos os campos com a macro para ver o arquivo incluído.
  • Para saída de HTML e XSL-FO, o arquivo incluído é um hiperlink para o documento.

No

Sim

Ícone Região Região

Regiões são elementos estáticos que permitem alterar o fluxo de saída redirecionando o conteúdo de outros elementos ou grupos de elementos. Se um elemento tiver a propriedade região de destino especificada com o nome de um elemento de região, seu conteúdo será renderizado na região especificada em vez de em sua posição no documento.

No

No

ícone Favorito Favorito

Define um marcador no documento. O nome do marcador gerado é o conteúdo para o marcador. Ao gerar os documentos, o Rational Publishing Engine gera um nome exclusivo para cada marcador. O nome é baseado no nome fornecido no tempo de design e um identificador exclusivo gerado no tempo de execução.

No

Sim

ícone Quebra de página Quebra de página

Inclui uma quebra de página na saída.

No

No

ícone Quebra de seção Quebra de seção

Inclui uma quebra de seção na saída.

No

No

ícone Índice Índice

Inclui um índice na saída.

No

No

ícone Número da página Número da página

Inclui um número da página na saída. Suportado apenas na saída do Microsoft Word e do PDF.

No

No

ícone Número total de páginas Número total de páginas

Inclui o número total de páginas na saída. Suportado apenas para a saída do Microsoft Word e do PDF.

No

No

Se o PDF for lento para ser gerado, inclua elementos de quebra de seção ícone Elemento de quebra de seção no modelo para melhorar o desempenho.

Propriedades do elemento

Revise essas notas para entender mais sobre como especificar as propriedades do elemento em modelos que são projetados para gerar documentos PDF.
Tabela 2. Propriedades de célula
Propriedades de célula Observações
Largura da borda Você deve especificar um valor de largura de borda entre 1 e 30 pixels para criar uma borda na saída.
Alinhamento de célula Essa propriedade especifica a posição do texto dentro da célula. O valor justificar não é suportado para este formato de saída.
Largura da Célula Insira um valor em pontos ou pixels. Se você inserir um valor em pixels, o valor será convertido em pontos e assumirá que a exibição seja de 96 dpi. Se você inserir um valor como uma porcentagem, o valor será ignorado. Quando você estiver combinando tabelas, deverá configurar a propriedade largura da célula para assegurar que os tamanhos de coluna sejam os mesmos.
Span da coluna Todas as linhas e colunas devem conter o mesmo número de células. As bordas entre células são removidas, mas apenas o conteúdo ou as propriedades especificadas para a primeira célula são aplicadas na saída. Evite extensões de sobreposição.
Extensão de Linha Todas as linhas e colunas devem conter o mesmo número de células. As bordas entre células são removidas, mas apenas o conteúdo ou as propriedades especificadas para a primeira célula são aplicadas na saída. Evite extensões de sobreposição.
Tabela 3. Propriedades de comentário
Propriedades de comentário Observações
Conteúdo Se você incluir hiperlinks na propriedade Conteúdo de elementos Comentário, os hiperlinks serão clicáveis na saída PDF.
Tabela 4. Propriedades de legenda da figura
Propriedades de legenda da figura Observações
Largura da borda Não use para este formato de saída.
Código de campo Numerais arábicos ou romanos são exibidos sequencialmente em cada legenda.
Tabela 5. Propriedades de nota de rodapé
Propriedades de nota de rodapé Observações
Nome do Estilo Se você aplicar um estilo a elementos sequenciais, como notas de rodapé, texto, texto estilizado ou tabelas, o estilo será aplicado a todos os elementos sequenciais até o próximo elemento do bloco, como um parágrafo. Por exemplo, se você incluir um estilo em um elemento de nota de rodapé e houver um elemento de texto estilizado nele, o estilo também será aplicado ao elemento de texto estilizado.
Tabela 6. Propriedades da imagem
Propriedades da imagem Observações
Largura da borda Não use para este formato de saída.
Conteúdo Formatos de imagem suportados: imagens .bmp, .emf, .gif, .jpg, .png, .wmf

.svg são suportadas pelo Rational Publishing Engine, mas não são suportadas pelo Microsoft Word. O driver PDF usa funcionalidade do Microsoft Word. Para gerar o documento corretamente em saída PDF, as imagens .svg são convertidas em imagens .png. O processo de conversão pode distorcer a exibição da imagem na saída.

Tabela 7. Propriedades da Lista
Propriedades da Lista Observações
Estilo de Numeração Você pode utilizar os seguintes estilos:
  • Marcadores: lista não ordenada
  • Árabe: listas numeradas
  • Romano maiúsculo: numerais romanos maiúsculos
  • Romano minúsculo: numerais romanos minúsculos
  • Alfa em maiúscula: letras maiúsculas
  • Alfa em minúscula: letras minúsculas
Espaçamento de caractere de numeração Não use para este formato de saída.
Tabela 8. Propriedades de detalhes da lista
Propriedades de detalhes da lista Observações
Largura da borda Não use para este formato de saída.
Tabela 9. Propriedades de número da página
Propriedades de número da página Observações
Largura da borda Não use para este formato de saída.
Tabela 10. Propriedades de parágrafo
Propriedades de parágrafo Observações
Largura da borda Você deve especificar um valor de largura de borda entre 1 e 30 pixels para criar uma borda na saída.
Alinhamento de Parágrafos Espaça o texto na página com um certo alinhamento.

Alinhamento esquerdo, direito e centro criam bordas irregulares de parágrafo, ajustando quantas palavras em um parágrafo forem possíveis. Justificar cria bordas regulares de parágrafo, inserindo espaço adicional entre palavras em todas as linhas, exceto a última.

Não use distribuído para este formato de saída.

Controle de viúva/órfã Quando configurado como true, o espaçamento de linha será ajustado para evitar os seguintes resultados de formatação:
  • Uma única palavra encerrando um parágrafo em uma nova linha
  • Uma única linha encerrando um parágrafo em uma nova página

Quando configurado como false, o espaçamento não é ajustado.

Tabela 11. Propriedades da linha
Propriedades da linha Observações
Quebra de linha entre páginas Quando configurado como true, o conteúdo de uma linha que aparece no final de uma página é dividido, se necessário. O conteúdo que não se ajusta à página é carregado durante na próxima página como uma nova linha.

Quando configurado como false, o conteúdo de uma linha no final da página não é dividido. A linha inteira é carregada na próxima página.

Tabela 12. Propriedades de texto de estilo
Propriedades de texto de estilo Observações
Nome do Estilo Se você aplicar um estilo a elementos sequenciais, como notas de rodapé, texto, texto estilizado ou tabelas, o estilo será aplicado a todos os elementos sequenciais até o próximo elemento do bloco, como um parágrafo. Por exemplo, se você incluir um estilo em um elemento de nota de rodapé e houver um elemento de texto estilizado nele, o estilo também será aplicado ao elemento de texto estilizado.
Tabela 13. Propriedades da tabela
Propriedades da tabela Observações
Ajuste automático para conteúdo Redimensiona a tabela para ajustar o conteúdo que cada célula contém. Quando você usa essa propriedade, também configura a propriedade Redimensionar para ajustar conteúdo como true.
Ajuste automático para janela Redimensiona a tabela à largura da página. Limpe essa propriedade quando Redimensionar para ajustar conteúdo for false.
Largura da borda Você deve especificar um valor de largura de borda entre 1 e 30 pixels para criar uma borda na saída.
Estilo borda Utilize o valor única em vez de larga, linha no topo, inserção, ou remoção. A mesma formatação é aplicada para todos esses valores e assemelha-se mais ao que você esperaria ver em única.
Espaçamento da célula Não use para este formato de saída.
Largura da célula fixa na coluna Especifique um valor em pixels para assegurar que todas as células em uma coluna sejam da mesma largura.
Redimensionar para ajustar conteúdo Quando o valor for true e largura e ajuste automático para janela estiverem limpos, a largura da coluna será ajustada para ajustar o conteúdo. Se ajuste automático para conteúdo estiver configurado, você deverá configurar redimensionar para ajustar conteúdo como true.

Quando o valor for false, limpe as propriedades largura e ajuste automático para janela para a tabela. A tabela é gerada com o tamanho da coluna padrão de uma polegada.

Nome do Estilo Se você aplicar um estilo a elementos sequenciais, como notas de rodapé, texto, texto estilizado ou tabelas, o estilo será aplicado a todos os elementos sequenciais até o próximo elemento do bloco, como um parágrafo. Por exemplo, se você incluir um estilo em um elemento de nota de rodapé e houver um elemento de texto estilizado nele, o estilo também será aplicado ao elemento de texto estilizado.
Ajuste automático de tabela Quando configurado como true, a tabela é redimensionada para ajustar a largura da página. Quando redimensionar para ajustar conteúdo também é configurado como true, larguras da célula são ignoradas e a tabela é redimensionada para corresponder ao conteúdo.

Não é possível inserir largura da coluna fixa como um valor. Use a propriedade largura da célula fixa.

Largura Você deve especificar um valor, a menos que configure a propriedade Redimensionar para ajustar conteúdo como false.
Tabela 14. Propriedades de legenda da tabela
Propriedades de legenda da tabela Observações
Largura da borda Não use para este formato de saída.
Código de campo Numerais arábicos ou romanos são exibidos sequencialmente em cada legenda.
Tabela 15. Propriedades do Texto
Propriedades do Texto Observações
Largura da borda Você deve especificar um valor de largura de borda entre 1 e 30 pixels para criar uma borda na saída.
Nome do Estilo Se você aplicar um estilo a elementos sequenciais, como notas de rodapé, texto, texto estilizado ou tabelas, o estilo será aplicado a todos os elementos sequenciais até o próximo elemento do bloco, como um parágrafo. Por exemplo, se você incluir um estilo em um elemento de nota de rodapé e houver um elemento de texto estilizado nele, o estilo também será aplicado ao elemento de texto estilizado.
Tabela 16. Propriedades de número total de páginas
Propriedades de número total de páginas Observações
Largura da borda Não use para este formato de saída.

Incluir elemento do arquivo

É possível escolher vincular o arquivo ou o arquivo fisicamente integrado em seu documento de saída. No entanto, o caminho que elementos de arquivo include são manipulados depende do formato de saída e do local do qual você está recuperando o arquivo. Para saída PDF, o arquivo include é importado e o conteúdo completo do documento é exibido.

Estilos do título

Formatos de saída PDF não possuem estilos de título; no entanto, o Rational Publishing Engine usa internamente estilos de título definidos.

Dados Unicode na saída

Todos os dados Unicode são renderizados se a fonte que é usada suportar Unicode. Para saída PDF, configuração adicional é necessária. Consulte as configurações de saída PDF para obter detalhes. Se você usou uma fonte não Unicode, gere o documento novamente usando as fontes True Type Unicode e configure as propriedades de saída apropriadas.

Objetos OLE

Você pode extrair objetos integrados, como vinculação e incorporação de objetos (objetos OLE), de atributos em uma origem de dados. Objetos OLE são sempre renderizados como imagens na saída PDF porque o formato não suporta objetos OLE.