Flower

← Alle Module · Daten & Formate

pdf

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).

FeldTypPflichtBeschreibung
dateiTextPfad 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:)

textDer vollständige extrahierte Text aller Seiten (am Ende getrimmt).

seite-lesenlesend

Extrahiert den Textinhalt einer einzelnen Seite (1-basiert).

Eingaben

FeldTypPflichtBeschreibung
seiteZahljaDie 1-basierte Seitennummer; außerhalb des Bereichs 1 bis Seitenanzahl führt zu einem Fehler.

Ausgaben (über ergebnis:)

textDer extrahierte Text der angegebenen Seite.

seitenzahllesend

Ermittelt die Anzahl der Seiten der PDF.

Ausgaben (über ergebnis:)

anzahlAnzahl der Seiten als Zahl.

formular-felder-listelesend

Listet die Namen aller AcroForm-Formularfelder der PDF auf.

Ausgaben (über ergebnis:)

namenListe der Feldnamen; leere Liste, wenn kein Formular vorhanden ist.

formular-feld-lesenlesend

Liest den aktuellen Wert eines benannten Formularfelds aus.

Eingaben

FeldTypPflichtBeschreibung
feldTextjaName des Formularfelds. Pflicht; das Feld muss existieren, sonst Fehler.

Ausgaben (über ergebnis:)

wertAktueller 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

FeldTypPflichtBeschreibung
feldTextjaName des zu setzenden Formularfelds. Pflicht; das Feld muss existieren.
wertTextNeuer Wert. Bei Checkboxen wird 'an'/'true'/'ja'/'1'/'yes'/'on'/'checked' als angekreuzt gewertet, sonst leer.
ausgabeTextOptionaler 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

FeldTypPflichtBeschreibung
seiteZahlja1-basierte Seitennummer; außerhalb des gültigen Bereichs führt zu einem Fehler.
ziel-pfadTextjaPfad, 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

FeldTypPflichtBeschreibung
dateienListejaListe der Pfade der zusammenzufügenden PDFs (auch ein einzelner Textpfad zulässig). Darf nicht leer sein.
ziel-pfadTextjaPfad 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

FeldTypPflichtBeschreibung
ziel-pfadTextjaPfad der signierten Ausgabe-PDF.
grundTextOptionaler Grund der Signatur, der im Stempel vermerkt wird.
ortTextOptionaler 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

FeldTypPflichtBeschreibung
ziel-pfadTextjaZielpfad für das Bild; die Aktion ist derzeit nicht implementiert.
seiteZahlZu 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.

pdf
pdf (Block-Input)
dateiC:\\Rechnungen\\rechnung-2026-001.pdf
pdf
lesen
ergebnisrechnungstext
- pdf:
    datei: "C:\\Rechnungen\\rechnung-2026-001.pdf"
    aktionen:
      - lesen:
          ergebnis: rechnungstext

Antragsformular ausfüllen und als Kopie speichern

Setzt zwei Formularfelder und schreibt das Ergebnis in eine separate Ausgabedatei, ohne die Vorlage zu verändern.

pdf
pdf (Block-Input)
dateiC:\\Vorlagen\\antrag.pdf
pdf
formular-feld-setzen
feldVorname
wertAlina
ausgabeC:\\Ausgang\\antrag-ausgefuellt.pdf
pdf
formular-feld-setzen
feldNachname
wertMosig
ausgabeC:\\Ausgang\\antrag-ausgefuellt.pdf
- pdf:
    datei: "C:\\Vorlagen\\antrag.pdf"
    aktionen:
      - formular-feld-setzen:
          feld: Vorname
          wert: Alina
          ausgabe: "C:\\Ausgang\\antrag-ausgefuellt.pdf"
      - formular-feld-setzen:
          feld: Nachname
          wert: Mosig
          ausgabe: "C:\\Ausgang\\antrag-ausgefuellt.pdf"