Aller au contenu principal

Ajouter une pièce jointe à PDF dans n8n

Ajouter une pièce jointe à PDF est un PDF4me action de nœud dans n8n qui intègre un ou plusieurs fichiers dans un PDF, donc une feuille de calcul, une image, une archive ou une seconde PDF Il accompagne le document au lieu de le joindre à lui. Utilisez-le pour inclure des pièces justificatives dans un contrat, envoyer des données brutes avec un rapport ou joindre des certificats à un dossier de conformité.

Que fait ce nœud ?

PDF4me: Ajouter une pièce jointe à PDF prend un hôte PDF à partir de données binaires, un Base64 String, ou un URL, puis intègre chaque fichier que vous listez sous Pièces jointes à l'intérieur, en tant qu'objet distinct. Contrairement à la fusion, les fichiers joints conservent leur format et leur nom et peuvent être ouverts ou enregistrés individuellement par le destinataire. Chaque pièce jointe peut provenir d'une source différente ; ainsi, un fichier binaire provenant d'un nœud précédent et un fichier récupéré d'une autre source peuvent être concernés. URL peuvent être intégrés dans la même exécution.

Articles de blog connexes
Il n'y a pas encore d'article de blog consacré à cette fonctionnalité — à venir prochainement.
En attendant, n'hésitez pas à consulter le blog de PDF4me pour découvrir des tutoriels et des procédures de travail adaptés à toutes les plateformes.
Consultez le blog

Authentification de votre API Demande

Chaque PDF4me nœud dans n8n nécessite un numéro valide Identifiant pour se connecter avecCréez ou sélectionnez-en un qui contient votre PDF4me API clé permettant au flux de travail d'authentifier les demandes de pièces jointes de manière sécurisée.

Informations importantes à ne pas manquer

L'attachement ne fusionne pas
Un fichier joint reste un objet distinct que le lecteur peut enregistrer. La fusion, quant à elle, aplatit le contenu des pages en un seul document continu.
Les pièces jointes constituent une collection répétable
Cliquez Ajouter une pièce jointe une fois par fichier. Chaque entrée possède son propre type de contenu, son nom et sa source, ce qui permet de mélanger les formats binaire, base64 et URL sources en une seule exécution.
L'extension du fichier est importante.
Le nom de la pièce jointe indique à l'application de lecture comment ouvrir le fichier extrait ; veillez donc toujours à inclure l'extension correcte, telle que .xlsx ou .zip.
Le nœud PDF4me dans n8n est configuré sur l'action « Ajouter une pièce jointe au PDF », le type de données d'entrée est « Données binaires », le champ d'entrée est « data » (binaire), le nom du fichier de sortie est « document_with_attachments.pdf », le nom du document est « document.pdf », et la collection « Pièces jointes » est vide avec un bouton « Ajouter une pièce jointe ».

PDF4me Ajouter une pièce jointe à PDF panneau des paramètres dans n8n, la collection Pièces jointes étant vide avant l'ajout de la première entrée

Attacher vs Fusionner vs Fermeture éclair

Trois façons de livrer plusieurs fichiers comme un seul, avec des conséquences différentes pour le destinataire.

ApprocheCe que le destinataire reçoitMeilleure adaptation
Add Attachment to PDFOne PDF that opens normally, with the extra files available in the attachments panelSupporting material that must stay in its original format, such as a spreadsheet or an archive
Merge PDFsOne continuous document where all pages read in sequenceContent that genuinely belongs together as a single readable document
Zip the files togetherAn archive that must be unpacked before anything can be readBulk transfer where nothing needs to be readable without extracting first

Quels paramètres permettent d'ajouter une pièce jointe ? PDF Besoin?

Requis: Action, type de données d'entrée, champ correspondant à ce type d'entrée, nom du fichier de sortie, nom du document et au moins une entrée sous Pièces jointes. Le nom de sortie des données binaires et les profils personnalisés utilisent des valeurs par défaut fonctionnelles.

ParamètreRequisCe que cela faitExemple
ActionRequiredSelects the PDF4me node action to run. Choose Add Attachment To PDF.Add Attachment To PDF
Input Data TypeRequiredFormat of the host PDF input. Choose Binary Data (from a previous node), Base64 String, or URL.Binary Data
Input Binary FieldConditionalName of the binary property on the incoming n8n item that holds the host PDF. Required when Input Data Type is Binary Data. Defaults to data.data
Base64 Document ContentConditionalBase64-encoded content of the host PDF. Required when Input Data Type is Base64 String.JVBERi0xLjQK...
File URLConditionalPublicly reachable HTTPS URL to the host PDF. Required when Input Data Type is URL.https://example.com/contract.pdf
Output File NameRequiredFilename for the PDF returned with the files embedded. Include the .pdf extension.document_with_attachments.pdf
Document NameRequiredFilename of the source PDF, used for reference and tracking on the request.document.pdf
AttachmentsRequiredCollection of files to embed. Click Add Attachment once per file, then fill in the per-attachment fields listed below.One entry per embedded file
Binary Data Output NameOptionalName of the binary property the output item exposes. Defaults to data.data
Custom ProfilesOptionalAdvanced Options field for extra processing settings, supplied in a JSON-like format. Leave blank unless you have a specific profile to apply.{ "preserveMetadata": true }

Champs à l'intérieur de chaque entrée de pièce jointe

Chaque entrée que vous créez avec Ajouter une pièce jointe expose son propre ensemble de champs.

ParamètreRequisCe que cela faitExemple
Attachment Content TypeRequiredHow this particular attachment is supplied. Choose Binary Data, Base64 Content, or File URL. Each entry can differ.Binary Data
Attachment NameRequiredFilename the embedded file will carry inside the PDF. Include the correct extension so readers can open it after extraction.supporting_data.xlsx
Binary Field NameConditionalName of the binary property holding this attachment. Required when Attachment Content Type is Binary Data.data
Base64 ContentConditionalBase64-encoded content of this attachment. Required when Attachment Content Type is Base64 Content.SGVsbG8gV29ybGQ=
File URLConditionalPublicly reachable HTTPS URL to this attachment. Required when Attachment Content Type is File URL.https://example.com/certificate.pdf

Champs de sortie

Une course réussie rapporte un n8n l'objet portant PDF avec ses fichiers intégrés.

ChampTaperCe qu'il contient
Binary (data)BinaryThe PDF with all listed files embedded, under Binary Data Output Name (default data).
fileNameStringGenerated filename, matching Output File Name.
mimeTypeStringMIME type of the output, always application/pdf.
fileSizeNumberSize of the returned PDF in bytes, including the embedded files.
attachmentCountNumberNumber of attachments successfully embedded. Compare it against your expected count to catch a silently skipped file.
successBooleanTrue when the attachment operation completed, false on failure. Use it to branch error handling.
messageStringHuman-readable status message, carrying success confirmation or error detail.

Comment configurer l'ajout de pièces jointes à PDF dans n8n?

  1. Ajouter PDF4me à votre n8n flux de travail et choisissez le Ajouter une pièce jointe à PDF action.
  2. Dans Identifiant pour se connecter avec, sélectionnez votre PDF4me identifiant ou cliquez Créer un nouveau compte et collez votre API clé.
  3. Ensemble Type de données d'entrée à Données binaires (défaut), Base64 String, ou URL et fournir l'hôte correspondant PDF champ.
  4. Sous Pièces jointes, cliquez Ajouter une pièce jointe une fois pour chaque fichier, puis définissez son Type de contenu de pièce jointe, Nom de la pièce jointe, et le champ source correspondant.
  5. Ensemble Nom du fichier de sortie (doit se terminer par .pdf) et Nom du document pour le fichier source.
  6. Exécutez le nœud et acheminez le flux de retour. PDF en avant, en vérifiant attachmentCount par rapport au nombre de fichiers que vous attendiez.

Configurations typiques

Exemples de flux de travailCommon n8n workflow patterns using Add Attachment to PDF.
Facture avec justificatifs
  1. Une facture PDF est généré à partir des données de facturation.
  2. Ajouter une pièce jointe à PDF intègre les reçus correspondants et l'historique d'approbation.
  3. Un dossier contenant toutes les pièces justificatives est transmis au service comptabilité fournisseurs.
Rapport avec ses données sources
  1. Un rapport d'analyse programmé est généré. PDF.
  2. Ajouter une pièce jointe à PDF intègre le sous-jacent CSV exporter en tant que pièce jointe nommée.
  3. Les lecteurs prennent connaissance du récit et peuvent consulter les chiffres bruts lorsqu'ils souhaitent les vérifier.
Contrat avec annexes
  1. Un contrat est établi à partir d'un modèle sur demande de signature.
  2. Ajouter une pièce jointe à PDF intègre des certificats et des calendriers extraits de URLs.
  3. La contrepartie reçoit un document unique et autonome à signer.
Dossier de conformité pour l'audit
  1. Un nœud de boucle sur les éléments rassemble les dossiers de preuves pour une période d'archivage.
  2. Ajouter une pièce jointe à PDF intègre chacun d'eux dans le document de classement de couverture.
  3. Le paquet est archivé, et extraire la pièce jointe de PDF Nous pouvons le déballer plus tard sur demande.

Conseils pratiques

Always include the file extension in Attachment Name
The extension is what tells a reader application how to open the extracted file. A name without one leaves the recipient guessing.
Check attachmentCount against what you sent
Comparing the returned count to the number of entries you configured is the quickest way to catch a file that failed to embed.
Mention the attachments in the document body
Not every viewer surfaces the attachments panel, so a line of visible text telling the reader that supporting files are embedded prevents them being missed.
Mix sources freely within one run
Each entry has its own content type, so a binary file from an earlier node and a URL-hosted certificate can be embedded together.
Attach when format must survive, merge when it should not
A spreadsheet stays usable as a spreadsheet only if it is attached. Merging would flatten it into page content.
Watch the total size on outbound email
Embedded files count toward the PDF size, so a bundle of large attachments can push the document past a mail gateway limit.

Aide-mémoire

ChampValeur
ActionAdd Attachment To PDF
Input Data TypeBinary Data
Input Binary Fielddata
Output File Namedocument_with_attachments.pdf
Document Namedocument.pdf
AttachmentsOne entry per file, added with Add Attachment
Attachment Content TypeBinary Data
Attachment Namesupporting_data.xlsx
Binary Data Output Namedata
CredentialsPDF4me API credential

Questions fréquentes

What is the difference between attaching a file to a PDF and merging PDFs?+
Merging combines page content into one continuous document, so the source files stop existing as separate items. Attaching embeds a file inside the PDF as a discrete object that a reader can open or save back out on its own, keeping the original format intact. Use merge when everything should read as one document, and attach when a spreadsheet, archive, or certificate needs to stay a separate file.
Can I attach more than one file in a single run?+
Yes. Attachments is a collection, so click Add Attachment once per file you want to embed. Each entry gets its own Attachment Content Type, Attachment Name, and source field, which means you can mix a binary file from a previous node with another pulled from a URL in the same request.
What file types can be attached to a PDF?+
Attachments are stored as embedded file objects rather than being converted, a mechanism defined in the ISO 32000 PDF specification, so common document, image, spreadsheet, presentation, archive, and data formats can all be carried. What matters is that Attachment Name includes the correct extension, because that is what tells a reader application how to open the file once extracted.
Will everyone be able to see the attachments?+
Embedded files are exposed through the attachments or bookmarks panel of a full PDF reader. Lightweight in-browser or mobile viewers sometimes do not surface that panel, so if attachments are essential to the recipient, mention in the document body that supporting files are embedded.
How do I get the attachments back out of a PDF later?+
Use the Extract Attachment From PDF action, which is the inverse operation. A common pattern is one n8n workflow that bundles supporting files into an outgoing PDF, and a second that extracts them again when the document comes back.

Actions connexes

Même tâche sur d'autres plateformes

Obtenez de l'aide