← Alle Module · Office (lokal)

`office.word`

Liest, bearbeitet und erzeugt Word-Dokumente: Text suchen/ersetzen/anhängen, Felder und Lesezeichen füllen, Tabellen, Kopf- und Fußzeilen, Formatierungen, Bilder, Kommentare, Serienbriefe sowie Speichern und PDF-Export. So lassen sich Vorlagen automatisch mit Daten füllen und versandfertige Dokumente erstellen.

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	ja	Pfad zur Word-Datei (.docx oder .doc), auf der alle Aktionen des Blocks arbeiten.

Aktionen

`text-lesen`lesend

Liest den gesamten Fließtext des Dokuments aus.

Ausgaben (über `ergebnis:`)

text	Der vollständige Dokumenttext als ein zusammenhängender Text.

`text-anhängen`verändernd

Hängt einen neuen Absatz mit dem angegebenen Text ans Ende des Dokuments an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	ja	Der anzuhängende Absatztext.
format	Text	—	Optionale Formatvorlage/Formatangabe für den neuen Absatz.

`text-ersetzen`verändernd

Sucht einen Text (optional per Regex) und ersetzt ihn im Dokument.

Eingaben

Feld	Typ	Pflicht	Beschreibung
suchen	Text	ja	Zu suchender Text oder Regex-Muster.
ersetzen-durch	Text	—	Ersatztext (Standard: leer, also Löschen des Treffers).
regex	Wahrheit	—	Wenn wahr, wird 'suchen' als regulärer Ausdruck interpretiert (Standard: falsch).
groß-klein-egal	Wahrheit	—	Wenn wahr, wird Groß-/Kleinschreibung ignoriert (Standard: falsch).
alle	Wahrheit	—	Wenn wahr, werden alle Treffer ersetzt, sonst nur der erste (Standard: wahr).

Ausgaben (über `ergebnis:`)

anzahl

Anzahl der vorgenommenen Ersetzungen.

`text-einfügen`verändernd

Fügt Text an der Position eines benannten Lesezeichens ein.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	ja	Name des Lesezeichens, an dem eingefügt wird.
text	Text	—	Einzufügender Text (Standard: leer).

`feld-setzen`verändernd

Setzt den Wert eines Dokumentfeldes (z. B. Serienbrief-/Formularfeld).

Eingaben

Feld	Typ	Pflicht	Beschreibung
feld-name	Text	ja	Name des zu setzenden Feldes.
wert	Text	—	Wert, der in das Feld geschrieben wird.

`feld-lesen`lesend

Liest den Wert eines benannten Dokumentfeldes.

Eingaben

Feld	Typ	Pflicht	Beschreibung
feld-name	Text	ja	Name des zu lesenden Feldes.

Ausgaben (über `ergebnis:`)

wert	Der aktuelle Wert des Feldes (oder Nichts, wenn leer).

`feld-liste`lesend

Gibt die Namen aller im Dokument vorhandenen Felder zurück.

Ausgaben (über `ergebnis:`)

felder

Liste aller Feldnamen.

`lesezeichen-setzen`verändernd

Legt ein Lesezeichen mit zugehörigem Text an oder überschreibt es.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	ja	Name des Lesezeichens.
text	Text	—	Text am Lesezeichen (Standard: leer).

`lesezeichen-lesen`lesend

Liest den Text an einem benannten Lesezeichen.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	ja	Name des Lesezeichens.

Ausgaben (über `ergebnis:`)

text	Text am Lesezeichen.

`tabelle-einfügen`verändernd

Fügt eine neue Tabelle aus einer Zeilen-/Spalten-Matrix ein.

Eingaben

Feld	Typ	Pflicht	Beschreibung
daten	Liste	—	Liste von Zeilen, jede Zeile eine Liste von Zellwerten.
mit-kopfzeile	Wahrheit	—	Wenn wahr, wird die erste Zeile als Kopfzeile formatiert (Standard: falsch).

`tabelle-zeile-anhängen`verändernd

Hängt eine Zeile mit den angegebenen Werten an eine bestehende Tabelle an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabellen-index	Zahl	—	Index der Zieltabelle (Standard: 0).
werte	Liste	—	Liste der Zellwerte für die neue Zeile.

`tabelle-zelle-setzen`verändernd

Setzt den Wert einer einzelnen Tabellenzelle.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabellen-index	Zahl	—	Index der Tabelle (Standard: 0).
zeile	Zahl	—	Zeilenindex der Zelle (Standard: 0).
spalte	Zahl	—	Spaltenindex der Zelle (Standard: 0).
wert	Text	—	Neuer Zellwert.

`tabelle-lesen`lesend

Liest den Inhalt einer Tabelle als Zeilenliste aus.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabellen-index	Zahl	—	Index der zu lesenden Tabelle (Standard: 0).

Ausgaben (über `ergebnis:`)

zeilen

Liste der Zeilen, jede Zeile eine Liste der Zellwerte.

`seitenumbruch-einfügen`verändernd

Fügt am Ende des Dokuments einen Seitenumbruch ein.

`abschnittsumbruch-einfügen`verändernd

Fügt am Ende des Dokuments einen Abschnittsumbruch ein.

`kopfzeile-setzen`verändernd

Setzt den Text der Kopfzeile des Dokuments.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	—	Kopfzeilentext (Standard: leer).

`fußzeile-setzen`verändernd

Setzt den Text der Fußzeile des Dokuments.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	—	Fußzeilentext (Standard: leer).

`absatz-formatieren`verändernd

Formatiert den Absatz an einem Lesezeichen (Ausrichtung, Abstände, Einzug).

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen des zu formatierenden Absatzes.
ausrichtung	Text	—	Ausrichtung, z. B. links, zentriert, rechts, blocksatz.
abstand-vor	Zahl	—	Abstand vor dem Absatz (in Punkt).
abstand-nach	Zahl	—	Abstand nach dem Absatz (in Punkt).
einzug-links	Zahl	—	Linker Einzug des Absatzes.

`zeichen-formatieren`verändernd

Formatiert die Zeichen an einem Lesezeichen (fett, kursiv, Schrift, Farbe).

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen des zu formatierenden Bereichs.
fett	Wahrheit	—	Fettdruck ein/aus.
kursiv	Wahrheit	—	Kursiv ein/aus.
unterstrichen	Wahrheit	—	Unterstreichen ein/aus.
schriftgröße	Zahl	—	Schriftgröße in Punkt.
schriftart	Text	—	Name der Schriftart.
farbe	Text	—	Schriftfarbe (z. B. Hex-Code oder Farbname).

`formatvorlage-anwenden`verändernd

Wendet eine benannte Formatvorlage auf den Bereich eines Lesezeichens an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen des Zielbereichs.
formatvorlage	Text	—	Name der Formatvorlage, z. B. 'Überschrift 1'.

`bild-einfügen`verändernd

Fügt ein Bild aus einer Datei ein, optional an einem Lesezeichen und mit Breite.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bild-pfad	Text	—	Pfad zur Bilddatei.
breite-cm	Zahl	—	Bildbreite in Zentimetern.
lesezeichen	Text	—	Lesezeichen, an dem das Bild eingefügt wird.

`dokument-eigenschaft-setzen`verändernd

Setzt eine Dokument-Eigenschaft (z. B. Titel, Autor).

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	—	Name der Eigenschaft.
wert	Text	—	Wert der Eigenschaft.

`dokument-eigenschaft-lesen`lesend

Liest eine Dokument-Eigenschaft aus.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	—	Name der zu lesenden Eigenschaft.

Ausgaben (über `ergebnis:`)

wert	Wert der Eigenschaft (oder Nichts).

`kommentar-setzen`verändernd

Fügt einen Kommentar an einem Lesezeichen hinzu.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen, an dem der Kommentar verankert wird.
text	Text	—	Kommentartext.
autor	Text	—	Name des Kommentar-Autors.

`kommentare-lesen`lesend

Liest alle Kommentare des Dokuments.

Ausgaben (über `ergebnis:`)

kommentare

Liste der Kommentare (je Objekt mit text, autor usw.).

`seitenzahl`lesend

Gibt die Gesamtseitenzahl des Dokuments zurück.

Ausgaben (über `ergebnis:`)

seitenzahl

Anzahl der Seiten.

`serienbrief-ausführen`verändernd

Erzeugt aus einer Liste von Datensätzen je ein Serienbrief-Dokument im Zielordner.

Eingaben

Feld	Typ	Pflicht	Beschreibung
datensätze	Liste	—	Liste von Feld-Objekten, je ein Datensatz pro Brief.
ziel-ordner	Text	—	Ordner, in den die erzeugten Dokumente geschrieben werden.
datei-muster	Text	—	Dateinamen-Muster mit Platzhaltern, z. B. 'Brief-{nummer}.docx'.

Ausgaben (über `ergebnis:`)

anzahl

Anzahl der erzeugten Dokumente.

`änderungen-nachverfolgen`verändernd

Schaltet die Änderungsnachverfolgung des Dokuments ein oder aus.

Eingaben

Feld	Typ	Pflicht	Beschreibung
aktiv	Wahrheit	—	Wahr schaltet die Nachverfolgung ein, falsch aus (Standard: falsch).

`änderungen-annehmen`verändernd

Nimmt alle nachverfolgten Änderungen im Dokument an.

`änderungen-ablehnen`verändernd

Lehnt alle nachverfolgten Änderungen im Dokument ab.

`änderungen-lesen`lesend

Liest die Liste aller nachverfolgten Änderungen.

Ausgaben (über `ergebnis:`)

änderungen

Liste der Änderungen (je Objekt mit art, text, autor).

`speichern`verändernd

Speichert das Dokument unter seinem aktuellen Pfad.

`speichern-unter`verändernd

Speichert das Dokument unter einem neuen Pfad.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Zielpfad der neuen Datei.

`als-pdf-exportieren`verändernd

Exportiert das Dokument als PDF-Datei.

Eingaben

Feld	Typ	Pflicht	Beschreibung
ziel-pfad	Text	—	Zielpfad der PDF-Datei.

Beispiele

Vertragsvorlage füllen und als PDF speichern

Ersetzt Platzhalter, füllt ein Lesezeichen und exportiert das fertige Dokument als PDF.

office.word

text-ersetzen

suchen{{KUNDE}}

ersetzen-durchMustermann GmbH

alleja

ergebnisersetzt

office.word

text-einfügen

lesezeichendatum

text20.06.2026

office.word

als-pdf-exportieren

ziel-pfadC:\Vertraege\Mustermann.pdf

- office.word:
    datei: "C:\\Vorlagen\\Vertrag.docx"
    aktionen:
      - text-ersetzen:
          suchen: "{{KUNDE}}"
          ersetzen-durch: "Mustermann GmbH"
          alle: ja
          ergebnis: ersetzt
      - text-einfügen:
          lesezeichen: datum
          text: "20.06.2026"
      - als-pdf-exportieren:
          ziel-pfad: "C:\\Vertraege\\Mustermann.pdf"

Serienbrief aus Datensätzen erzeugen

Erstellt aus einer Liste von Empfängern je ein Brief-Dokument im Zielordner.

office.word

serienbrief-ausführen

datensätzeliste_empfaenger

ziel-ordnerC:\Briefe

datei-musterBrief-{nummer}.docx

ergebnisanzahl_briefe

- office.word:
    datei: "C:\\Vorlagen\\Anschreiben.docx"
    aktionen:
      - serienbrief-ausführen:
          datensätze: liste_empfaenger
          ziel-ordner: "C:\\Briefe"
          datei-muster: "Brief-{nummer}.docx"
          ergebnis: anzahl_briefe

office.word

Block-Einstellungen

Aktionen

text-lesenlesend

Ausgaben (über ergebnis:)

text-anhängenverändernd

Eingaben

text-ersetzenverändernd

Eingaben

Ausgaben (über ergebnis:)

text-einfügenverändernd

Eingaben

feld-setzenverändernd

Eingaben

feld-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

feld-listelesend

Ausgaben (über ergebnis:)

lesezeichen-setzenverändernd

Eingaben

lesezeichen-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

tabelle-einfügenverändernd

Eingaben

tabelle-zeile-anhängenverändernd

Eingaben

tabelle-zelle-setzenverändernd

Eingaben

tabelle-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

seitenumbruch-einfügenverändernd

abschnittsumbruch-einfügenverändernd

kopfzeile-setzenverändernd

Eingaben

fußzeile-setzenverändernd

Eingaben

absatz-formatierenverändernd

Eingaben

zeichen-formatierenverändernd

Eingaben

formatvorlage-anwendenverändernd

Eingaben

bild-einfügenverändernd

Eingaben

dokument-eigenschaft-setzenverändernd

Eingaben

dokument-eigenschaft-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

kommentar-setzenverändernd

Eingaben

kommentare-lesenlesend

Ausgaben (über ergebnis:)

seitenzahllesend

Ausgaben (über ergebnis:)

serienbrief-ausführenverändernd

Eingaben

Ausgaben (über ergebnis:)

änderungen-nachverfolgenverändernd

Eingaben

änderungen-annehmenverändernd

änderungen-ablehnenverändernd

änderungen-lesenlesend

Ausgaben (über ergebnis:)

speichernverändernd

speichern-unterverändernd

Eingaben

als-pdf-exportierenverändernd

Eingaben

Beispiele

Vertragsvorlage füllen und als PDF speichern

Serienbrief aus Datensätzen erzeugen

`office.word`

`text-lesen`lesend

Ausgaben (über `ergebnis:`)

`text-anhängen`verändernd

`text-ersetzen`verändernd

Ausgaben (über `ergebnis:`)

`text-einfügen`verändernd

`feld-setzen`verändernd

`feld-lesen`lesend

Ausgaben (über `ergebnis:`)

`feld-liste`lesend

Ausgaben (über `ergebnis:`)

`lesezeichen-setzen`verändernd

`lesezeichen-lesen`lesend

Ausgaben (über `ergebnis:`)

`tabelle-einfügen`verändernd

`tabelle-zeile-anhängen`verändernd

`tabelle-zelle-setzen`verändernd

`tabelle-lesen`lesend

Ausgaben (über `ergebnis:`)

`seitenumbruch-einfügen`verändernd

`abschnittsumbruch-einfügen`verändernd

`kopfzeile-setzen`verändernd

`fußzeile-setzen`verändernd

`absatz-formatieren`verändernd

`zeichen-formatieren`verändernd

`formatvorlage-anwenden`verändernd

`bild-einfügen`verändernd

`dokument-eigenschaft-setzen`verändernd

`dokument-eigenschaft-lesen`lesend

Ausgaben (über `ergebnis:`)

`kommentar-setzen`verändernd

`kommentare-lesen`lesend

Ausgaben (über `ergebnis:`)

`seitenzahl`lesend

Ausgaben (über `ergebnis:`)

`serienbrief-ausführen`verändernd

Ausgaben (über `ergebnis:`)

`änderungen-nachverfolgen`verändernd

`änderungen-annehmen`verändernd

`änderungen-ablehnen`verändernd

`änderungen-lesen`lesend

Ausgaben (über `ergebnis:`)

`speichern`verändernd

`speichern-unter`verändernd

`als-pdf-exportieren`verändernd