RepeatingWordTemplateHandler

Beschreibung

Der ActionHandler RepeatingWordTemplateHandler ermöglicht es, ein Word-Dokument für mehrere Prozessvariablen zu erstellen. Es handelt sich um eine Erweiterung des https://tim-doc.atlassian.net/wiki/spaces/DE/pages/228066803. Die Prozessvariablen müssen mit einer Zahl in eckigen Klammern indiziert werden (z.B. Variable[0], Variable[1], Variable[3],...). Im Word Dokument wird das Textformularfeld mit dem Inhalt ${Variable} durch die Werte der indizierten Variablen ersetzt. Für jedes indizierte Feld wird ein separates Dokument erstellt. Es ist auch möglich, alle erstellten Dokumente zusammenzuführen.

Klasse

com.dooris.bpm.actionhandler.RepeatingWordTemplateHandler

Parameter

Parameter	Standardwert	Beschreibung	Gültige Beispiele

Parameter	Standardwert	Beschreibung	Gültige Beispiele
`template`		Dieser Parameter wird verwendet, um den Pfad zur Vorlage festzulegen, damit der ActionHandler im Ordner resources danach suchen kann. Um auf den Abschnitt "Ressourcen" unter "Administration" zuzugreifen, lesen Sie bitte: https://tim-doc.atlassian.net/wiki/spaces/DE/pages/228525411	`/WordTemplate/dokument.docx`
`repeat`		Dieser Parameter sollte auf `true` gesetzt werden, um die Wiederholung der Dokumentenerstellung zur ermöglichen.	`true`
`mergeDocumentName`		Dieser Parameter wird verwendet, um den Dateinamen für die zusammengeführten Dokumente festzulegen.	`Dokument`
`merge`	`false`	Dieser Parameter wird verwendet, um zu entscheiden, ob die Dokumente zusammengeführt werden sollen. Alle Dokumente werden zu einem zusammengeführt, wenn dieser Parameter auf `true`gesetzt ist.	`true`
`repeatCounter`		Dieser Parameter enthält eine Variable mit einer Zahl. Diese legt fest, wie viele Indizes es gibt und wie viele Dokumente erzeugt werden sollen.	`counter`
`pdf`		Es kann entweder sein `true` oder `false`. Wenn die Vorlagen in PDFs konvertiert werden sollen, muss der Wert auf true gesetzt werden.	`true`

Beispiel:

Nachfolgend wird die Verwendung des ActionHandlers kurz erklärt.

Zuerst wird im Prozessmodell der ActionHandler in der Aufgabe “Task1” eingerichtet.

Folgende Parameter wurden in diesem Beispiel verwendet:

Parameter	Beschreibung	Gültige Beispiele

Parameter	Beschreibung	Gültige Beispiele
`template`	Hier wird der Name der Word-Vorlage festgelegt, die in den Ressourcenordner hochgeladen wird.	`test_template.docx`
`repeat`	Hier `true` muss eingegeben werden, da sonst der ActionHandler nicht ausgeführt wird.	`true`
`repeatCounter`	Dieser Parameter wird verwendet, um die Indexnummer festzulegen, und Sie müssen diese im Voraus eingeben. Außerdem erstellen wir eine Zählervariable in der Smartform, damit der Benutzer die Nummer eingeben kann.	`${counter}`
`pdf`		`true`
`merge`		`true`
`mergeDocument`		`MergedDoc`

Weiterhin wird eine Word-Vorlage benötigt (Ausführliche Erklärung zur Erstellung der Vorlage enthält der WordTemplateHandler) . Im Vorlagendokument wird die Variable department verwendet und für jede Abteilung, die im Formular eingegeben wird, soll ein Word-Dokument generiert werden. Diese Vorlage sollte in der Administration in den Ressourcen hochgeladen werden.

Zu guter Letzt wird eine Smartform benötigt. Diese enthält drei Eingabefelder mit den indizierten Variablen department[0], department[1]und der Variable counter.

Beim Starten des Vorgangs müssen die Felder in der Smartform ausgefüllt werden.

Nach einer erfolgreichen Ausführung können Sie sehen, dass im Reiter "Dokumente" des Vorgangs drei Dokumente sichtbar sind. Das erste Dokument enthält die Abteilung mit der ersten Indexnummer ([0]). Das zweite Dokument die Abteilung mit der zweiten Indexnummer ([1]). Die zusammengeführte Version dieser beiden Dokumente ist ebenfalls verfügbar.

Den Inhalt der ersten beiden Dokumente können Sie hier einsehen. Das dritte Dokument ist die zusammengeführte Version der ersten beiden Dokumente.

Für die Marketingabteilung	Für die Finanzabteilung:

Für die Marketingabteilung	Für die Finanzabteilung: