Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Dieser ActionHandler wandelt ein Excel(.xlsx)-Dokument in ein oder mehrere CSV-Dokumente um, . Die Anzahl der csv-Dateien ist abhängig von der Anzahl der Blätter Tabellenblätter im Excel-Dokument. Das Excel-Dokument muss an die Prozessinstanz angehängt werden und die generierten Dateien werden ebenfalls an diese vor Ausführung des ActionHandlers zu einem Vorgang hochgeladen werden. Nach dessen Ausführung werden die generierten csv-Dateien direkt im Dokumentenreiter zum Vorgang angehängt. Wenn das Excel-Dokument nur ein Blatt Tabellenblatt enthält, erbt das generierte Dokument seinen Namen, andernfalls wird jedes CSV-Dokument wie das Blatt benannt, das es darstelltentspricht der Name der csv-Datei dem Namen der Excel-Datei. Sobald mehrere Tabellenblätter vorhanden sind, wird der jeweilige Name des Tabellenblatts in den Namen der entsprechenden csv-Datei übernommen.

...

Klasse

Code Block
com.dooris.bpm.actionhandler.Excel2CSVHandler

...

Parameter

Parameter

Beschreibung

Gültige Beispiele

fileName

Dieser Parameter wird verwendet, um den Namen des Dokuments festzulegen, einschließlich

des

dem Dateiformat (.xlsx)

-Doctype

.

example.xlsx

csvPrefix

Dieser Parameter wird verwendet, um ein Präfix zu setzen,

das mit dem Anfang des Namens

der vor dem dem Namen des csv-Dokuments

zusammengeführt

angehängt wird. Es können auch Prozessvariablen verwendet werden. 
Zum Beispiel.:

  • ${SYS.PROCESSINSTANCE_ID}

  • ${SYS.NODE_ID}

prefix_

csvSuffix

Dieser Parameter wird verwendet, um ein Suffix festzulegen, das

mit

dem

Ende des Namens

Namen des csv-Dokuments

zusammengeführt

am Ende hinzugefügt wird. Es können auch Prozessvariablen verwendet werden.
Zum Beispiel.:

  • ${SYS.PROCESSINSTANCE_ID}

  • ${SYS.NODE_ID}

_suffix

 

Beispiel:

Wir haben einen einfachen Anwendungsfall für diesen Actionhandler. Wir haben den excel2CSVhandler für die Aufgabe exceltoCSV Nachfolgend wird der ActionHandler anhand eines einfachen Prozessbeispieles mit einer Aufgabe erläutert. Diese Aufgabe heißt “exceltoCSV” und dort wird der excel2CSVHandler wie folgt implementiert:

Parameter

Gültige Beispiele

fileName

example.xlsx

csvPrefix

prefix_

csvSuffix

_suffix

Wenn wir die Prozessinstanz öffnen, laden wir das Excel-Dokument über den Abschnitt Dokumente hoch.

...

Wir laden die Excel-Datei über die Schaltfläche Datei(en) hochladen hoch.

...

Sie können sehen, dass das Excel-Dokument jetzt über die Prozessinstanz erreichbar istBeim Vorgangsstart wird die Excel-Datei “example.xlsx” im Reiter “Dokumente” hochgeladen.

...

Sobald die Excel-Datei hochgeladen ist, kann der Vorgang im Reiter “Eigenschaften” über den Button “Vorgang starten” gestartet werden.

...

Der Actionhandler ActionHandler wird ausgeführt, sobald die Prozessinstanz der Vorgang gestartet wird. Sie können sehen, dass die Excel-Datei mit zwei Blättern jetzt in zwei CSV-Dateien konvertiert wurde.

...

Sie erreichen die Originaldatei und die erstellten Dateien im Abschnitt Dokumente.

wurden. In den gestarteten Vorgängen können im Reiter “Dokumente” zum Vorgang sowohl die ursprüngliche Excel-Datei als auch die hinzugefügten csv-Dateien eingesehen werden.

...