Excel2CSVHandler

Beschreibung

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 Tabellenblätter im Excel-Dokument. Das Excel-Dokument muss 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 Tabellenblatt enthält, entspricht 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

com.dooris.bpm.actionhandler.Excel2CSVHandler

Parameter

Parameter	Beschreibung	Gültige Beispiele

Parameter	Beschreibung	Gültige Beispiele
`fileName`	Dieser Parameter wird verwendet, um den Namen des Dokuments festzulegen, einschließlich dem Dateiformat (.xlsx).	`example.xlsx`
`pathToSave`	Legt den Pfad fest, in dem die konvertierte Datei gespeichert wird. Wenn hier nichts angegeben wird, wird die Datei direkt an den Vorgang angehängt.	`/meinOrdner/`
`csvPrefix`	Dieser Parameter wird verwendet, um ein Präfix zu setzen, der vor dem dem Namen des csv-Dokuments 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 dem Namen des csv-Dokuments am Ende hinzugefügt wird. Es können auch Prozessvariablen verwendet werden. Zum Beispiel.: `${SYS.PROCESSINSTANCE_ID}` `${SYS.NODE_ID}`	`_suffix`

Beispiel:

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

Parameter	Gültige Beispiele
`fileName`	`example.xlsx`
`csvPrefix`	`prefix_`
`csvSuffix`	`_suffix`

Beim 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 wird ausgeführt, sobald der Vorgang gestartet 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.