Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Word Sintaxis de plantillas - Guía de campos de combinación

La generación de documentos mediante la combinación de correspondencia consiste en leer datos de una fuente y reemplazar las variables correspondientes en una plantilla de documento. Este método agiliza la creación de documentos personalizados a gran escala, combinando contenido fijo con datos dinámicos.

Comprender las plantillas de combinación de correspondencia​

Un proceso típico de combinación de correspondencia requiere dos componentes esenciales:

  1. Documento plantilla - Contiene campos de combinación (variables) que serán reemplazados con datos reales.
  2. Fuente de datos - Contiene tanto las instrucciones de formato como la información que permanece idéntica en todos los documentos generados.

PDF4me admite múltiples formatos de plantilla, incluidos Word, HTML, y PDF documentos, lo que proporciona flexibilidad en la forma en que crea y estructura sus plantillas de documentos.

Sintaxis básica de campos de combinación​

Para crear campos de combinación en su Word Para usar plantillas, utilice la siguiente sintaxis:

<<[FieldName]>>

Esta sintaxis define marcadores de posición en su plantilla que serán reemplazados con datos reales durante el proceso de generación del documento.

Creación manual de campos de combinación​

Puede insertar manualmente campos de combinación directamente en su Word Documente el documento escribiendo la sintaxis que se muestra arriba. El nombre del campo debe coincidir con la propiedad correspondiente en su fuente de datos.

campo de fusión manual

Ejemplo de uso​

Plantilla:

Dear <<[CustomerName]>>,

Thank you for your order #<<[OrderNumber]>>.

Fuente de datos (JSON):

{
  "CustomerName": "John Smith",
  "OrderNumber": "12345"
}

Salida generada:

Dear John Smith,

Thank you for your order #12345.

Mejores prácticas para el diseño de plantillas​

Convenciones para nombrar campos​

  • Utilice nombres de campo descriptivos y significativos.
  • Siga patrones de nomenclatura consistentes (por ejemplo, camelCase o PascalCase).
  • Evite usar caracteres especiales en los nombres de los campos.
  • Mantenga los nombres de los campos concisos pero claros.

Organización de plantillas​

  • Estructura tu plantilla de forma lógica antes de añadir campos de combinación.
  • Aplicar formato a los campos de combinación en la propia plantilla.
  • Pruebe las plantillas con datos de muestra antes de usarlas en producción.
  • Mantener versiones de plantillas para diferentes tipos de documentos.

Formatos de plantilla compatibles​

PDF4me Acepta los siguientes formatos de plantilla para la generación de documentos:

  • Word Documentos (.docx, .doc) - Compatibilidad total con Word sintaxis de plantillas
  • HTML Plantillas (.html) - Estructuras de plantillas basadas en la web
  • PDF Plantillas (.pdf) - Basado en formularios PDF plantillas

Cada formato admite la misma sintaxis de campos de combinación, lo que garantiza la coherencia entre los diferentes tipos de plantillas.

Próximos pasos​

Ahora que comprende la sintaxis básica, explore las funciones avanzadas de las plantillas:

Recursos relacionados​

Document Generation APIGet Started with PDF4me
Creación de plantillas avanzadas

Para obtener instrucciones detalladas sobre cómo crear plantillas sofisticadas Word Para plantillas con funciones avanzadas, consulte nuestra documentación completa sobre plantillas en las siguientes secciones.