Excel

Excel-Aktionen ermöglichen es Ihnen, Excel-Dateien in Ihren Automatisierungen zu lesen, zu aktualisieren und zu erstellen. Alle Excel-Aktionen unterstützen sowohl die Dateiformate .xlsx als auch .xlsm. Arbeitsmappen-IDs enthalten Verweise über mehrere Operationen hinweg.

Anmerkung

Werte können zwar aus XLSM-Dateien gelesen werden, die Ausführung von Makros wird jedoch nicht unterstützt.

Neue Arbeitsmappe erstellen

Erstellt eine leere Excel-Datei. Gibt eine Arbeitsmappen-ID aus, mit der Sie die Tabelle in nachfolgenden Schritten aktualisieren können.

Eigenschaften:

• Arbeitsmappen-ID (Ausgabe): Variablenname, in dem die Arbeitsmappenreferenz für future Aktionen gespeichert wird (Standard:) workbook_id

Öffnen Sie eine bestehende Arbeitsmappe

Lädt eine vorhandene Excel-Datei. Gibt eine Arbeitsmappen-ID zurück, mit der Sie die Tabelle in nachfolgenden Schritten aktualisieren können. Unterstützt nur Excel-Dateien (.xlsx).

Eigenschaften:

• Excel-Datei (erforderlich): Die zu öffnende XLSX-Datei, die normalerweise in einer Variablen gespeichert ist (z. B. my_file

• Arbeitsmappen-ID (Ausgabe): Variablenname, in dem die Arbeitsmappenreferenz gespeichert wird (Standard:) workbook_id

Anforderungen an die Datei:

• Muss eine gültige Excel-Datei (.xlsx) sein

• Auf die Datei muss als Mediendateiobjekt zugegriffen werden können

Arbeitsmappe speichern

Speichert Aktualisierungen in einer Excel-Datei. Ermöglicht es Ihnen, den Dateinamen und den Dateityp für die gespeicherte Arbeitsmappe zu aktualisieren.

Eigenschaften:

• Dateiname (erforderlich): Name für die gespeicherte Datei ohne Erweiterung (z. B. „Monatsbericht“)

• Dateityp (Dropdown): Ausgabeformat — unterstützt derzeit XLSX (Standard: XLSX)

• Gespeicherte Datei (Ausgabe): Variable, die das gespeicherte Dateiobjekt speichert (Standard:) saved_file

Blatt lesen

Ruft Daten aus einer Reihe von Zellen ab. Die Aktion speichert die Ausgabe in einer Datentabellenvariablen.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Die Arbeitsmappe, aus der gelesen werden soll (z. B.) workbook_id

• Blattname (erforderlich): Arbeitsblatt- oder Tabname (Standard: „Sheet1")

• Zellbereich (optional): Bereichsspezifikation — unterstützt mehrere Formate:

  • Startzelle: „A2" (liest alle Daten vom Ankerpunkt aus)

  • Exakter Bereich: „A1:B10"

  • Spaltenbereich: „A:B“

  • Zeilenbereich: "1:3“

  • Leer: liest das gesamte Blatt

• Kopfzeilen einbeziehen (Kontrollkästchen): Behandelt die erste Zeile als Spaltenüberschriften, wenn diese Option aktiviert ist. Wenn diese Option deaktiviert ist, wird die Standardbenennung verwendet (Column0, Column1 usw.) (Standard: TRUE)

• Datentabelle (Ausgabe): Variable, die die extrahierten Daten speichert (Standard:excel_table)

Handhabung von Formeln:

• Die Aktion berechnet automatisch Formeln und speichert die Ergebnisse in der Datentabelle.

Zelle lesen

Ruft den Wert aus einer Zelle ab. Wird verwendet, um einen einzelnen Zellenwert aus einem Arbeitsblatt zu lesen.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Die Arbeitsmappe, aus der gelesen werden soll (z. B.) workbook_id

• Blattname (erforderlich): Arbeitsblattname (Standard: „Sheet1")

• Zellenreferenz (erforderlich): Zellenposition (z. B. „A1")

• Zellenwert (Ausgabe): Variable, die den Zelleninhalt speichert (Standard:cell_value)

Auf ein Blatt schreiben

Gibt eine Datentabelle in ein Blatt aus. Wird verwendet, um einen Bereich von Zeilen und Spalten in ein Arbeitsblatt zu schreiben.

Eigenschaften:

• Datentabelle (erforderlich): Die zu schreibende Datentabelle (z. B.my_table)

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (Standard: „Sheet1")

• Bei Zelle beginnen (optional): Startposition für die Datenplatzierung (Standard: „A1")

• Kopfzeilen einbeziehen (Kontrollkästchen): Schreibt Spaltenüberschriften, wenn diese Option aktiviert ist (Standard: TRUE)

In eine Zelle schreiben

Gibt einen Wert in eine Zelle aus. Wird verwendet, um einzelne Zellen in einem Arbeitsblatt zu aktualisieren.

Eigenschaften:

• Zu schreibender Wert (erforderlich): Inhalt der Zelle (z. B. „Order #12345 „)

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (Standard: „Sheet1")

• Zellenreferenz (erforderlich): Position der Zielzelle (z. B. „A1")

Neue Zeile schreiben

Fügt dem Blatt eine Datenzeile hinzu. Die neue Zeile wird an das Ende der vorhandenen Daten angehängt.

Eigenschaften:

• Zeilenwerte (erforderlich): Array von Werten für die neue Zeile, beginnend mit der ersten Spalte (z. B. ["Q1", „Sales“, 100])

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (Standard: „Sheet1")

Datenvalidierung:

• Muss Werte als Array-Format bereitstellen

• Werte werden sequentiell ab der ersten Spalte geschrieben

Neues Blatt erstellen

Fügt ein leeres Arbeitsblatt hinzu. Das neue Blatt wird am Ende der Arbeitsmappe hinzugefügt.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Name für das neue Arbeitsblatt (z. B. „Verkaufsdaten“)

Blatt kopieren

Erstellt eine Kopie des Arbeitsblatts. Das neue Blatt wird in derselben Arbeitsmappe erstellt.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Zu kopierender Blattname (erforderlich): Name des Quellarbeitsblatts (z. B. „Originalblatt“)

• Neuer Blattname (erforderlich): Name für das duplizierte Blatt (z. B. „Originalblatt (Kopie)“)

Blatt umbenennen

Aktualisiert den Namen eines vorhandenen Arbeitsblatts.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Aktueller Blattname (erforderlich): Name des vorhandenen Arbeitsblatts (z. B. „Sheet1")

• Aktualisierter Blattname (erforderlich): Neuer Name für das Arbeitsblatt (z. B. „Q1-Daten“)

Blatt löschen

Löscht ein Blatt aus einer Arbeitsmappe. Das letzte verbleibende Blatt einer Arbeitsmappe kann nicht gelöscht werden.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Zu löschender Blattname (erforderlich): Zu entfernendes Arbeitsblatt (z. B. „Sheet1")

Einschränkungen:

• Das letzte verbleibende Blatt in einer Arbeitsmappe kann nicht gelöscht werden

Legen Sie die Zellenfarbe fest

Aktualisiert die Hintergrundfarbe der Zelle. Wird verwendet, um einen bestimmten Zellbereich hervorzuheben.

Eigenschaften:

• Zellenfarbe (erforderlich): RGB-Hex-Code-Format (z. B. FF0000 "" für Rot)

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (z. B. „Sheet1")

• Zellbereich (erforderlich): Zu formatierender Bereich — unterstützt:

  • Einzelne Zelle: „A1"

  • Exakter Bereich: „A1:B10"

  • Spaltenbereich: „A:B“

  • Zeilenbereich: "1:3“

Zellenfarbe abrufen

Liest die Hintergrundfarbe der Zelle. Gibt die Farbe im RGB-Hex-Code-Format aus (z. B. FF0000 "" für Rot).

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Quellarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Quellarbeitsblatt (z. B. „Sheet1")

• Zellenreferenz (erforderlich): Zu lesende Zelle (z. B. „A1")

• Zellenfarbe (Ausgabe): Variable, die den RGB-Hex-Code speichert (Standard:cell_color)

Zeilen ausblenden

Macht Zeilen im Blatt ausgeblendet. Die Daten bleiben erhalten, sind aber nicht sichtbar.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (z. B. „Sheet1")

• Startzeile (erforderlich): Erste Zeilennummer, die ausgeblendet werden soll (Excel-Nummerierung beginnt bei 1)

• Endzeile (optional): Letzte Zeilennummer, die ausgeblendet werden soll. Wenn das Feld leer ist, wird nur die Startzeile ausgeblendet

Zeilennummerierung:

• Excel-Zeilennummern beginnen bei 1 (nicht bei 0)

• Muss ganzzahlige Werte angeben

Zeilen einblenden

Macht ausgeblendete Zeilen sichtbar. Wird verwendet, um zuvor ausgeblendete Zeilen anzuzeigen.

Eigenschaften:

• Arbeitsmappen-ID (erforderlich): Zielarbeitsmappe (z. B.) workbook_id

• Blattname (erforderlich): Zielarbeitsblatt (z. B. „Sheet1")

• Startzeile (erforderlich): Erste Zeilennummer, die eingeblendet werden soll (Excel-Nummerierung beginnt bei 1)

• Endzeile (optional): Letzte Zeilennummer, die eingeblendet werden soll. Wenn leer, wird nur die Startzeile sichtbar gemacht

Bewährte Methoden und Einschränkungen

Verwaltung von Arbeitsmappen-IDs

• Speichern Sie Arbeitsmappen-IDs in beschreibenden Variablen (z. B.,) sales_workbook report_file

• Verwenden Sie dieselbe Kennung für mehrere Aktionen in derselben Arbeitsmappe

• Erstellen oder öffnen Sie immer eine Arbeitsmappe, bevor Sie Datenoperationen ausführen

Spezifikationen für den Bereich

• Verwenden Sie exakte Bereiche („A1:B10") für präzise Datenoperationen

• Verwenden Sie Spaltenbereiche („A:B“), wenn Sie mit ganzen Spalten arbeiten

• Verwenden Sie Zeilenbereiche (“ 1:3 „) für Kopf- oder Übersichtsoperationen

• Lassen Sie den Bereich leer, um ganze Blätter zu verarbeiten

Optimierung der Leistung

• Lesen Sie nach Möglichkeit ganze Bereiche statt einzelner Zellen

• Batch-Schreiboperationen unter Verwendung von Datentabellen anstelle von Schreibvorgängen einzelner Zellen

• Speichern Sie Arbeitsmappen erst, wenn alle Änderungen abgeschlossen sind

Einschränkung

Die Dateikompatibilität ist nur auf das moderne Excel-Format (.xlsx) beschränkt. Ältere Excel-Dateien (.xls) werden nicht unterstützt.