← Alle Module · Office (lokal)

`xlsx`

Liest und schreibt Excel-Arbeitsmappen (.xlsx) direkt als Datei, ohne dass Excel installiert sein muss. Damit lassen sich Tabellenblätter, Zellen, Bereiche, Formeln, Formatierungen und mehr automatisiert befüllen, durchsuchen und bearbeiten.

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 Excel-Datei. Existiert die Datei, wird sie geladen; sonst (oder ohne Angabe) wird eine neue, leere Mappe im Speicher angelegt. Wird auch von der Aktion 'speichern' als Zielpfad genutzt.

Aktionen

`zelle-lesen`lesend

Liest den Wert einer einzelnen Zelle.

Eingaben

Feld	Typ	Pflicht	Beschreibung
zelle	Text	—	Zelle in A1-Schreibweise (z.B. B2). Alternativ zeile+spalte.
zeile	Zahl	—	Zeilennummer (1-basiert), nur zusammen mit spalte.
spalte	Text	—	Spaltenbuchstabe (z.B. A), nur zusammen mit zeile.
als	Text	—	Optionale Typ-Umwandlung des Ergebnisses (z.B. Zahl, Text, Datum).

Ausgaben (über `ergebnis:`)

wert	Der Zellwert (leer = nichts).

`zelle-setzen`verändernd

Schreibt einen Wert in eine Zelle.

Eingaben

Feld	Typ	Pflicht	Beschreibung
zelle	Text	—	Zelle in A1-Schreibweise. Alternativ zeile+spalte (eines von beidem ist Pflicht).
zeile	Zahl	—	Zeilennummer (1-basiert), zusammen mit spalte.
spalte	Text	—	Spaltenbuchstabe, zusammen mit zeile.
wert	Text	—	Der zu schreibende Wert (Text, Zahl oder Wahrheit).
als	Text	—	Optionale Typ-Umwandlung des Werts vor dem Schreiben.

Ausgaben (über `ergebnis:`)

alter_wert

Der vorherige Inhalt der Zelle.

`zeile-anhängen`verändernd

Hängt eine neue Zeile mit mehreren Werten unten an die befüllten Daten an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
werte	Liste	ja	Liste der Werte, die ab Spalte A in die neue Zeile geschrieben werden.
tabellenblatt	Text	—	Optional: Name des Zielblatts, auf das vorher gewechselt wird.

Ausgaben (über `ergebnis:`)

zeile

Nummer der neu angelegten Zeile.

`bereich-lesen`lesend

Liest einen rechteckigen Zellbereich, optional mit Kopfzeile als Liste von Objekten.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bereich	Text	—	Bereich in A1-Schreibweise (z.B. A1:C10). Alternativ von-zelle+bis-zelle.
von-zelle	Text	—	Obere linke Zelle (zusammen mit bis-zelle).
bis-zelle	Text	—	Untere rechte Zelle (zusammen mit von-zelle).
mit-kopfzeile	Wahrheit	—	Wenn wahr: erste Zeile wird zu Spaltennamen, Ergebnis ist eine Liste von Objekten.

Ausgaben (über `ergebnis:`)

ergebnis

Bei false eine Liste von Zeilen-Listen; bei mit-kopfzeile eine Liste von Objekten.

`bereich-setzen`verändernd

Schreibt eine Matrix von Werten in einen Bereich.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bereich	Text	ja	Zielbereich in A1-Schreibweise (z.B. A1:B2).
werte	Liste	—	Liste von Zeilen-Listen; darf den Bereich nicht überschreiten.

`suchen`lesend

Sucht einen Wert im Blatt (oder in einem Bereich/einer Spalte) und liefert die erste Fundstelle.

Eingaben

Feld	Typ	Pflicht	Beschreibung
wert	Text	—	Der gesuchte Wert.
bereich	Text	—	Optional auf einen Bereich eingrenzen.
spalte	Text	—	Optional auf eine Spalte eingrenzen.
groß-klein-egal	Wahrheit	—	Groß-/Kleinschreibung ignorieren (Standard: wahr).

Ausgaben (über `ergebnis:`)

gefunden	Wahr/falsch, ob der Wert gefunden wurde.
zeile	Zeile der Fundstelle (0 wenn nicht gefunden).
spalte	Spaltenbuchstabe der Fundstelle (leer wenn nicht gefunden).

`nächste-freie-zeile`lesend

Findet die erste leere Zeile in einer Spalte.

Eingaben

Feld	Typ	Pflicht	Beschreibung
spalte	Text	ja	Spaltenbuchstabe, in dem gesucht wird.
start-zeile	Zahl	—	Ab welcher Zeile gesucht wird (Standard: 1).

Ausgaben (über `ergebnis:`)

zeile

Nummer der nächsten freien Zeile.

`formel-setzen`verändernd

Trägt eine Excel-Formel in eine Zelle ein.

Eingaben

Feld	Typ	Pflicht	Beschreibung
formel	Text	ja	Formel ohne oder mit führendem = (z.B. SUM(A1:A2)).
zelle	Text	—	Zielzelle in A1-Schreibweise. Alternativ zeile+spalte.
zeile	Zahl	—	Zeilennummer (zusammen mit spalte).
spalte	Text	—	Spaltenbuchstabe (zusammen mit zeile).

`formatieren`verändernd

Wendet Schrift-, Farb-, Ausrichtungs- und Zahlenformat auf einen Bereich an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bereich	Text	ja	Zu formatierender Bereich in A1-Schreibweise.
fett	Wahrheit	—	Fettdruck ein/aus.
kursiv	Wahrheit	—	Kursiv ein/aus.
unterstrichen	Wahrheit	—	Unterstreichen ein/aus.
schriftart	Text	—	Name der Schriftart.
schriftgröße	Zahl	—	Schriftgröße in Punkt.
farbe	Text	—	Schriftfarbe.
hintergrund	Text	—	Hintergrund-/Füllfarbe.
ausrichtung	Text	—	links \| mitte \| rechts.
zahlenformat	Text	—	Excel-Zahlenformat-Code.

`tabellenblatt-anlegen`verändernd

Legt ein neues Tabellenblatt an.

Eingaben

Feld	Typ	Pflicht	Beschreibung
name	Text	ja	Name des neuen Blatts (darf nicht bereits existieren).
nach	Text	—	Optional: Name des Blatts, hinter dem das neue eingefügt wird.
wechseln	Wahrheit	—	Wenn wahr: direkt zum neuen Blatt wechseln.

`sortieren`verändernd

Sortiert die Zeilen eines Bereichs nach einer Spalte.

Eingaben

Feld	Typ	Pflicht	Beschreibung
bereich	Text	ja	Zu sortierender Bereich in A1-Schreibweise.
spalte	Text	ja	Sortierspalte (muss im Bereich liegen).
richtung	Text	—	aufsteigend (Standard) oder absteigend.

`speichern`verändernd

Speichert die Arbeitsmappe unter dem beim Öffnen angegebenen Dateipfad.

`speichern-unter`verändernd

Speichert die Arbeitsmappe unter einem neuen Pfad (nur Format xlsx/xls).

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	ja	Zielpfad der Datei.
format	Text	—	xlsx (Standard) oder xls. Für PDF-Export office.excel nutzen.

Beispiele

Neue Mappe befüllen und speichern

Legt eine Kopfzeile und einen Datensatz per zeile-anhängen an und speichert das Ergebnis als .xlsx.

xlsx

zeile-anhängen

werte[Name, Alter]

ergebniskopf

xlsx

zeile-anhängen

werte[Anna, 30]

ergebnisdatenzeile

- xlsx:
    datei: "C:\\Berichte\\personen.xlsx"
    aktionen:
      - zeile-anhängen:
          werte: [Name, Alter]
          ergebnis: kopf
      - zeile-anhängen:
          werte: [Anna, 30]
          ergebnis: datenzeile
      - speichern: {}

Tabelle einlesen und Wert suchen

Liest einen Bereich mit Kopfzeile als Objektliste und sucht anschließend eine bestimmte Zelle.

xlsx

bereich-lesen

bereichA1:C100

mit-kopfzeileja

ergebniszeilen

xlsx

suchen

wertMüller

spalteA

ergebnistreffer

- xlsx:
    datei: "C:\\Daten\\kunden.xlsx"
    aktionen:
      - bereich-lesen:
          bereich: "A1:C100"
          mit-kopfzeile: ja
          ergebnis: zeilen
      - suchen:
          wert: "Müller"
          spalte: A
          ergebnis: treffer

xlsx

Block-Einstellungen

Aktionen

zelle-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

zelle-setzenverändernd

Eingaben

Ausgaben (über ergebnis:)

zeile-anhängenverändernd

Eingaben

Ausgaben (über ergebnis:)

bereich-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

bereich-setzenverändernd

Eingaben

suchenlesend

Eingaben

Ausgaben (über ergebnis:)

nächste-freie-zeilelesend

Eingaben

Ausgaben (über ergebnis:)

formel-setzenverändernd

Eingaben

formatierenverändernd

Eingaben

tabellenblatt-anlegenverändernd

Eingaben

sortierenverändernd

Eingaben

speichernverändernd

speichern-unterverändernd

Eingaben

Beispiele

Neue Mappe befüllen und speichern

Tabelle einlesen und Wert suchen

`xlsx`

`zelle-lesen`lesend

Ausgaben (über `ergebnis:`)

`zelle-setzen`verändernd

Ausgaben (über `ergebnis:`)

`zeile-anhängen`verändernd

Ausgaben (über `ergebnis:`)

`bereich-lesen`lesend

Ausgaben (über `ergebnis:`)

`bereich-setzen`verändernd

`suchen`lesend

Ausgaben (über `ergebnis:`)

`nächste-freie-zeile`lesend

Ausgaben (über `ergebnis:`)

`formel-setzen`verändernd

`formatieren`verändernd

`tabellenblatt-anlegen`verändernd

`sortieren`verändernd

`speichern`verändernd

`speichern-unter`verändernd