Versions Compared

Key

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

...

Nach dem Setup sollten Sie Folgendes sehen können:

...

...

Beispiel 1:

...

  1. Select the process,

  2. Upload the images in documents (upload at least an image called “im1.png” and another one )

    im2.pngImage Removedim1.pngImage Removed
  3. Start a new instance with the below template

...

Ein einfaches Template erstellen

  1. Wählen Sie den Prozess aus,

  2. Laden Sie die Bilder in den Dokumenten hoch (laden Sie mindestens ein Bild mit dem Namen "im1.png" und ein weiteres hoch)

    im2.pngImage Addedim1.pngImage Added
  3. Starten Sie eine neue Instanz mit dem unten gezeigten Template

...

Die generierte Datei befindet sich in der Rubrik Dokumente zusammen mit den Bildern. Die generierte Datei sollte wie folgt aussehen:

View file
nameprefix_target.xlsx
In the above example we have included:

  1. Variable substitution,

  2. Conditional formatting,

  3. Adding single images by name, and all images

  4. Using excel functions,

  5. Document prefix,

  6. Document target,

  7. Interpreting number as boolean, boolean as human and translation

Note

The variables must be the same as in the Excel template.

Calling the execution of ExcelTemplateHandler from a REST api call endpoint



The ExcelTemplateHandler can be called from rest api using the below endpointIm obigen Beispiel haben wir aufgenommen:

  1. Substitution von Variablen,

  2. Formattierung anhand von Bedingungen

  3. Hinzufügen einzelner Bilder nach Namen und aller Bilder

  4. Benutzung von Excel-Funktionen

  5. Präfix des Dokuments,

  6. Ziel des Dokuments,

  7. Interpretieren von Zahlen als boolesch, humane Auswertung eines Boolean und Übersetzung

Note

Die Variablen müssen mit denen in der Excel-Vorlage übereinstimmen.

...

Aufrufen der Ausführung von ExcelTemplateHandler über eine REST-Schnittstelle

Der ExcelTemplateHandler kann über die REST-API mit dem folgenden Endpunkt aufgerufen werden.

Code Block
POST: [your server url here]/tim/api/templates

{
    // Mandatory params
    "processInstanceId": [YOUR PI ID HERE],
    "template": [YOUR TEMPLATE PATH HERE],

    //Optional params
    "target": "",
    "documentPrefix": "",
    "locale": "",
    "overwriteExisting": false,
    "interpretNumbersAsBoolean": false,
    "interpretBooleanAsHuman": false,
    "removeEmptyTableRows": false,
    "open": false
}

...

Einbinden des ExcelTemplateHandlers in ein HTML-

...

Formular

The ExcelTemplateHandler can be integrated into a HTML-Form as a link, a button, or an image so that the participants can create a template at any time. For this, the following code must be integrated into the formDer ExcelTemplateHandler kann als Link, Button oder Bild in ein HTML-Formular eingebunden werden, so dass die Teilnehmer jederzeit eine Vorlage erstellen können. Dazu muss folgender Code in das Formular eingebunden werden:

Code Block
<button type="button" onbuttonclick="generateFileFromTemplate([{handler:'ExcelTemplateHandler',template:'temp.xlsx',attach:false,open:true,documentPrefix:'Prefix'}])">Generate Excel template</button>

The Das Attribut "onbuttonclick" attribute defines which functions/parameters the handler should execute. See Parameters sections above.

Important when using HTML-Forms

Normally written text will be inherited, whereas variables will be overwritten if marked as definiert, welche Funktionen/Parameter der Handler ausführen soll. Weitere Informationen finden Sie in den Abschnitten "Parameter" oben.

...

Wichtig bei der Verwendung von HTML-Formularen

Normalerweise wird geschriebener Text vererbt, während Variablen überschrieben werden, wenn sie als ${Variable-ID}. To overwrite variables with content from the HTML form, you must use the variable's ID, such as markiert sind. Um Variablen mit Inhalten aus dem HTML-Formular zu überschreiben, müssen Sie die ID der Variablen, z. B.${Variable-ID}, within the text form fields. An exception to this rule applies to radio buttons, where you should use the variable name, like in den Textformularfeldern verwenden. Eine Ausnahme von dieser Regel gilt für Optionsfelder, bei denen Sie den Variablennamen wie ${Variable-Name}, instead of the variable ID anstelle der Variablen-ID verwenden sollten.

...