Saltar al contenido principal
PDF4me APIIntegracionesBase de conocimientosExtensionesProbador de APIBlog

Lista de documentos de combinación de correspondencia en Make

Combinación de correspondencia con lista de documentos en formato de cadena de datos es un Make módulo por PDF4me que fusiona una palabra o PDF plantilla con un JSON Matriz de registros, generando un documento personalizado por cada objeto de la matriz. Úselo para contratos, facturas o certificados en lote. La salida se entrega como un archivo zip de archivos individuales o un único archivo combinado. PDF.

:::advertencia Módulo obsoleto Este módulo pronto quedará obsoleto. Migre a Generar documentos múltiples Para la generación de documentos por lotes con mejor rendimiento, gestión de memoria optimizada para grandes conjuntos de datos y funciones ampliadas.

:::

Entradas de blog relacionadas
Aún no hay ninguna entrada de blog sobre esta función; estará disponible próximamente.
Mientras tanto, echa un vistazo al blog de PDF4me para encontrar tutoriales y flujos de trabajo para todas las plataformas.
Visita el blog →

Autenticando su API Pedido​

Cada PDF4me módulo en Make requiere una conexión válida. Cree o seleccione una que contenga su PDF4me API clave para que el escenario pueda autenticar de forma segura las solicitudes de generación de documentos por lotes.

Get your API Key

Datos importantes que no debes perderte​

Este módulo está obsoleto.
Para nuevos escenarios utilice Generar documentos múltiplesOfrece un mejor rendimiento, una gestión de memoria mejorada para grandes conjuntos de datos y opciones de formato ampliadas.
Uno JSON objeto equivale a un documento
Los datos de fusión deben ser válidos. JSON matriz. Cada objeto en la matriz genera un documento, y sus nombres de clave deben coincidir exactamente con los nombres de los marcadores de posición de combinación de correspondencia en su Word o PDF plantilla.
Dos modos de salida: combinados PDF o cremallera
Establezca el archivo de salida de fusión en Sí para un único PDF Contiene todos los documentos en secuencia. Seleccione No, la opción predeterminada, para un archivo zip con un archivo por registro; luego, extráigalo con el módulo Archive.
Paso de generación de documentos PDF4me en Crear con el menú desplegable Tipo de archivo de plantilla configurado en Combinación de correspondencia

Establezca el tipo de archivo de plantilla en Combinación de correspondencia para que PDF4me fusiona cada uno JSON registre la información en los campos de marcador de posición de su plantilla.

¿Qué es la lista de documentos de combinación de correspondencia? Make¿​

La lista de documentos para combinar correspondencia es Make's PDF4me Módulo para generar varios documentos a la vez a partir de una sola plantilla. Acepta un archivo de plantilla y un JSON Este módulo procesa una serie de registros y devuelve un documento combinado por cada registro. A diferencia de la combinación manual de registros en Word, este módulo se adapta a cientos de documentos en un escenario automatizado sin necesidad de pasos manuales.

Parámetros​

ParámetroRequeridoLo que haceEjemplo
ConnectionRequiredPDF4me connection holding your API key. Click Add and paste your key from dev.pdf4me.com/dashboard if connecting for the first time.My PDF4me connection
FileRequiredBinary content of the Word or PDF template. Map it from a preceding download module such as Dropbox Download a File.1. Data
Merge DataRequiredJSON array of data records. Each object generates one document, and its key names must exactly match the placeholder names in the template.[{"Name":"John","Co":"Acme"}]
Merge Output FileOptionalControls the output format. Yes gives a single combined PDF of all documents. No, the default, gives a zip archive with one file per record.No

Producción​

CampoTipoLo que contiene
Doc DataBufferThe generated output as a binary buffer. A zip archive of individual files when Merge Output File is No, or a single combined PDF when it is Yes.
File NameStringName of the output file, either a zip or a pdf. Map it into the File Name field of a downstream upload or email module.

¿Cómo funciona la generación de documentos por lotes en? Make¿​

El módulo lee su plantilla una vez, luego recorre la matriz de datos de fusión y sustituye cada registro en los marcadores de posición de la plantilla para producir un documento. Cuando el archivo de salida de fusión es No, comprime los documentos en un archivo zip; cuando es Sí, los concatena en uno. PDFLa combinación de correspondencia es una función de larga data de Microsoft Word, documentada en el Centro de ayuda de Microsoft OfficePara conocer los patrones de creación de escenarios, consulte el Make centro de ayuda.

Configuraciones típicas​

Certificados para la lista de participantes de un evento
  1. Consulta una lista de contactos desde Google Sheets con el módulo Buscar filas.
  2. Agrupe las filas en una JSON matriz con el Agregador de matrices.
  3. Pasa la plantilla a Archivo y la matriz a Combinar datos.
  4. Establezca el archivo de salida de fusión en Sí para uno combinado. PDF, luego envíalo por correo electrónico.
Facturas por lotes como archivos individuales
  1. Recopile los registros de facturas desde una fuente de Airtable o Sheets.
  2. Construir el JSON matriz para que cada objeto coincida con los marcadores de posición de la plantilla.
  3. Deje la opción "Combinar archivo de salida" en "No" para obtener un archivo zip de uno. PDF por registro.
  4. Añade el módulo de archivo para descomprimir y, a continuación, sube cada archivo a Drive.
Cartas personalizadas desde un webhook
  1. Activar mediante un webhook personalizado que devuelva una matriz de registros.
  2. Descarga la plantilla de carta desde el almacenamiento en la nube.
  3. Ejecute la función de combinación de correspondencia para generar los documentos combinados.
  4. Entregue el código postal o combinado PDF al destino.

Consejos prácticos​

Este módulo está obsoleto.
Para nuevos escenarios, utilice la opción Generar documentos múltiples, que ofrece una mejor gestión de la memoria y compatibilidad con formatos. Los escenarios existentes seguirán funcionando.
Las claves deben coincidir exactamente con los marcadores de posición.
JSON Los nombres de las claves deben coincidir con los nombres de los marcadores de posición de la plantilla, y se respeta el uso de mayúsculas y minúsculas. Una clave llamada "company" no ocupará el espacio reservado para la empresa.
Sí o No cambia el tipo de salida
La opción "Combinar archivo de salida" establecida en "Sí" devuelve un único archivo combinado. PDFNo, por defecto, devuelve un archivo zip con archivos individuales.
Descomprimir para reproducir archivos individuales en bucle
Con No, agregue el módulo Archive y luego un Iterador para cargar o enviar por correo electrónico cada archivo generado por separado.
Válido JSON Se requiere una matriz
Los datos de fusión deben ser un JSON Matriz de objetos. Valídela antes de ejecutarla para que el módulo no devuelva una salida vacía.

Hoja de trucos​

CampoValor
ModulePDF4me > Mail Merge With Data String List of Docs
StatusDeprecated (prefer Generate Documents Multiple)
ConnectionYour PDF4me connection
File1. Data (template binary)
Merge Data[{"Name":"John","Co":"Acme"}]
Merge Output FileNo (zip) or Yes (combined PDF)
OutputDoc Data + File Name
Credits1 per document generated

Preguntas frecuentes​

¿Cómo combino una lista de documentos en una correspondencia? Make¿+
Añade el PDF4me Combinar correspondencia con lista de documentos de cadena de datos, asignar un documento de Word o PDF plantilla a Archivo, pasar un JSON matriz para fusionar datos, luego ejecute el escenario. El módulo produce un documento por objeto de matriz, entregado como un archivo zip o un único combinado. PDF dependiendo de la configuración del archivo de salida de combinación.
¿En qué formato deben estar los datos de fusión? JSON ¿Uso de matrices?+
Los datos de fusión deben ser un JSON Matriz de objetos. Cada objeto contiene los valores de los campos de un registro, y sus nombres de clave deben coincidir exactamente con los nombres de los marcadores de posición de combinación de correspondencia en su plantilla. Se distingue entre mayúsculas y minúsculas, por lo que un marcador de posición llamado "Company" no recibirá un valor de una clave llamada "company".
¿Cómo puedo obtener archivos individuales en lugar de uno combinado? PDF¿+
Deje la opción "Archivo de salida de fusión" configurada en "No" para que el módulo devuelva un archivo zip con un archivo por registro. Agregar Make Módulo de archivo integrado para extraer el zip, luego utilice un Iterador para recorrer los archivos y subirlos, enviarlos por correo electrónico o convertirlos individualmente.
¿Es este el módulo recomendado para la generación de documentos por lotes?+
No. Este módulo está obsoleto. Para nuevos escenarios, utilice Generar documentos múltiples, que proporciona un procesamiento por lotes mejorado y una mejor gestión de la memoria para grandes volúmenes de datos. JSON Matrices, compatibilidad con formatos ampliada y manejo de errores mejorado. Los escenarios existentes seguirán funcionando, pero las nuevas compilaciones deben estar orientadas a la nueva versión.

Acciones relacionadas​

La misma tarea en otras plataformas​

Obtén ayuda​

Make IntegrationGet your API KeyMake Documentation