Generar documento usando plantilla en Make

Generar documento usando plantilla es un módulo de PDF4me para Make que fusiona una plantilla guardada de su repositorio de PDF4me con JSON, XML o CSV procesa los datos y devuelve un documento finalizado. Seleccione la plantilla por nombre, introduzca sus datos directamente o como un archivo, y genere facturas, contratos y cartas sin necesidad de cargar un archivo de plantilla en cada ejecución.

Lo que hace este módulo

PDF4me Generar documento usando plantilla Genera un documento combinando una plantilla almacenada en tu repositorio de PDF4me con los datos que proporcionas en formato JSON, XML o CSV. A diferencia de los módulos de generación basados en archivos, seleccionas la plantilla por nombre desde un menú desplegable; no se requiere cargar ni asignar plantillas. Proporciona datos en línea mediante Texto de los datos del documento o como un archivo mapeado a través de Archivo de datos del documento, agregue formato de campo opcional con Metadatos JSONy canalizar el documento generado a Cargar archivo, Enviar correo electrónico o cualquier módulo Make posterior.

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 solicitud de API

Cada módulo PDF4me en Make requiere un archivo válido. ConexiónCree o seleccione una que contenga su clave API de PDF4me para que el escenario pueda autenticar de forma segura las solicitudes de generación de documentos.

Get your API Key

Datos importantes que no debes perderte

El nombre de la plantilla es una plantilla de repositorio, no un archivo.

El Nombre de la plantilla Plantillas de listas desplegables guardadas en su repositorio de PDF4me. Seleccione una plantilla almacenada por nombre en lugar de cargar o asignar un archivo de plantilla. Utilice la haga clic aquí Haz clic en el enlace que aparece junto al campo para abrir el repositorio y crear o editar una plantilla.

Admite datos JSON, XML y CSV.

Colocar Tipo de datos del documento Se puede convertir a JSON para objetos o matrices, XML para documentos XML o CSV para filas separadas por comas. El formato elegido se aplica a la fuente que se utilice: texto de datos del documento o archivo de datos del documento.

Proporcione texto de datos o un archivo de datos.

Proporcione sus datos de una de dos maneras: péguelos o insértelos en línea. Texto de los datos del documento (bueno para campos de CRM y cargas útiles pequeñas), o mapear un archivo de datos binarios en Archivo de datos del documento (Ideal para datos de gran tamaño o mantenidos externamente). No necesitas ambos.

Seleccione una plantilla guardada en Nombre de la plantilla, colocar Tipo de datos del documentoy suministrar datos a través de Texto de los datos del documento o Archivo de datos del documentoLos campos obligatorios están marcados con un asterisco rojo.

¿De dónde provienen las plantillas?

El Nombre de la plantilla El menú desplegable se rellena desde el Documento ejemplar Área del panel de control de PDF4me. Las plantillas se encuentran en tu cuenta, no en el escenario de creación, por lo que creas una una vez y la reutilizas en todos los escenarios, flujos y llamadas a la API.

Plantilla de documento abierto

Cada plantilla que guardes aquí aparecerá en la Nombre de la plantilla menú desplegable en Hacer. Haga clic Agregar para crear una nueva, o el icono del lápiz para editar una plantilla existente.

Cada fila de esta tabla se corresponde con una entrada en el menú desplegable "Marca":

Columna	Qué significa en Make
Nombre de la plantilla	El texto exacto que seleccione en Nombre de la plantillaAsigne nombres distintos a las plantillas para que el menú desplegable siga siendo legible a gran escala.
Tipo de plantilla	El formato de origen en el que creó la plantilla, por ejemplo PDF Form, HTML, o PDF4me WordEsto está fijo en la plantilla, por lo que Make nunca te lo pedirá.
Tipo de archivo de salida	El formato en el que se devuelve el documento generado, por ejemplo PDF o HTML.
Comportamiento	Edita o elimina la plantilla. Cambiar el nombre de una plantilla modifica el valor que se muestra en el menú desplegable "Crear", así que actualiza cualquier escenario que hiciera referencia al nombre anterior.

Por eso el módulo no tiene un campo Tipo de salida. Tanto el formato de la plantilla como el formato de salida se deciden aquí, en la propia plantilla. Por eso. Generar documento usando plantilla Solo solicita un nombre de plantilla y sus datos. Si necesita el mismo contenido en un formato de salida diferente, guarde una segunda plantilla con un formato diferente. Tipo de archivo de salida.

:::precaución: Cambie el nombre con cuidado. El módulo almacena la plantilla. nombre, no un ID. Si cambia el nombre de una plantilla en el panel de control, cualquier escenario de Make que aún apunte al nombre anterior fallará hasta que lo vuelva a seleccionar. Utilice el Mapa activar Nombre de la plantillaSi necesita pasar el nombre dinámicamente. :::

¿Qué parámetros utiliza la función Generar documento usando plantilla en Make?

Requerido: Conexión, nombre de la plantilla y tipo de datos del documento. Condicional: Texto de datos del documento O archivo de datos del documento (uno de ellos debe contener la carga útil de datos). Opcional: Metadatos JSON. Para conocer los estándares de formato de datos, consulte RFC 4180 para CSV y el Especificación JSON oficial.

Parámetro	Requerido	Lo que hace	Ejemplo
Connection	Required	PDF4me connection for the scenario. Click Add to create one with your API key, or select an existing connection.	My PDF4me connection
Template name	Required	Document template chosen from your PDF4me repository. Pick a saved template from the dropdown. Use the click here link to open the repository and create a new template. Has a Map toggle for dynamic selection.	sample template
Document data type	Required	Format of the data payload. JSON for object/array, XML for XML documents, CSV for comma-separated rows. Has a Map toggle.	JSON
Document data text	Conditional	Map the fields from a CRM or prior steps as JSON, XML, or CSV text. Use this field when you are not uploading a data file.	{ "name": "John" }
Document data file	Conditional	Map a file containing the document data in JSON, XML, or CSV format. Use this instead of Document data text when the data comes from a download or upload module.	2. Data
Metadata JSON	No	Optional JSON that controls field formatting during the merge, for example date formats or checkbox and HTML field types. Leave empty for plain text substitution.	{"FieldsMetaData":[...]}

Producción

El módulo devuelve un paquete por ejecución que contiene el documento generado, listo para los módulos Make posteriores.

Campo	Tipo	Lo que contiene
Document	File (binary data)	Content (binary data) of the resulting generated document, returned on docData. Map it together with File Name into the next module, for example Upload a File or Send Email Attachment.
File Name	File name	File name of the resulting generated document, returned on name. Map it together with Document into the next module, for example to upload or email the file.

¿Cómo configuro la opción Generar documento usando una plantilla en Make?

1. Agregar PDF4me y seleccione Generar documento usando plantilla.
2. Seleccionar Conexión (o haga clic Agregar para crear uno con su clave API).
3. Abrir el Nombre de la plantilla Despliega el menú desplegable y elige una plantilla guardada de tu repositorio de PDF4me. Si la lista está vacía, crea una primero en Documento ejemplar en el panel de control o utilice el haga clic aquí Enlace junto al campo.
4. Colocar Tipo de datos del documento a Json, XML, o CSV para que coincida con sus datos.
5. Proporcione los datos: péguelos o márquelos en Texto de los datos del documentoo mapear un archivo de datos en Archivo de datos del documento.
6. Opcionalmente, agregue Metadatos JSON para formatear fechas, casillas de verificación o campos HTML.
7. Haga clic Ahorrar y ejecutar. Mapear el generado Datos del documento Enviar la salida a un módulo de Carga de archivos, Envío de correo electrónico o Archivo.

Ejemplos de flujo de trabajo

Ejemplos de flujo de trabajoCommon Make scenario patterns using Generate Document Using Template.

Generar una factura a partir de una plantilla guardada en el CRM

1. Un webhook de CRM se activa cuando se cierra un trato.
2. La opción Generar documento usando plantilla selecciona la plantilla de factura guardada y lee los campos de la transacción como JSON en el texto de datos del documento.
3. La factura generada se envía por correo electrónico al cliente y se almacena en el registro de la transacción.

Exportación CSV a cartas por lotes

1. Un activador programado descarga un archivo CSV exportado desde el almacenamiento en la nube.
2. El tipo de datos del documento está configurado como CSV y el archivo está asignado al archivo de datos del documento.
3. La plantilla de carta guardada se combina y cada documento generado se archiva en una carpeta fechada.

Contrato formateado con metadatos JSON

1. El envío de un formulario proporciona datos del contrato en formato JSON.
2. Los metadatos JSON establecen el campo de fecha efectiva en formato yyyyMMdd durante la fusión.
3. La plantilla de contrato guardada se genera y se envía para su firma electrónica.

Preguntas frecuentes

How is Template name different from the file-based generate modules?+

In Generate Document Using Template, Template name is a dropdown that lists the templates saved in your PDF4me repository. You select a stored template by name instead of uploading or mapping a template file, so no File Type or Output Type fields are needed. Create or edit templates from the PDF4me dashboard.

What data formats can I supply?+

Document data type accepts Json for an object or array, Xml for XML documents, or Csv for comma-separated rows. Choose the format that matches your source data, then supply it via Document data text or Document data file.

Should I use Document data text or Document data file?+

Provide one of the two. Use Document data text to paste or map data inline from a CRM or a prior module. Use Document data file to map a binary data file. The file option is best for larger or externally maintained payloads.

What is Metadata JSON used for?+

Metadata JSON is optional and controls how specific template fields are formatted during the merge, for example date formats or checkbox and HTML field types. Leave it empty for plain text substitution.

How do I create a template for this module?+

Create it in the Document Template area of the PDF4me dashboard at https://dev.pdf4me.com/dashboard/#/document-template/ . Click Add, choose the Template Type (PDF Form, HTML, or PDF4me Word) and the Output File Type, then save. The template then appears in the Template name dropdown in Make. The click here link next to the field opens the same page.

Acciones relacionadas

Generar documento único

Combina un archivo de plantilla de Word, HTML o PDF con datos. Úsalo cuando la plantilla provenga del almacenamiento en la nube en lugar del repositorio.

Generar documentos múltiples

Genera un documento por cada registro de una matriz de datos en una sola llamada. Útil para informes por lotes y envíos masivos.

Referencia de la API REST

Llame al mismo motor de generación de documentos directamente a través de la API REST de PDF4me desde código personalizado.

Obtén ayuda

Get Your API KeyPDF4me on MakeMake Integration Guide