Incluindo um elemento de arquivo include

Use o elemento de modelo do arquivo include para anexar ou vincular arquivos externos de seu relatório.

Sobre Esta Tarefa

É 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.

Integrando arquivos fisicamente

Sobre Esta Tarefa

Quando você estiver selecionando arquivos de um local local ou remoto:
  • Para saídas HTML e XSL-FO, o arquivo include é sempre um hiperlink.
  • Para saída PDF, o arquivo include é importado e o conteúdo completo do documento é exibido.
  • Para saída do Microsoft Word, Rational Publishing Engine atualiza campos do Microsoft Word automaticamente durante a geração do documento. Se um campo INCLUDE TEXT for gerado, a macro não terá sido executada e a tarefa de importação do arquivo será delegado para Microsoft Word. Um arquivo include não está visível no documento de saída até que todos os campos sejam atualizados. Para atualizar os campos, use o recurso Atualizar campos no Microsoft Word ou use as macros que estão contidas na folha de estilo RPE_HOME\utils\word\rpe.dot.
    Dica: Um documento do Microsoft Word que se vincula a outros arquivos não é autocontido. Mover o documento em outros computadores o impede de visualizar o conteúdo dos documentos vinculados. Se a visualização for necessária, use o recurso Separar links no Microsoft Word para incluir o conteúdo de um arquivo vinculado.

Procedimento

  1. Na visualização Paleta, selecione um elemento ícone Incluir arquivo Incluir arquivo e arraste-o para o editor de conteúdo do modelo. A janela Selecionar um arquivo é aberta.
  2. Selecione um arquivo .doc, .docx, .txt ou .rtf para incluir:
    • Em uma localização local ou remota:
      1. Selecione a guia Abrir local ou remoto.
      2. Clique em Pesquisar.
      3. Selecione um arquivo.
    Dica: Se você sempre usa a mesma guia para escolher um arquivo, selecione a opção Padrão para esta visualização ao trabalhar com arquivos. Em seguida a janela Selecionar um arquivo sempre abre nesta guia.
  3. Clique em OK.
  4. Selecione o elemento de arquivo include no editor de conteúdo do modelo.
  5. Na visualização Propriedades, selecione a guia Específico.
  6. No campo Tipo de inclusão, selecione Integrando fisicamente para importar o documento no relatório durante a geração de documento.
  7. Opcional: No campo Comando, digite um comando que deve ser emitido durante a geração de documento.
  8. Clique no ícone Salvar para salvar suas mudanças.

Referindo dinamicamente arquivos

Antes de Iniciar

Importante: Use a integração fisicamente em vez de fazer a referência dinamicamente quando:
  • Um modelo ou fragmento é projetado para extrair informações de uma origem de dados.
  • Um modelo ou fragmento contém uma referência dinâmica.

Sobre Esta Tarefa

Quando você estiver selecionando arquivos e fazendo referência dinamicamente a eles:
  • Para saída do Microsoft Word, Rational Publishing Engine atualiza campos do Microsoft Word automaticamente durante a geração do documento. Se um campo INCLUDE TEXT for gerado, a macro não terá sido executada e a tarefa de importação do arquivo será delegado para Microsoft Word. Um arquivo include não está visível no documento de saída até que todos os campos sejam atualizados. Para atualizar os campos, use a propriedade Atualizar campos na especificação do documento, recurso Atualizar campos no Microsoft Word ou as macros que estão contidas na folha de estilo RPE_HOME\utils\word\rpe.dot.
    Importante:
    • Não use a propriedade Atualizar campos quando estiver gerando documentos excepcionalmente grandes. Documentos grandes podem não ser gerados com a propriedade configurada e resultariam em um erro de falta de memória.
    • Não execute uma macro para atualizar os campos se você estiver fazendo referência a documentos de um local seguro. O processo de autenticação não pode ser concluído e faz com que a macro seja interrompida.

Procedimento

  1. Na visualização Paleta, selecione um elemento ícone Incluir arquivo Incluir arquivo e arraste-o para o editor de conteúdo do modelo. A janela Selecionar um arquivo é aberta.
  2. Selecione um arquivo .doc, .docx, .txt ou .rtf para incluir:
    • Em uma localização local ou remota:
      1. Selecione a guia Abrir local ou remoto.
      2. Clique em Pesquisar.
      3. Selecione um arquivo.
    Dica: Se você sempre usa a mesma guia para escolher um arquivo, selecione a opção Padrão para esta visualização ao trabalhar com arquivos. Em seguida a janela Selecionar um arquivo sempre abre nesta guia.
  3. Clique em OK.
  4. Selecione o elemento de arquivo include no editor de conteúdo do modelo.
  5. Na visualização Propriedades, selecione a guia Específico.
  6. No campo Tipo de inclusão, selecione Link dinâmico para criar um link para o documento em seu local atual.
  7. Opcional: No campo Comando, digite um comando que deve ser emitido durante a geração de documento.
  8. Clique no ícone Salvar para salvar suas mudanças.