Liest und bearbeitet PDF-Dateien: extrahiert Text, ermittelt Seitenzahlen, liest und füllt Formularfelder, schneidet Seiten heraus, fügt mehrere PDFs zusammen und versieht Dokumente mit einem sichtbaren Signatur-Stempel.
Block-Einstellungen
Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).
Feld
Typ
Pflicht
Beschreibung
datei
Text
—
Pfad zur PDF-Datei, auf die sich die Aktionen des Blocks beziehen. Pflicht für alle Aktionen außer 'zusammenfügen' (das die Quelldateien selbst angibt).
Aktionen
lesenlesend
Extrahiert den gesamten Textinhalt aller Seiten der PDF.
Ausgaben (über ergebnis:)
text
Der vollständige extrahierte Text aller Seiten (am Ende getrimmt).
seite-lesenlesend
Extrahiert den Textinhalt einer einzelnen Seite (1-basiert).
Eingaben
Feld
Typ
Pflicht
Beschreibung
seite
Zahl
ja
Die 1-basierte Seitennummer; außerhalb des Bereichs 1 bis Seitenanzahl führt zu einem Fehler.
Ausgaben (über ergebnis:)
text
Der extrahierte Text der angegebenen Seite.
seitenzahllesend
Ermittelt die Anzahl der Seiten der PDF.
Ausgaben (über ergebnis:)
anzahl
Anzahl der Seiten als Zahl.
formular-felder-listelesend
Listet die Namen aller AcroForm-Formularfelder der PDF auf.
Ausgaben (über ergebnis:)
namen
Liste der Feldnamen; leere Liste, wenn kein Formular vorhanden ist.
formular-feld-lesenlesend
Liest den aktuellen Wert eines benannten Formularfelds aus.
Eingaben
Feld
Typ
Pflicht
Beschreibung
feld
Text
ja
Name des Formularfelds. Pflicht; das Feld muss existieren, sonst Fehler.
Ausgaben (über ergebnis:)
wert
Aktueller Feldwert; bei Checkboxen 'an' oder 'aus'.
formular-feld-setzenverändernd
Setzt den Wert eines Formularfelds und schreibt die PDF (in die Quelldatei oder in einen optionalen Ausgabepfad).
Eingaben
Feld
Typ
Pflicht
Beschreibung
feld
Text
ja
Name des zu setzenden Formularfelds. Pflicht; das Feld muss existieren.
wert
Text
—
Neuer Wert. Bei Checkboxen wird 'an'/'true'/'ja'/'1'/'yes'/'on'/'checked' als angekreuzt gewertet, sonst leer.
ausgabe
Text
—
Optionaler Zielpfad. Fehlt er, wird die Quelldatei überschrieben.
Ausgaben (über ergebnis:)
(keine)
Keine Ausgabe; das Ergebnis ist die geschriebene PDF-Datei.
seite-extrahierenverändernd
Schneidet eine einzelne Seite als neue PDF-Datei heraus.
Eingaben
Feld
Typ
Pflicht
Beschreibung
seite
Zahl
ja
1-basierte Seitennummer; außerhalb des gültigen Bereichs führt zu einem Fehler.
ziel-pfad
Text
ja
Pfad, unter dem die extrahierte Einzelseiten-PDF gespeichert wird.
Ausgaben (über ergebnis:)
(keine)
Keine Ausgabe; das Ergebnis ist die neue PDF-Datei unter ziel-pfad.
zusammenfügenverändernd
Fügt mehrere PDF-Dateien in der angegebenen Reihenfolge zu einer einzigen PDF zusammen.
Eingaben
Feld
Typ
Pflicht
Beschreibung
dateien
Liste
ja
Liste der Pfade der zusammenzufügenden PDFs (auch ein einzelner Textpfad zulässig). Darf nicht leer sein.
ziel-pfad
Text
ja
Pfad der erzeugten Gesamt-PDF.
Ausgaben (über ergebnis:)
(keine)
Keine Ausgabe; das Ergebnis ist die zusammengefügte PDF unter ziel-pfad.
digital-signierenverändernd
Fügt einen sichtbaren Signatur-Stempel als Annotation auf der letzten Seite ein und speichert die PDF (kein kryptografisches PAdES-Zertifikat).
Eingaben
Feld
Typ
Pflicht
Beschreibung
ziel-pfad
Text
ja
Pfad der signierten Ausgabe-PDF.
grund
Text
—
Optionaler Grund der Signatur, der im Stempel vermerkt wird.
ort
Text
—
Optionaler Ort, der im Stempel vermerkt wird.
Ausgaben (über ergebnis:)
(keine)
Keine Ausgabe; das Ergebnis ist die gestempelte PDF unter ziel-pfad mit Zeitstempel.
als-bild-rendernverändernd
Soll eine Seite als Bild rendern – im aktuellen Stand nicht verfügbar (wirft 'nicht verfügbar').
Eingaben
Feld
Typ
Pflicht
Beschreibung
ziel-pfad
Text
ja
Zielpfad für das Bild; die Aktion ist derzeit nicht implementiert.
seite
Zahl
—
Zu rendernde Seite (wird derzeit nicht ausgewertet).
Ausgaben (über ergebnis:)
(keine)
Keine Ausgabe; die Aktion ist nicht verfügbar.
Beispiele
Text aus einer Rechnung auslesen
Liest den gesamten Text einer PDF-Rechnung und legt ihn in einer Variablen ab.