Versions Compared

Key

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

...

Beschreibung

This Dieser ActionHandler transforms an wandelt ein Excel(.xlsx) document into one or more CSV documents, depending on the number of sheets in the Excel document. The Excel document has to be attached to the process-instance and the generated files will also be attached to it. If the Excel document contains only one sheet, the generated document will inherit its name, otherwise, each CSV document will be named like the sheet it represents.

...

-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

Code Block
com.dooris.bpm.actionhandler.Excel2CSVHandler

...

Parameter

Parameter

Description

Beschreibung

Valid examples

Gültige Beispiele

fileName

This parameter is used to set the name of the document, including the

Dieser Parameter wird verwendet, um den Namen des Dokuments festzulegen, einschließlich dem Dateiformat (.xlsx)

-doctype

.

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.

csvPrefix

This parameter is used to set a prefix, which will be merged with the beginning of the csv-document's name. Process-variables can also be used. 
E.g

/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

This parameter is used to set a suffix, which will be merged with the end of the csv-document's name. Process-variables can also be used.
E.g.

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

 

Example:

...

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

Valid examples

Gültige Beispiele

fileName

example.xlsx

csvPrefix

prefix_

csvSuffix

_suffix

When we open the process instance, we will upload the Excel document via the Documents section.

...

We will upload the Excel file via the Upload file(s) buttonBeim Vorgangsstart wird die Excel-Datei “example.xlsx” im Reiter “Dokumente” hochgeladen.

...

You can see that the Excel document is now reachable through the process instance.

...

The actionhandler will be executed once the process instance is started. You can see that, the Excel file which has two sheets now converted to two csv files.

...

You can reach the original file and the created files under the Documents section.

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.

...