← Alle Module · Office (lokal)

`docx`

Liest und bearbeitet Word-Dokumente (.docx) direkt auf dem PC, ganz ohne installiertes Word. Damit lassen sich Texte ändern, Felder und Lesezeichen füllen, Tabellen und Bilder einfügen, Serienbriefe erzeugen, Kommentare und Änderungsverfolgung verwalten und das Ergebnis wieder speichern.

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), auf der der Block arbeitet. Existiert sie nicht, wird sie aus der Vorlage oder als leeres Dokument angelegt.
nur-lesen	Wahrheit	—	Wenn true, sind alle verändernden Aktionen gesperrt (Standard: false).
vorlage	Text	—	Pfad zu einer Vorlagen-Datei, die als Ausgangsdokument dient, falls die Zieldatei noch nicht existiert.

Aktionen

`text-lesen`lesend

Liest den gesamten Fließtext des Dokuments als zusammenhängenden Text aus.

Ausgaben (über `ergebnis:`)

ergebnis

Der extrahierte Dokumenttext.

`text-anhängen`verändernd

Hängt Text am Ende des Dokuments an, wahlweise als neuer Absatz oder fortlaufend.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	—	Der anzuhängende Text.
format	Text	—	Anhänge-Modus, z.B. "absatz" (Standard: absatz).

`text-ersetzen`verändernd

Sucht Text im Dokument und ersetzt ihn, optional per Regex und gross-/kleinschreibungs-unabhängig.

Eingaben

Feld	Typ	Pflicht	Beschreibung
suchen	Text	—	Der zu suchende Text bzw. das Suchmuster.
ersetzen-durch	Text	—	Der Ersatztext.
alle	Wahrheit	—	Alle Treffer ersetzen (Standard: true) oder nur den ersten.
regex	Wahrheit	—	Suchmuster als regulären Ausdruck auswerten (Standard: false).
groß-klein-egal	Wahrheit	—	Gross-/Kleinschreibung beim Suchen ignorieren (Standard: false).

Ausgaben (über `ergebnis:`)

ergebnis

Anzahl der durchgeführten Ersetzungen.

`text-einfügen`verändernd

Fügt Text an der Stelle eines benannten Lesezeichens in das Dokument ein.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Name des Lesezeichens, an dem eingefügt wird.
text	Text	—	Der einzufügende Text.

`feld-lesen`lesend

Liest den Wert eines Inhaltssteuerelements (Formularfeld) anhand seines Namens.

Eingaben

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

Ausgaben (über `ergebnis:`)

ergebnis

Der Feldwert; Fehler, wenn das Feld nicht existiert.

`feld-setzen`verändernd

Setzt den Wert eines benannten Inhaltssteuerelements (Formularfeld).

Eingaben

Feld	Typ	Pflicht	Beschreibung
feld-name	Text	—	Name des zu setzenden Feldes.
wert	Text	—	Der neue Feldwert.

`feld-liste`lesend

Liefert die Namen aller im Dokument vorhandenen Formularfelder.

Ausgaben (über `ergebnis:`)

ergebnis

Liste der Feldnamen.

`lesezeichen-lesen`lesend

Liest den Text, der von einem benannten Lesezeichen umschlossen wird.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	—	Name des Lesezeichens.

Ausgaben (über `ergebnis:`)

ergebnis

Der Text am Lesezeichen; Fehler, wenn es nicht existiert.

`lesezeichen-setzen`verändernd

Legt ein Lesezeichen an bzw. ersetzt seinen Text.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	—	Name des Lesezeichens.
text	Text	—	Der Text, den das Lesezeichen umfassen soll.

`tabelle-einfügen`verändernd

Fügt eine neue Tabelle aus einer Datenliste in das Dokument ein.

Eingaben

Feld	Typ	Pflicht	Beschreibung
daten	Liste	—	Tabellendaten als Liste von Zeilen (je Zeile eine Liste von Zellen).
mit-kopfzeile	Wahrheit	—	Erste Zeile als Kopfzeile formatieren (Standard: false).

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

Hängt einer bestehenden Tabelle eine neue Zeile mit den angegebenen Zellwerten an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabellen-index	Zahl	—	Index der Zieltabelle, 0-basiert (Standard: 0).
werte	Liste	—	Zellwerte der neuen Zeile.

`tabelle-zelle-setzen`verändernd

Setzt den Inhalt einer einzelnen Tabellenzelle.

Eingaben

Feld	Typ	Pflicht	Beschreibung
tabellen-index	Zahl	—	Index der Zieltabelle, 0-basiert (Standard: 0).
zeile	Zahl	—	Zeilennummer, 1-basiert (Standard: 1).
spalte	Zahl	—	Spaltennummer, 1-basiert (Standard: 1).
wert	Text	—	Der neue Zellinhalt.

`tabelle-lesen`lesend

Liest eine Tabelle als Liste von Zeilen mit Zellwerten aus.

Eingaben

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

Ausgaben (über `ergebnis:`)

ergebnis

Liste der Zeilen, je Zeile eine Liste von Zelltexten.

`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 Seiten-Kopfzeile.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	—	Der Kopfzeilentext.

`fußzeile-setzen`verändernd

Setzt den Text der Seiten-Fußzeile.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	—	Der Fußzeilentext.

`absatz-formatieren`verändernd

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

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen, das den zu formatierenden Absatz markiert.
ausrichtung	Text	—	Textausrichtung, z.B. links/zentriert/rechts/blocksatz.
abstand-vor	Zahl	—	Abstand vor dem Absatz.
abstand-nach	Zahl	—	Abstand nach dem Absatz.
einzug-links	Zahl	—	Linker Einzug des Absatzes.

`zeichen-formatieren`verändernd

Formatiert den Text an einem Lesezeichen (fett, kursiv, Schriftgröße, Farbe usw.).

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen, das den zu formatierenden Text markiert.
fett	Wahrheit	—	Text fett setzen.
kursiv	Wahrheit	—	Text kursiv setzen.
unterstrichen	Wahrheit	—	Text unterstreichen.
schriftgröße	Zahl	—	Schriftgröße in Punkt.
schriftart	Text	—	Name der Schriftart.
farbe	Text	—	Schriftfarbe (z.B. Hex-Wert).

`formatvorlage-anwenden`verändernd

Weist dem Absatz an einem Lesezeichen eine benannte Formatvorlage zu.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen des Zielabsatzes.
formatvorlage	Text	—	Name der anzuwendenden Formatvorlage (z.B. Überschrift 1).

`bild-einfügen`verändernd

Fügt ein Bild aus einer Datei in das Dokument ein, optional an einem Lesezeichen.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bild-pfad	Text	—	Pfad zur einzufügenden Bilddatei.
breite-cm	Zahl	—	Anzeigebreite in Zentimetern (Standard: 10).
lesezeichen	Text	—	Lesezeichen, an dem das Bild platziert wird.

`dokument-eigenschaft-setzen`verändernd

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

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	—	Name der Eigenschaft, z.B. "title" oder "creator".
wert	Text	—	Der zu setzende Wert.

`dokument-eigenschaft-lesen`lesend

Liest eine Dokument-Eigenschaft aus den Kerndaten.

Eingaben

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

Ausgaben (über `ergebnis:`)

ergebnis

Der Eigenschaftswert (leer, wenn nicht gesetzt).

`kommentar-setzen`verändernd

Heftet an ein Lesezeichen einen Kommentar mit Text und Autor.

Eingaben

Feld	Typ	Pflicht	Beschreibung
lesezeichen	Text	—	Lesezeichen, an das der Kommentar gehängt wird.
text	Text	—	Der Kommentartext.
autor	Text	—	Name des Autors (Standard: Flower).

`kommentare-lesen`lesend

Liest alle Kommentare des Dokuments aus.

Ausgaben (über `ergebnis:`)

ergebnis

Liste der Kommentare mit Autor und Text.

`serienbrief-ausführen`verändernd

Erzeugt aus dem Dokument als Vorlage je Datensatz ein gefülltes Word-Dokument im Zielordner.

Eingaben

Feld	Typ	Pflicht	Beschreibung
datensätze	Liste	—	Liste der Datensätze, je Datensatz ein Objekt aus Feldname/Wert.
ziel-ordner	Text	ja	Ordner, in den die erzeugten Dokumente geschrieben werden.
datei-muster	Text	—	Namensschema je Datei, Platzhalter {nummer}, {index} und {feldname} (Standard: Serienbrief-{nummer}.docx).

Ausgaben (über `ergebnis:`)

ergebnis

Anzahl der erzeugten Dokumente.

`änderungen-nachverfolgen`verändernd

Schaltet die Word-Änderungsnachverfolgung im Dokument ein oder aus.

Eingaben

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

`änderungen-annehmen`verändernd

Nimmt alle nachverfolgten Änderungen im Dokument an.

`änderungen-ablehnen`verändernd

Verwirft alle nachverfolgten Änderungen im Dokument.

`änderungen-lesen`lesend

Liest alle nachverfolgten Änderungen des Dokuments aus.

Ausgaben (über `ergebnis:`)

ergebnis

Liste der nachverfolgten Änderungen.

`speichern`verändernd

Schreibt das geänderte Dokument zurück in die Block-Datei.

`speichern-unter`verändernd

Speichert das Dokument unter einem neuen Pfad (kein .doc-Ziel erlaubt).

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	ja	Zielpfad für die Kopie.

Beispiele

Vertragsvorlage füllen und speichern

Ein Lesezeichen wird gesetzt, ein Platzhalter ersetzt und das fertige Dokument unter neuem Namen gespeichert.

docx

text-ersetzen

suchen{{KUNDE}}

ersetzen-durchMustermann GmbH

ergebnisanzahl

docx

feld-setzen

feld-nameDatum

wert20.06.2026

docx

speichern-unter

pfadC:\Vertraege\Mustermann.docx

- docx:
    datei: "C:\\Vorlagen\\Vertrag.docx"
    aktionen:
      - text-ersetzen:
          suchen: "{{KUNDE}}"
          ersetzen-durch: "Mustermann GmbH"
          ergebnis: anzahl
      - feld-setzen:
          feld-name: Datum
          wert: "20.06.2026"
      - speichern-unter:
          pfad: "C:\\Vertraege\\Mustermann.docx"

Serienbrief aus Vorlage erzeugen

Aus einer Word-Vorlage wird für jeden Datensatz ein fertiges Dokument in einem Zielordner erstellt.

docx

serienbrief-ausführen

ziel-ordnerC:\Ausgang\Briefe

datei-musterBrief-{Name}.docx

ergebnisanzahl_briefe

- docx:
    datei: "C:\\Vorlagen\\Anschreiben.docx"
    aktionen:
      - serienbrief-ausführen:
          datensätze: empfaenger_liste
          ziel-ordner: "C:\\Ausgang\\Briefe"
          datei-muster: "Brief-{Name}.docx"
          ergebnis: anzahl_briefe

docx

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-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

feld-setzenverändernd

Eingaben

feld-listelesend

Ausgaben (über ergebnis:)

lesezeichen-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

lesezeichen-setzenverändernd

Eingaben

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

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

Beispiele

Vertragsvorlage füllen und speichern

Serienbrief aus Vorlage erzeugen

`docx`

`text-lesen`lesend

Ausgaben (über `ergebnis:`)

`text-anhängen`verändernd

`text-ersetzen`verändernd

Ausgaben (über `ergebnis:`)

`text-einfügen`verändernd

`feld-lesen`lesend

Ausgaben (über `ergebnis:`)

`feld-setzen`verändernd

`feld-liste`lesend

Ausgaben (über `ergebnis:`)

`lesezeichen-lesen`lesend

Ausgaben (über `ergebnis:`)

`lesezeichen-setzen`verändernd

`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:`)

`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