Découper un PDF

Extrait des pages d’un PDF — des plages (1-3, 5) ou chaque page séparément — en nouveaux fichiers ajoutés aux pièces jointes de l’exécution.

Découper un PDF extrait des pages d’un PDF en nouveaux fichiers, ajoutés aux pièces jointes de l’exécution : des plages (1-3, 5, 8-10, un fichier par plage) ou chaque page séparément. Par défaut, c’est le premier PDF de l’exécution qui est découpé.

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

En bref

• Type : pdf.split · 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 « Découper un PDF » : ce qui entre à gauche, ce qui sort à droite

Paramètres

selection

Pièces jointes retenues

• Type : Un choix (options)
• Requis : Oui
• Défaut : first
• 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é

mode

Découpe

• Type : Un choix (options)
• Requis : Oui
• Défaut : ranges
• Options :
  • ranges — Par plages de pages : Un fichier par plage : 1-3, 4, 5-8.
  • each — Une page par fichier : Chaque page devient un fichier (100 au plus).

ranges

Pages — Des plages séparées par des virgules. Une page hors du document fait échouer l’étape.

• Type : Texte (string)
• Requis : Oui
• Défaut : "" (vide)
• 500 caractères au plus
• Exemple : 1-3, 5
• Affiché quand : mode vaut ranges
• 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>.files }} — array of { position, filename, mime, size, origin }. Les fichiers produits (acte-p1-3.pdf, acte-p4.pdf…), ajoutés aux pièces jointes de l’exécution. La liste à parcourir avec une boucle.
• {{ data.<step>.count }} — number. Le nombre de fichiers produits.
• {{ data.<step>.documents }} — array of { source, files, pages }. Pour chaque PDF découpé : la pièce d’origine, ses fichiers et son nombre de pages.
• {{ data.<step>.summary }} — string. Une phrase pour le détail d’exécution, dans la langue du membre.

Exemple

Un scanner envoie un lot de bulletins dans un seul PDF, une page par bulletin :

selection: first
mode: each

Puis une boucle sur {{ data.<step>.files }} qui lit et range chaque page.

Conseils

• Une page hors du document fait échouer l’étape (document.invalid_document) : vérifiez le nombre de pages avec Lire les pièces jointes si les documents varient.
• Une page par fichier : 100 fichiers au plus. Plages : 50 au plus.
• Au plus 5 PDF découpés par étape.