Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Inserindo Documentos - Guia de Incorporação de Documentos

PDF4meO mecanismo de geração de documentos do [nome da plataforma] permite inserir documentos completos dentro de outros documentos durante o processo de geração. Essa poderosa funcionalidade possibilita combinar múltiplos documentos, incorporar modelos dentro de modelos e criar documentos complexos com várias seções de forma dinâmica.

Sintaxe de Inserção de Documentos​

Insira um documento completo usando Base64Conteúdo do documento codificado:

<<doc [token]>>

O doc A palavra-chave instrui o mecanismo de modelos a inserir todo o conteúdo do documento no local especificado.

Inserção básica de documentos​

Incorporação simples de documentos​

Sintaxe do modelo:

<<doc [document]>>

Requisitos de dados: O documento deve ser fornecido como um Base64-string codificada em sua fonte de dados.

Exemplo de dados:

{
  "document": "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"
}

Esse Base64 A string representa um completo Word documento que será inserido no local do campo de mesclagem.

Controles de Inserção de Documentos​

PDF4me Fornece opções de controle para personalizar a forma como os documentos inseridos são processados e formatados.

Preservação de estilos de origem​

Sintaxe: <<doc [document] -sourceStyles>>

Comportamento:

  • Substitui a formatação do modelo pai.
  • Preserva a formatação original do documento inserido.
  • Mantém os estilos, fontes e cores do documento original.
  • A formatação do documento de origem tem precedência.

Caso de uso: Ao inserir um documento, o estilo visual deve ser preservado exatamente como foi projetado.

Exemplo:

Main Document Content...

<<doc [contractDocument] -sourceStyles>>

Continuation of Main Document...

Construção de Modelos Recursivos​

Sintaxe: <<doc [document] -build>>

Comportamento:

  • Trata o documento inserido como um modelo.
  • Os processos mesclam campos dentro do documento inserido.
  • Aplica dados à estrutura de modelo aninhada
  • Permite a composição de modelos em vários níveis.

Caso de uso: Quando o próprio documento inserido contém campos de mesclagem que precisam ser preenchidos.

Exemplo:

Parent Template:
<<doc [childTemplate] -build>>

Se childTemplate contém <<[employeeName]>>, será preenchido com dados da mesma fonte de dados.

Combinando interruptores de controle​

Ambos os interruptores de controle podem ser usados em conjunto para máxima flexibilidade:

Sintaxe: <<doc [document] -sourceStyles -build>>

Essa combinação:

  1. Preserva a formatação do documento original
  2. Processa campos de mesclagem aninhados
  3. Aplica dados ao modelo incorporado.

Aplicações práticas​

Exemplo 1: Inserção dos Termos e Condições​

Modelo principal:

Invoice #<<[invoiceNumber]>>
Date: <<[invoiceDate]:"dd.MM.yyyy">>

Items:
<<foreach [item in lineItems]>>
• <<[item.name]>> - $<<[item.price]>>
<</foreach>>

Total: $<<[total]>>

Terms and Conditions:
<<doc [termsDocument]>>

Caso de uso: Os termos e condições padrão estão armazenados em um documento separado e são inseridos em todas as faturas.

Exemplo 2: Seções específicas do departamento​

Modelo principal:

Company Report - <<[reportDate]:"MMMM yyyy">>

Executive Summary:
<<[executiveSummary]>>

Department Reports:
<<foreach [dept in departments]>>
Department: <<[dept.name]>>
<<doc [dept.reportDocument] -sourceStyles>>
<</foreach>>

Caso de uso: Cada departamento fornece seu próprio documento de relatório formatado, que é compilado em um relatório principal.

Exemplo 3: Montagem de Modelo Recursiva​

Modelo principal:

Customer: <<[customerName]>>
Order Date: <<[orderDate]:"dd.MM.yyyy">>

Order Details:
<<doc [orderTemplate] -build>>

Shipping Information:
<<doc [shippingTemplate] -build>>

Modelos filhos: Ambos orderTemplate e shippingTemplate Contêm seus próprios campos de mesclagem que serão preenchidos a partir da fonte de dados principal.

Montagem de múltiplos documentos​

Combine vários documentos em um único resultado gerado.

Inserção Sequencial de Documentos​

Modelo:

<<doc [document1]>>

<<doc [document2]>>

<<doc [document3]>>

Cada documento é inserido em sequência, criando um documento combinado com várias seções.

Inserção Condicional de Documentos​

Modelo:

Main Content...

<<if [includeAppendixA]>>
Appendix A:
<<doc [appendixADocument]>>
<</if>>

<<if [includeAppendixB]>>
Appendix B:
<<doc [appendixBDocument]>>
<</if>>

Considerações sobre o formato do documento​

Formatos de documento suportados​

Os documentos inseridos devem ser:

  • Word documentos (Formato .docx preferencial)
  • Codificado corretamente como Base64 cordas
  • Documentos válidos que pode ser aberto independentemente
  • Compatível com o formato de modelo pai

Codificação de documentos para Base64​

Para preparar os documentos para inserção:

  1. Leia o arquivo do documento como dados binários
  2. Codificar para Base64 usando ferramentas de codificação apropriadas
  3. Incluir na fonte de dados como valor de string
  4. Verificar codificação está completo e válido

Exemplo de estrutura de dados​

Fonte de dados completa​

JSON Estrutura:

{
  "contractNumber": "CNT-2024-001",
  "clientName": "Acme Corporation",
  "contractDate": "2024/01/15",
  "mainTermsDocument": "UEsDBBQABgAIAAAAIQ...[Base64 encoded .docx]",
  "appendixDocument": "UEsDBBQABgAIAAAAIQ...[Base64 encoded .docx]",
  "includeAppendix": true
}

Modelo:

Contract #<<[contractNumber]>>
Client: <<[clientName]:caps>>
Date: <<[contractDate]:"MMMM dd, yyyy">>

Main Terms:
<<doc [mainTermsDocument] -sourceStyles>>

<<if [includeAppendix]>>
Appendix:
<<doc [appendixDocument] -sourceStyles>>
<</if>>

Melhores práticas​

Diretrizes para Inserção de Documentos​

  1. Validar documentos - Certifique-se de que os documentos inseridos sejam válidos antes da codificação.
  2. Teste de forma independente - Verifique se cada documento abre corretamente antes de inseri-lo.
  3. Tamanho adequado - Mantenha os documentos inseridos em um tamanho razoável.
  4. Formatação consistente - Manter a consistência da formatação em todos os documentos.
  5. Controle de versão - Rastrear versões de documentos inseridos

Otimização de desempenho​

  1. Limitar inserções - Minimizar o número de inserções de documentos por modelo
  2. Tamanho do documento - Mantenha os documentos inseridos o menor possível.
  3. Evite ninhos muito profundos. - Limitar a profundidade do modelo recursivo
  4. Pré-processar quando possível - Combine os documentos antes do processamento do modelo, se possível.

Gestão de Dados​

  1. Codificação segura - Garantir Base64 A codificação é segura e precisa.
  2. Eficiência de armazenamento - Considere as implicações de armazenamento de Base64 cordas
  3. Armazenamento em cache - Armazene em cache os documentos usados com frequência para reduzir a sobrecarga de codificação.
  4. Tratamento de erros - Implementar medidas alternativas para documentos ausentes ou inválidos.

Solução de problemas​

Problemas comuns​

Emitir: O documento inserido não aparece.
Solução: Verificar Base64 A codificação está completa e válida.

Emitir: A formatação foi perdida no documento inserido.
Solução: Usar -sourceStyles Alternar para preservar a formatação

Emitir: Os campos de mesclagem no documento inserido não foram preenchidos.
Solução: Usar -build Alternar para processar modelos aninhados

Emitir: Tamanho de arquivo grande no documento gerado
Solução: Otimize os documentos inseridos antes da codificação.

Emitir: Posicionamento incorreto do conteúdo inserido
Solução: Verifique a estrutura e o posicionamento do modelo. <<doc>> sintaxe

Cenários Avançados​

Cenário 1: Documentos Multilíngues​

Insira seções de documentos específicas para cada idioma com base nas preferências do usuário:

Modelo:

<<if [language == "English"]>>
<<doc [termsEnglish] -sourceStyles>>
<<elseif [language == "Spanish"]>>
<<doc [termsSpanish] -sourceStyles>>
<<else>>
<<doc [termsDefault] -sourceStyles>>
<</if>>

Cenário 2: Montagem Modular de Documentos​

Crie documentos complexos a partir de componentes menores e reutilizáveis:

Modelo:

<<doc [headerDocument]>>

<<foreach [section in sections]>>
<<doc [section.documentContent] -sourceStyles -build>>
<</foreach>>

<<doc [footerDocument]>>

Cenário 3: Herança de Modelos​

Crie modelos básicos com seções especializadas inseridas:

Modelo base:

Company Letterhead
<<[date]:"MMMM dd, yyyy">>

<<doc [bodyContent] -build>>

Standard Footer
<<doc [disclaimerDocument]>>

:::dica Preparação de Documentos Prepare e teste cuidadosamente os documentos inseridos antes de codificá-los. Base64Certifique-se de que sejam exibidos corretamente quando abertos individualmente antes de incorporá-los aos modelos. :::

:::aviso Impacto no desempenho A inserção de vários documentos grandes pode afetar significativamente o desempenho da geração. Use a inserção de documentos com cautela e considere abordagens alternativas para documentos muito grandes ou numerosos.

:::