Flower

← Alle Module · Office (lokal)

office.excel

Steuert eine lokal installierte Microsoft-Excel-Arbeitsmappe direkt über Excel selbst: Zellen und Bereiche lesen und schreiben, Tabellenblätter verwalten, Formeln setzen, suchen/ersetzen, formatieren, sortieren, filtern, Diagramme und Pivot-Tabellen erstellen sowie als PDF exportieren oder speichern. So lassen sich wiederkehrende Excel-Arbeiten ohne manuelles Klicken automatisieren.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiTextjaPfad zur Excel-Datei (.xlsx oder .xls), die der ganze Block öffnet und bearbeitet.
nur-lesenWahrheit—Öffnet die Mappe schreibgeschützt (Standard: falsch).

Aktionen

zelle-lesenlesend

Liest den Wert einer einzelnen Zelle.

Eingaben

FeldTypPflichtBeschreibung
zelleText—Zell-Adresse in A1-Notation (z.B. "B3").
zeileZahl—Zeilennummer, alternativ zu zelle (zusammen mit spalte).
spalteText—Spaltenbuchstabe, alternativ zu zelle (zusammen mit zeile).
alsText—Erzwingt einen Lesetyp (z.B. Text/Zahl).

Ausgaben (über ergebnis:)

ergebnisDer gelesene Zellwert (Text, Zahl, Wahrheit oder Nichts bei leerer Zelle).

zelle-setzenverändernd

Schreibt einen Wert in eine einzelne Zelle.

Eingaben

FeldTypPflichtBeschreibung
wertText—Der zu schreibende Wert (Text, Zahl oder Wahrheit).
zelleText—Zell-Adresse in A1-Notation.
zeileZahl—Zeilennummer, alternativ zu zelle.
spalteText—Spaltenbuchstabe, alternativ zu zelle.
alsText—Erzwingt einen Schreibtyp.

Ausgaben (über ergebnis:)

ergebnisDer vorherige Wert der Zelle, bevor sie überschrieben wurde.

bereich-lesenlesend

Liest einen Zellbereich als Tabelle (Matrix oder Liste von Objekten mit Kopfzeile).

Eingaben

FeldTypPflichtBeschreibung
bereichText—Bereich in A1-Notation (z.B. "A1:C10").
von-zelleText—Start-Zelle, alternativ zu bereich.
bis-zelleText—End-Zelle, alternativ zu bereich.
mit-kopfzeileWahrheit—Wenn wahr, wird die erste Zeile als Spaltennamen genutzt und jede Datenzeile als Objekt geliefert (Standard: falsch).

Ausgaben (über ergebnis:)

ergebnisListe von Zeilen — entweder eine Matrix (Liste von Listen) oder bei mit-kopfzeile eine Liste von Objekten.

zeile-anhängenverändernd

Hängt eine neue Datenzeile unter die letzte befüllte Zeile an.

Eingaben

FeldTypPflichtBeschreibung
werteListe—Werte für die Spalten der neuen Zeile (A, B, C, ...).
tabellenblattText—Ziel-Tabellenblatt; ohne Angabe das aktive Blatt.

Ausgaben (über ergebnis:)

ergebnisNummer der neu beschriebenen Zeile.

formel-setzenverändernd

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

Eingaben

FeldTypPflichtBeschreibung
formelTextjaDie Formel (mit oder ohne führendes Gleichheitszeichen, z.B. "SUMME(A2:A10)").
zelleText—Zell-Adresse in A1-Notation.
zeileZahl—Zeilennummer, alternativ zu zelle.
spalteText—Spaltenbuchstabe, alternativ zu zelle.

suchenlesend

Sucht einen Wert in der Mappe und gibt die Fundstelle zurück.

Eingaben

FeldTypPflichtBeschreibung
wertTextjaDer gesuchte Wert.
bereichText—Bereich, auf den die Suche beschränkt wird.
spalteText—Spalte, auf die die Suche beschränkt wird.
groß-klein-egalWahrheit—Ignoriert Groß-/Kleinschreibung (Standard: falsch).

Ausgaben (über ergebnis:)

ergebnisObjekt mit gefunden (Wahrheit), ergebnis-zeile (Zahl) und ergebnis-spalte (Text).

ersetzenverändernd

Ersetzt einen Text durch einen anderen und meldet die Trefferzahl.

Eingaben

FeldTypPflichtBeschreibung
suchenTextjaDer zu ersetzende Text.
ersetzen-durchTextjaDer neue Text.
bereichText—Bereich, auf den das Ersetzen beschränkt wird.
alleWahrheit—Wenn wahr, werden alle Treffer ersetzt, sonst nur der erste (Standard: falsch).

Ausgaben (über ergebnis:)

ergebnisAnzahl der ersetzten Treffer (Zahl).

sortierenverändernd

Sortiert einen Bereich nach einer Spalte.

Eingaben

FeldTypPflichtBeschreibung
bereichTextjaZu sortierender Bereich in A1-Notation.
spalteTextjaSpalte, nach der sortiert wird.
richtungText—Sortierrichtung (z.B. aufsteigend/absteigend).

diagramm-erstellenverändernd

Erstellt ein Diagramm aus einem Datenbereich.

Eingaben

FeldTypPflichtBeschreibung
typTextjaDiagrammtyp (z.B. säule, linie, kreis).
daten-bereichTextjaDatenbereich für das Diagramm.
ziel-zelleTextjaZelle, an der das Diagramm platziert wird.
titelText—Optionaler Diagrammtitel.

als-pdf-exportierenverändernd

Exportiert die Mappe (oder ausgewählte Blätter) als PDF.

Eingaben

FeldTypPflichtBeschreibung
ziel-pfadTextjaZielpfad der PDF-Datei.
tabellenblätterListe—Namen der zu exportierenden Blätter; ohne Angabe die ganze Mappe.

speichernverändernd

Speichert die geöffnete Mappe.

Beispiele

Neue Bestellzeile anhängen und speichern

Öffnet eine Bestell-Liste, hängt eine Zeile mit Kunde, Betrag und Bezahlt-Status an und speichert die Datei.

office.excel
office.excel öffnen
dateiC:\\Daten\\bestellungen.xlsx
office.excel
zeile-anhängen
werte["Müller GmbH", 1500, true]
ergebnisneue-zeile
- office.excel:
    datei: "C:\\Daten\\bestellungen.xlsx"
    aktionen:
      - zeile-anhängen:
          werte: ["Müller GmbH", 1500, true]
          ergebnis: neue-zeile
      - speichern: {}

Summe als Formel setzen und Bereich lesen

Trägt in B11 eine Summenformel ein, liest danach den Bereich A1:B11 mit Kopfzeile aus und exportiert das Blatt als PDF.

office.excel
office.excel öffnen
dateiC:\\Daten\\umsatz.xlsx
office.excel
formel-setzen
zelleB11
formelSUMME(B2:B10)
office.excel
bereich-lesen
bereichA1:B11
mit-kopfzeiletrue
ergebnistabelle
office.excel
als-pdf-exportieren
ziel-pfadC:\\Daten\\umsatz.pdf
- office.excel:
    datei: "C:\\Daten\\umsatz.xlsx"
    aktionen:
      - formel-setzen:
          zelle: B11
          formel: "SUMME(B2:B10)"
      - bereich-lesen:
          bereich: A1:B11
          mit-kopfzeile: true
          ergebnis: tabelle
      - als-pdf-exportieren:
          ziel-pfad: "C:\\Daten\\umsatz.pdf"