Versions Compared

Key

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

...

File extension is not needed within the target parameter

Daher kann der Benutzer Excel-Dateien mit unterschiedlichen Namen aus derselben Excel-Vorlage erstellen.

Parameter

Default value

Description

Valid examples

template

Status
titlemandatory

Dieser Parameter wird benutzt, um den Pfad zum Template festzulegen, damit der ActionHandler danach im resources Order suchen kann.

Um die erstellte Datei umzubenennen kann das Template selbst eine Prozessvariable enthalten.

Vorausgesetzt das Template, Parameter hat die folgenden Werte:

template=${SYS.PROCESSINSTANCE_NAME}_report.xlsx.

Im Zielordner wird die Datei entsprechend gesucht.

  1. Der ExcelTemplateHandler sucht nach dem Template ${SYS.PROCESSINSTANCE_NAME}_report.xlsx.

  2. Wenn es nicht möglich ist, das jeweilige Dokument zu finden, wird die Prozessvariable SYS.PROCESSINSTANCE_NAME als Dokumentenname benutzt.

  3. Nur dann wird der ExcelTemplateHandler nach dem Template suchen 8D-ProblemSolving_report.xlsx (8D-ProblemSolving ist der herangezogene Name aus ${SYS.PROCESSINSTANCE_NAME}).

Info

Um auf den Abschnitt ‘Resources’ in der 'Administration' zuzugreifen, schauen Sie bitte nach: Roles

${processInstanceId}_8D-report.xlsx


The handler supports .xlsx and .xlsm file extensions

overwriteExisting

false

Dieser Parameter wird verwendet, um zu entscheiden, ob die Dokumente überschrieben werden sollen, wenn der Prozess durch eine Schleife ausgeführt wird. Wenn das ursprüngliche Template benötigt wird, sollte der Parameter false sein.

true

documentPrefix

Der documentPrefix kann so verwendet werden, dass erstellte Dokumente immer den angegebenen Wert vor dem Vorlagennamen haben.

mydocumentprefix

removeEmptyTableRows

false

Wenn der Wert auf true gesetzt ist, werden alle Tabellenzeilen im xlsx-Template gelöscht, wenn die Variable in der ersten Spalte fehlt oder leer ist. Dadurch können unschöne leere Zeilen in dynamischen Inhalten vermieden werden (DOMRepeater).

true

interpretNumbersAsBoolean

false

Es kann entweder true oder false sein. Wenn dieser Wert auf true gesetzt ist, werden Prozessvariablen (die mit "bool" beginnen) wie folgt geändert: 

  • baa1 → true (Im Dokument: true)

  • boolbaa1 → true (Im Dokument:: yes)

  • boolbaa1 → 1 (Im Dokument:: yes)

  • bobbb1 → false (Im Dokument: false)

  • boolbbb1 → false (Im Dokument: no)

  • boolbbb1 → 0 (Im Dokument:: no)

true

interpretBooleanAsHuman

false

Dieser Parameter wird genutzt, um zu entscheiden, ob ein Boolean (true oder false) mit “Ja oder Nein“ ausgetauscht werden sollte. Wird diese Variable zu true gesetzt, werden Booleans zu “Ja und Nein” geändert

true

target

This parameter is used to determine the document name in the destination folder. This procedure is useful if the name of the created Word document should be different from the template name. The target parameter can contain process variables.

Suppose the user wanted to generate two reports in English and German. The Word template in the resource folder has the following name Dieser Parameter wird verwendet, um den Dokumentnamen im Zielordner zu bestimmen. Diese Vorgehensweise ist nützlich, wenn der Name des erstellten Word-Dokuments vom Vorlagennamen abweichen soll. Der Zielparameter kann Prozessvariablen enthalten.

Angenommen, der Benutzer möchte zwei Berichte in Englisch und Deutsch erstellen. Die Word-Vorlage im Ressourcenordner hat den folgenden Namen: ${SYS.PROCESSINSTANCE_NAME}_report_${language}. With the target parameter, the name of the Word document can now be changed to e.gMit dem target-Parameter kann nun der Name des Word-Dokuments geändert werden, z.B. target=XY-Report_DE. Therefore the user can create Excel files with different names from the same Excel template.

Note
Note

Die Dateierweiterung ist innerhalb des Zielparameters nicht erforderlich.

target=${processInstanceId}_${processInstanceName}_report

locale

enWith

this parameter all system supported languages can be given in short form(e.gMit diesem Parameter können alle vom System unterstützten Sprachen in Kurzform angegeben werden (z.B. en, de). This leads to, that all system-generated words (e.gDies führt dazu, dass alle vom System generierten Wörter (z.B. boolean Yes/No) are translatedübersetzt werden.

de

...

Setup the process

...

Aufbau

Um den Action Hander einzurichten, sind die folgenden Schritte erforderlich:

  1. Richten Sie den Prozess ein

    1. Erstellen oder Hochladen eines einfachen Workflows

      View file
      nameSimpleModel-version-2.zip

    2. Import form Formular Importieren

      View file
      name20240130_SimpleModel_v1.json

  2. Upload the template in tenant admin resources Laden Sie die Vorlage in den Mandantenadministratorressourcen hoch.

    View file
    nametemp.xlsx

After the setup you should be able to seeNach dem Setup sollten Sie Folgendes sehen können:

...

Use case 1: Create a simple template

...