Um Microsoft Excel®-Arbeitsmappen als Teil einer Kette zu verwalten, fügen Sie einen Schritt hinzu, der einen Microsoft Excel-Verbindungsbefehl enthält.
Hinweis: Der Microsoft Excel Connector unterstützt makroaktivierte Excel-Arbeitsmappendateien (XLSM), führt jedoch keine VBA-Makros (Virtual Basic for Applications) oder ereignisbasierte Makros wie Workbook Open, BeforeSave oder SheetCalculate aus.
Um diese Befehle zu aktivieren, erstellt ein IT-Administrator zunächst einen Microsoft Excel Connector.
Arbeitsmappe aus Dateien erstellen
Um eine Excel-Arbeitsmappe mit Blättern zu erstellen oder zu aktualisieren, die auf Daten aus Dateien mit durch Begrenzer getrennten Werten basieren, verwenden Sie den Befehl Arbeitsmappe aus Dateien erstellen.
Bitte beachten Sie, dass Sie je nach Konfiguration Ihres Anschlusses zwei Ausgabeoptionen haben:
- Wenn Sie einen GroundRunner verwenden, geben Sie ein Javascript Object Notation (JSON) Objekt ein.
- Wenn Sie einen CloudRunner verwenden, geben Sie dessen Befehlsausgaben oder Ressourcen innerhalb der Kette an.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Dateien |
Geben Sie die Dateien an, die als separate Blätter in der Arbeitsmappe erstellt werden sollen:
- Für Dateien, die auf Ausgängen oder Ressourcen innerhalb der Kette basieren, klicken Sie auf Add für jede Datei, wählen Sie ihren Ausgang oder ihre Ressource und geben Sie den Namen ihres Blattes ein (bis zu 31 Zeichen).
Tipp: Um eine Datei von einem Netzwerkspeicherort abzurufen, verwenden Sie den File Utilities Connector's Get file Befehl früher in der Kette.
- Um die Dateien als JSON zu spezifizieren, wählen Sie Variable aktivieren, und geben Sie das JSON ein oder wählen Sie das JSON-Objekt aus der Ausgabe eines früheren Befehls. Formatieren Sie das JSON wie folgt:
[
{"file": "fullPathToFile_1", "name": "sheetName_1"},
{"file": "fullPathToFile_2", "name": "sheetName_2"}
] Hinweis: Um die Ausgabedatei eines vorherigen Befehls in das JSON einzubeziehen, geben Sie den vollständigen Pfad zu ihrem Speicherort im GroundRunner Verarbeitungsordner an.
|
| Trennzeichen |
Wählen Sie das in den Dateien verwendete Begrenzungszeichen. |
| Name der Arbeitsmappe |
Um eine neue Arbeitsmappe auf der Grundlage der Dateien zu erstellen, geben Sie einen eindeutigen Namen ein, um sie zu identifizieren. Hinweis: Der Befehl fügt automatisch die Erweiterung .xlsx hinzu, wenn sie nicht angegeben wird. |
| Vorhandene Arbeitsmappe |
Wenn Sie die Daten der Dateien nicht in eine neue, sondern in eine bestehende Arbeitsmappe einfügen möchten, wählen Sie die zu aktualisierende Arbeitsmappendatei aus. Jedes Blatt mit einem Namen, der in Files eingegeben wurde, wird überschrieben. Wichtig: Wenn Sie diesen Befehl für eine geschützte Datei verwenden, ist die resultierende Arbeitsmappe nicht geschützt. Das bedeutet, dass Sie die Verschlüsselung manuell wieder hinzufügen müssen, wenn Sie mit einer geschützten Datei arbeiten. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| XLSX-Arbeitsmappe |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Befehl erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Blätter auflisten
Um eine JSON-Liste aller Blätter in einer Excel-Arbeitsmappe zu erstellen, verwenden Sie den Befehl List Sheets.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei der Arbeitsmappe |
Geben Sie die XLS- oder XLSX-Arbeitsmappe ein, deren Blätter aufgelistet werden sollen. |
| Kennwort |
Wenn Arbeitsmappendatei eine passwortgeschützte XLSX-Arbeitsmappe ist, geben Sie ihr Passwort ein. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Blätter JSON |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Befehl erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |
Arbeitsblatt zu CSV
Um die Daten im Blatt einer Excel-Arbeitsmappe in eine Tabellendatei zu konvertieren, verwenden Sie den Befehl Worksheet to CSV.
Hinweis: Der Befehl Worksheet to CSV extrahiert die zuletzt berechneten Werte im Arbeitsblatt Bei Arbeitsblättern mit deaktivierten automatischen Berechnungen sollten Sie die Werte manuell berechnen und speichern, bevor die Kette ausgeführt wird, um die Genauigkeit zu gewährleisten.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei der Arbeitsmappe |
Geben Sie die XLS- oder XLSX-Arbeitsmappe mit dem Blatt ein, das in eine Tabellendatei konvertiert werden soll. |
| Kennwort |
Wenn Arbeitsmappendatei eine passwortgeschützte XLSX-Arbeitsmappe ist, geben Sie ihr Passwort ein. |
| Trennzeichen |
Wählen Sie das Trennzeichen, das in der Ausgabedatei verwendet werden soll. |
| Blattname |
Geben Sie den Namen des Blattes in der zu konvertierenden Arbeitsmappe ein. Um das Blatt stattdessen über seinen Index zu identifizieren, lassen Sie es leer. |
| Blattindex |
Geben Sie die Indexposition des Blatts in der zu konvertierenden Arbeitsmappe ein, wobei 1 für das erste Blatt und -1 für das letzte Blatt steht. Um das Blatt stattdessen durch seinen Namen zu identifizieren, lassen Sie es leer. |
| Startzelle |
Geben Sie die Zelle sowohl in der ersten Zeile als auch in der ersten Spalte der zu konvertierenden Daten des Blattes ein. |
| Ende Spalte |
Geben Sie in A1-Notation den Buchstaben der Spalte ein - z. B. A, B oder C, ohne Zeilennummer -, an der die zu konvertierenden Daten enden. Hinweis: Der Befehl ignoriert alle Daten auf dem Blatt nach dieser Spalte. |
| Ende der Reihe |
Geben Sie in A1-Schreibweise die Nummer der Zeile (z. B. 10, 200, 3000) ohne den Spaltenbuchstaben ein, in der die zu konvertierenden Daten enden. Um die Zeile zu ignorieren, geben Sie 0 ein. Hinweis: Der Befehl ignoriert alle Daten in der Spalte nach dieser Zeile. |
| Formatierte Zellwerte verwenden |
Aktivieren Sie dieses Kontrollkästchen, um die Anzeigewerte der Zellen anstelle der Rohwerte zu konvertieren, z. B. für die Behandlung von Datum und Uhrzeit. |
| Vorschau der Ergebnisse |
Um eine Vorschau der Ausgabedatei zu aktivieren, markieren Sie dieses Feld. |
| Streaming-Modus |
Gilt nur für große XLSX-Dateien. Empfohlen für Dateien über 20 MB. Liest die Datei in kleineren Datenfenstern, um den Speicherbedarf zu verringern. Einige Formeln, insbesondere solche, die auf weiter entfernte Zellen in der Datei verweisen, funktionieren möglicherweise nicht korrekt, wenn diese Einstellung in Verbindung mit der Option "Formatierte Werte" aktiviert ist. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Ausgabe CSV |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Befehl erfolgreich |
| 1 |
Fehler |
Allgemeines Versagen |