Zum Hauptinhalt springen

Konvertieren nach XLSX

Aktuelle Konfiguration des Tasks „In XLSX konvertieren“ im Workflow Designer

Der Task Konvertieren nach XLSX führt die umgekehrte Operation zum Task In CSV konvertieren durch: Er nimmt eine Daten-Datei im CSV-Format und konvertiert sie in eine Excel-Tabellenkalkulation (.xlsx). Dies ist besonders nützlich, um Berichte oder Dateien zu erstellen, die von Endbenutzern mit Software wie Microsoft Excel leicht einsehbar, formatierbar und bearbeitbar sein müssen.

Konfiguration​

Die Konfiguration des Tasks erfordert die Angabe der Quell-CSV-Datei und des verwendeten Trennzeichens sowie optional ein Zielverzeichnis für die Excel-Datei.

  • Datei zum Importieren: Hier muss der vollständige Pfad zur zu konvertierenden CSV-Datei eingegeben werden. Dies kann ein statischer Wert oder ein dynamisches Parameter sein.
  • Input CSV Trennzeichen: Dieses Feld ist entscheidend für die korrekte Interpretation der Quelldatei. Hier muss das Zeichen eingegeben werden, das die eingehende CSV-Datei verwendet, um ihre Werte zu trennen.
  • Der Standardwert ist das Komma (,).
  • Wenn die Quelldatei ein anderes Trennzeichen verwendet (z. B. Semikolon), ist es unerlässlich, dies korrekt in diesem Feld einzustellen. Eine falsche Einstellung führt zum Fehlschlagen der Konvertierung oder zur Erzeugung einer Excel-Datei, bei der alle Daten fehlerhaft in einer einzigen Spalte gruppiert sind.
  • Pfad (Checkbox): Durch das Auswählen dieser Option kann ein benutzerdefiniertes Ziel für die Ausgabedatei festgelegt werden; andernfalls wird ein Standardziel verwendet. Bei Auswahl werden die folgenden Felder angezeigt:
  • Ausgabepfad: Hier muss der Pfad des Ordners eingegeben werden, in dem die konvertierte Excel-Datei gespeichert werden soll.
  • Verzeichnis erstellen, falls nicht vorhanden: Wenn aktiviert, erstellt es automatisch das Zielverzeichnis, falls es nicht existiert. Ist es deaktiviert, schlägt der Task fehl, wenn das Verzeichnis nicht vorhanden ist.

Standardziel​

Das Standardverhalten hängt davon ab, wie die Quelldatei bereitgestellt wird:

  • Fall 1: Eingabe über einen Parameter vom Typ „Datei“ Wenn der Datei Quelle über einen dynamischen Parameter aus einem vorhergehenden Task oder aus den Workflow-Parametern übergeben wird, wird die konvertierte XLSX in ein vom System verwaltetes Verzeichnis gespeichert.
  • Fall 2: Eingabe über manuell eingegebenen Pfad Wenn im Feld „Datei zum Importieren“ direkt der vollständige Pfad zu einer vorhandenen Datei eingegeben wird (z. B. /daten/input/report.csv), wird die konvertierte XLSX standardmäßig im selben Verzeichnis wie die Quelldatei gespeichert (also in /daten/input/).

Ausgabe-Parameter​

Nach Abschluss der Konvertierung stellt der Task die folgenden Parameter bereit:

  • file: Gibt den vollständigen Pfad zur gerade erstellten XLSX-Datei zurück (z. B. /pfad/output/konvertierte_daten.xlsx). Dieser Parameter ist ideal, um die Datei an nachfolgende Tasks zu übergeben, wie zum Beispiel einen E-Mail senden mit Anhang.
  • filename: Gibt nur den Namen der generierten XLSX-Datei zurück (z. B. konvertierte_daten.xlsx).
  • result: Gibt den allgemeinen Status des Konvertierungsvorgangs zurück (z. B. „Success“ oder eine Fehlermeldung).
  • resultJson: Stellt das Ergebnis der Task-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.