Fusionner des PDF

Assemble plusieurs PDF de l’exécution en un seul, dans l’ordre des pièces jointes : un dossier complet à joindre en une pièce.

Fusionner des PDF assemble plusieurs PDF de l’exécution en un seul, dans l’ordre des pièces jointes : les pièces du mail d’abord, puis les fichiers ajoutés par les étapes. C’est le nœud qui fait d’un compromis, de ses annexes et d’une attestation générée UN dossier à joindre.

Le nœud n’est proposé que si l’instance a un service de documents.

En bref

• Type : pdf.merge · version 1
• Catégorie : Données
• Nature : Étape — s’exécute pendant une exécution
• Effet : Sans effet externe (none) — rien n’est écrit hors de Loop & Roll ; rejouable sans risque
• Exige un mail porteur : Non
• Connexion : Aucune
• Entrées : main
• Sorties : main

Les ports de « Fusionner des PDF » : ce qui entre à gauche, ce qui sort à droite

Paramètres

selection

Pièces jointes retenues

• Type : Un choix (options)
• Requis : Oui
• Défaut : all
• Options :
  • all — Toutes les pièces jointes : Celles du mail déclencheur, puis les fichiers ajoutés par les étapes précédentes (un acte rapatrié, un PDF signé), dans cet ordre.
  • first — La première seulement : La première PJ, quand on sait qu’il n’y en a qu’une qui compte.
  • byMime — Par type de fichier : Par type MIME : application/pdf, ou toute une famille avec image/*.
  • byName — Par nom de fichier : Par motif sur le nom : *.pdf, facture-*.

mime

Type de fichier — Type MIME exact (application/pdf) ou famille entière (image/*). Laissé vide, aucune PJ n’est retenue.

• Type : Texte (string)
• Requis : Non
• Défaut : "" (vide)
• 200 caractères au plus
• Exemple : application/pdf
• Affiché quand : selection vaut byMime
• Expressions : {{ }} accepté

namePattern

Nom du fichier — Motif simple : * remplace n’importe quoi, ? un caractère (*.pdf, facture-*). La casse est ignorée.

• Type : Texte (string)
• Requis : Non
• Défaut : "" (vide)
• 200 caractères au plus
• Exemple : *.pdf
• Affiché quand : selection vaut byName
• Expressions : {{ }} accepté

filename

Nom du fichier produit — Sans extension. Peut contenir des champs : dossier-{{ data.extraire.reference }}.

• Type : Texte (string)
• Requis : Non
• Défaut : "" (vide)
• 300 caractères au plus
• Exemple : dossier
• Expressions : {{ }} accepté

Sorties

• main

Données produites

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

• {{ data.<step>.position }} — number. La position du PDF fusionné dans les pièces de l’exécution.
• {{ data.<step>.file }} — { position, filename, mime, size, origin }. Le PDF fusionné, ajouté aux pièces jointes de l’exécution.
• {{ data.<step>.pages }} — number. Le nombre de pages du PDF fusionné.
• {{ data.<step>.sources }} — array of { position, filename, mime, size, origin }. Les PDF assemblés, dans l’ordre.
• {{ data.<step>.summary }} — string. Une phrase pour le détail d’exécution, dans la langue du membre.

Exemple

selection: byName
namePattern: "*.pdf"
filename: "dossier-{{ data.extraire.reference }}"

Conseils

• Deux PDF au moins, vingt au plus. Avec un seul PDF retenu, l’étape échoue en node_nothing_to_do.
• Les PDF protégés par mot de passe sont refusés (document.invalid_document). Les signets et les métadonnées des PDF d’origine ne sont pas repris.
• Le nom du fichier est donné sans extension.