Versions Compared

Key

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

Beschreibung

Dieser ActionHandler transformiert 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

Ereignistyp

jeder Typ

...

beliebiger Name

...

Parameter

'fileName' definiert

Parameter

Beschreibung

Gültige Beispiele

FileName

fileName

Dieser Parameter wird verwendet, um den Namen des

Excel-

Dokuments festzulegen, einschließlich

des

dem Dateiformat (.xlsx)

-doctype.Image Removed

csvPrefix

'csvPrefix' definiert ein Präfix, das mit dem Anfang des Namens

.

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

zusammengeführt

angehängt wird. Es können auch Prozessvariablen

können ebenfalls

verwendet werden. 
Zum Beispiel.:

  • ${SYS.PROCESSINSTANCE_ID}

  • ${SYS.NODE_ID}

Image Removed

prefix_

csvSuffix

'csvSuffix' definiert

Dieser Parameter wird verwendet, um ein Suffix festzulegen, das

mit

dem

Ende

Namen des

Namens des

csv-Dokuments

zusammengeführt

am Ende hinzugefügt wird. Es können auch Prozessvariablen

können ebenfalls

verwendet werden.
Zum Beispiel.:

  • ${SYS.PROCESSINSTANCE_ID}

  • ${SYS.NODE_ID}

Image Removed

_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

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.

...