Platzhalter werden für die Ersetzung von Formular- oder Systemwerten verwendet und stehen in Aktionen, Templates sowie Datenbank-Abfragen zur Verfügung.

Inhalt

Verwenden von Platzhaltern

Verwendung in Aktionen

Bei Optionsfeldern von Aktionen, die diese unterstützen, kann über das Symbol rechts die Platzhalterauswahl geöffnet werden.

Verwendung in Templates

Das Platzhaltermenü kann über den Knopf Platzhalter im Template-Editor geöffnet werden oder auch über die Tastenkombination Strg + Leerzeichenzeichentaste.

Platzhaltertypen

Formularplatzhalter

Syntax: [%<NameDesFormularelements>%]

Dieser Platzhalter wird ersetzt durch den Wert des Formularelements mit dem angegebenen Namen. Formularplatzhalter werden in Aktionen wie z.B. E-Mail, Text erzeugen, Datenbank sowie bei Templates verwendet.

Beispielsweise wird der Platzhalter [%tfVorname%] durch den Wert des Eingabefelds mit Namen Vorname ersetzt.

Formularplatzhalter für Wiederholungen

Syntax: [%<NameDesFormularelements>_<index>%]

Standardmäßig werden die Platzhalter von wiederholenden Elementen kommagetrennt mit allen Werten aufgelöst. Im Workflow kann über einen Index im Platzhalter auf einzelne Wiederholungen zugegriffen werden. Der Index beginnt bei Null und für jede Wiederholung um Eins hochgezählt. Für alle Wiederholungen eines Formularelements müssen die Platzhalter entsprechend der maximalen Anzahl der Wiederholungen (Option "Max. wdh.") angegeben werden.

Beispielsweise werden die Wiederholungen des Platzhalters [%tfVorname%] wie folgt angegeben: [%tfVorname_0%], [%tfVorname_1%], [%tfVorname_2%], ...

Platzhalter für Fragenelemente

Um auf die Werte von Auswahlelementen mit Darstellungstyp Fragen zuzugreifen, stehen folgende Platzhalter zur Verfügung. Gibt es beispielsweise an einem Fragenelement sel1 3 Fragen Q1, Q2, Q3 mit jeweils 3 Antworten A1, A2, A3 und sind folgende Antworten ausgewählt:

Dann:

• [%sel1%] wird ersetzt durch A1;A1,A2;A1,A2,A3
• [%sel1_0%] wird ersetzt durch A1, [%sel1_1%] durch A1,A2, [%sel1_2%] durch A1,A2,A3

Funktionsplatzhalter

Funktionsplatzhalter sind eigentlich keine eigenen Platzhalter. Hier geht es eher um zusätzliche Funktionen für einen Formularplatzhalter. Ein Beispielformular zu den verfügbaren Funktionen finden Sie in den formcycle Vorlagen.

Hinweis: Die Funktionsplatzhalter sind nur für den Workflow vorgesehen. Im Formulardesigner (z.B. in Berechnungselementen oder Bedingungen )werden diese nicht unterstützt.

Syntax: [%<Formularfeldname>.<Funktion>(<Parameter>)%]

lst("wert")

Syntax: [%element.lst("wert")%]

Die Funktion lst kann nur auf Auswahlelemente angewendet werden, die ihre Werte aus einer Datenquelle beziehen und ermöglicht den Zugriff auf die Werte beliebiger Spalten (Datenquelle / Datenbank). So kann z.B. realisiert werden, dass, wenn in einer Auswahl "Frau" ausgewählt wurde, über die Funktion lst ein anderer Wert zurückgegeben wird. Zum Beispiel "Sehr geehrte Frau".

Zu diesem Thema finden sie  auch ein kurzes Video.

Beispiel Datenquelle/Designer/Workflow:

Hat die Datenquelle keinen Spaltenname, muss col0, col1, col2 etc. verwendet werden!

lsttitle()

Syntax: [%element.lsttitle()%]

Die Funktion lsttitle gibt bei Auswahlelementen, den Werte des Title zurück. Im Gegensatz zu lst wird hier keine Datenquelle als Basis benötigt. Aber auch hier kann das Beispiel "Sehr geehrte Frau" umgesetzt werden.

Beispiel Designer/Workflow:

lsttxt()

Syntax: [%element.lsttxt()%]

Die Funktion lsttxt gibt bei Auswahlelementen, den Werte des Auswahltextes zurück. Im Gegensatz zu lst wird hier keine Datenquelle als Basis benötigt.

Beispiel Designer/Workflow:

Weitere Funktionsplatzhalter

cnt()

Syntax: [%element.cnt()%]

Liefert die Anzahl der erzeugten Elemente eines auf wiederholt geschalteten Elements.

con("wert")

Syntax: [%element.con("wert")%] oder [%element.con("wert" | "wert" | "wert")%]

Liefert 1, wenn der Wert des Elements gleich einem der in der Funktion übergebenen Werte ist, andernfalls 0.

empty()

Syntax: [%element.empty( )%]

Liefert 1 zurück, wenn das Element keinen Wert hat, andernfalls 0.

rep("wert" # "wert")

Syntax: [%element.rep("quelle" # "ziel")%] oder [%element.rep("quelle1" | "quelle2" # "ziel1" | "ziel2")%]

rep steht für Replace. Der erste Wert wird durch den zweiten Wert (ziel) ersetzt. Dabie ist die "#" das Trennzeichen zwischen den Schlüsseln und Werten, welche die zu ersetzenden Paare angibt.

Beispiel 1: 

Ist der Wert des Elements "on", so wird er durch "x" ersetzt.

element.rep("on" # "x") 

element.rep("Frau" | "Herr" # "weiblich" | "männlich") 

Spezielle Formularplatzhalter

Einige spezielle Formularplatzhalter existieren für alle Formulare:

[%xf-action%]

Der Name der Schaltfläche, die zum Absenden verwendet wurde. Kann etwa genutzt werden, um über eine Bedingung bestimmte Aktionen nur auszuführen, wenn eine bestimmte Schaltfläche gedrückt wurde.

[%lang%]

Verweist auf die Sprache, die beim Ausfüllen des Formulars verwendet wurde, z.B. de, de-CH, en oder fr-FR.

Mehrzeiligen Text (aus Editor) mit Umbrüchen einfügen

Wenn ein Editorfeld per Formularplatzhalter in z.B. einer E-Mail oder Textdatei (HTML) Aktion eingefügt wird, dann werden die Umbrüche entfernt, da hier versucht wird HTML zu interpretieren.

Um dies zu erreichen ist in der E-Mail Aktion die Quellcode-Ansichtaufzurufen. An der gewünschten Postition ist dann der folgende Abschnitt einzufügen. Der Formularplatzhalter ist dann entsprechend anzupassen:

<pre style="font-family: inherit;white-space: pre-line !important">
[%edBegruendung%]
</pre>

Bei einer Textdatei Aktion kann der HTML-Code direkt eingefügt werden.

Systemplatzhalter

Syntax: [%$<Name>%]

Dieser Platzhalter wird ersetzt durch den entsprechenden Systemwert. Aktuell stehen folgende Systemplatzhalter in Aktionen und Templates zur Verfügung.

[%$CLIENT_ID%]

Gibt die Mandant-ID des Formulars zurück.

[%$DEFAULT_MAIL_SENDER%] 7.3.0+ 

Liefert den E-Mail Absender (System) für den konfigurierten Mailserver zurück. Falls unter Mandant > Einstellungen ein eigener Mailserver konfiguriert ist, wird diese Konfiguration verwendet, sonst der System E-Mail Server.

[%$DEFAULT_MAIL_SENDERNAME%] 7.3.0+ 

Liefert den Absendername (System) für den konfigurierten Mailserver zurück. Wenn dieser nicht konfiguriert wurde, wird ein Leerstring zurückgegeben.

[%$CLIENT_MAIL_SENDER%] 7.0.4+ (veraltet)

Liefert die Mailabsenderadresse des Mandanten zurück. Wenn diese nicht konfiguriert wurde, wird ein Leerstring zurückgegeben.

[%$CLIENT_MAIL_SENDERNAME%] 7.0.4+ (veraltet)

Liefert den Mailabsendernamen des Mandanten zurück. Wenn dieser nicht konfiguriert wurde, wird ein Leerstring zurückgegeben.

[%$FORM_LINK%]

Gibt die URL des Formulars zurück.

[%$FORM_PROCESS_LINK%]

Absolute Internetadresse zur Wiederanzeige eines abgesendeten Formulars, vorausgefüllt mit den Daten des Vorgangs. Ein Login ist nicht zwingend erforderlich, es sei denn, der aktuelle Status des Formulars erfordert dies.

[%$FORM_REVIEW_LINK%]

Absolute Internetadresse zur Wiederanzeige eines abgesendeten Formulars, vorausgefüllt mit den Daten des Vorgangs. Ein Login ist zwigend erforderlich.

[%$FORM_VERIFY_LINK%]

Gibt die einmalige Bestätigungs-URL zurück (nötig für Double-Opt-In).

[%$FORM_INBOX_NAME%]

Gibt den Namen des Postfachs zurück, indem sich der Vorgang derzeit befindet.

[%$FORM_INBOX_LINK%]

Gibt den Link des Postfachs zurück, indem sich der Vorgang derzeit befindet.

[%$FORM_INVITE_LINK%]

Gibt den Einladungslink zum Formular zurück.

[%$FORM_HISTORY_HTML%] 7.2.0+ 

Gibt den Verlauf eines Formulars als (HTML-) Tabelle zurück.

[%$PROCESS_ID%]

Gibt die aktuelle Prozess-ID des Vorgangs zurück.

[%$PROJECT_ALIAS%]

Alias des derzeitigen Formulars.

[%$PROJECT_ID%]

Gibt die Formular-ID zurück.

[%$PROJECT_TITLE%]

Ab 7 heißt [%$PROJECT_NAME%] nun [%$PROJECT_TITLE%] .

Titel des derzeitigen Formulars.

[%$RECORD_ID%]

ID des derzeitigen Vorgangs.

[%$RECORD_READ%]

Rückgabe ob der derzeitige Vorgang gelesen wurde. Liefert Boolean (true/false) zurück.

[%$RECORD_UNREAD%]

Rückgabe ob der derzeitige Vorgang nicht gelesen wurde. Liefert Boolean (true/false) zurück.

[%$RECORD_ATTR.<customAttrKey>%]

 Auslesen von benutzerdefinierten Vorgangswerten (z.B. [%$RECORD_ATTR.loopCount%]). Damit können am Vorgang Werte gespeichert und in jeder Aktion darauf zugegriffen werden.

[%$SOURCE_SERVER%]

Gibt den Namen des Servers zurück, auf welchem dieser bereitgestellt und abgesendet wurde (Name des Frontend-Servers oder lokal).

[%$SOURCE_SERVER_URL%]

Gibt die URL des Servers zurück, auf welchem dieser bereitgestellt und abgesendet wurde (Name des Frontend-Servers oder lokal).

[%$STATUS_ID%]

ID des derzeitigen Status.

[%$STATUS_NAME%]

Name des derzeitigen Status.

[%$STATUS_TYPE%]

Typ des derzeitigen Status. Diese Werte sind möglich: RECEIVED (Eingegangen) und CUSTOM (Benutzerdefinierter Status, der durch den Nutzer angelegt wurde).

[%$TRIGGER%]

Kann im neuen Workflow verwendet werden, um auf die Daten zuzugreifen, die der aktuelle Trigger zur Verfügung stellt. Diese Daten werden als JSON zurückgegeben. Auf die einzelnen Werte des Triggers kann über JsonPath zugegriffen werden (siehe [%$TRIGGER.<JSON_PATH>%]).

[%$TRIGGER.<JSON_PATH>%]

Abhängig vom Typ des Triggers werden unterschiedliche Informationen über den Trigger-Platzhalter zur Verfügung gestellt. Per JsonPath kann auf spezifische Informationen des Triggers zugegriffen werden. Welche Informationen die verschiedenen Triggertypen bereitstellen, ist über die Infobox am Trigger einsehbar.

[%$COUNTER_CLIENT.<Name des Zählers>%]

Der aktuelle Wert eines Mandantzählers.

Parametrisierbare Systemplatzhalter

[%$DATE("<format>", <lang>)%]

Aktuelles Datum. Die Parameter sind optional. Ohne Parameter wird das Datum im Standardformat zurückgegeben. Durch die Parameter kann das Format und die Sprache bestimmt werden. Siehe SimpleDateFormat für mehr Informationen zum Datumsformat. Beispiel: 

[%$DATE("dd.MM.yyyy", de)%]

[%$FORM_DATE_CREATED("<format>", <lang>)%]

Erstellungsdatum des Vorgangs. Die Parameter sind optional. Ohne Parameter wird das Datum im Standardformat zurückgegeben. Durch die Parameter kann das Format und die Sprache bestimmt werden, wobei letztere sich auf die Benennung von Wochentagen und Monaten auswirkt. Siehe SimpleDateFormat für mehr Informationen zum Datumsformat. Beispiel: 

[%$FORM_DATE_CREATED("dd.MM.yyyy", de)%]

[%$FORM_DATE_MODIFIED("<format>", <lang>)%]

Datum der letzten Änderung des Vorgangs. Die Parameter sind optional. Ohne Parameter wird das Datum im Standardformat zurückgegeben. Durch die Parameter kann das Format und die Sprache bestimmt werden, wobei letztere sich auf die Benennung von Wochentagen und Monaten auswirkt. Siehe SimpleDateFormat für mehr Informationen zum Datumsformat. Beispiel: 

[%$FORM_DATE_MODIFIED("dd.MM.yyyy", de)%]

Benutzerplatzhalter

Benutzerplatzhalter können in Aktionen, Templates, Datenbank-Abfragen und direkt in Formularelementen zur Vorbefüllung des Formulars verwendet werden (siehe Abbildung).

Über verschiedene Benutzerobjekte kann auf die Informationen der angemeldeten Benutzer zugegriffen werden (Benutzerprofil). Wird der Platzhalter ohne Attribut angegeben (z.b. [%$USER%]), so werden sämtliche Benutzerinformation im JSON-Format ausgegeben.

Für die sinnvolle Verwendung von Benutzerplatzhaltern ist es nötig, dass eine Formularanmeldung am Formular konfiguriert ist. Ist dies nicht der Fall, ist das Benutzerobjekt mit einem anonymen Nutzer vorbelegt.

Benutzerobjekte

[%$USER%]

Benutzerobjekt für den Zugriff auf den aktuellen Benutzer.

[%$LAST_USER%]

Benutzerobjekt für den Zugriff auf den letzten Benutzer.

[%$INITIAL_USER%]

Benutzerobjekt für den Zugriff auf den Benutzer, der den Vorgang angelegt hat.

Attribute

Mit den Attributen eines Benutzerobjektes können gezielt Informationen über den Benutzer ermittelt werden. Die folgenden Attribute stehen bei allen Benutzern zur Verfügung. Auch wenn diese Attribute immer zur Verfügung stehen, müssen sie nicht immer einen Wert haben. Ob das Attribut einen Wert besitzt, hängt davon ab mit welcher Authentifizierungsmethode sich der Benutzer angemeldet hat.

Beispiel: Mit dem Platzhalter [%$USER.mail%] gelangt man an die E-Mailadresse des angemeldeten Benutzers.

authTypeId

ID des Authentifikators, der vom Benutzer verwendet wurde, um sich anzumelden.

displayName

Anzeigename des angemeldeten Benutzers

familyName

Nachname des angemeldeten Benutzers

firstName

Vorname des angemeldeten Benutzers

gender

Geschlecht des angemeldeten Benutzers

groups

Namen der Gruppen, denen der Benutzer angehört

id

ID des angemeldeten Benutzers. (System-ID bei FORMCYCLE-Benutzern)

linkedId

Ein Benutzerprofil kann einen sog. "linked identifier" haben. Dies ist der Identifikator eines anderen Benutzerprofils.

locale

Sprache des angemeldeten Benutzers

location

Ort des angemeldeten Benutzers

mail

E-Mailadresse des angemeldeten Benutzers

phone

Telefonnummer des angemeldeten Benutzers

pictureUrl

URL zum Profilbild des angemeldeten Benutzers

profileUrl

URL zum Profil des angemeldeten Benutzers

rawData

Die gesamte Rohdaten des angemeldeten Benutzers im JSON-Format. Abhängig vom verwendeten Authentifikator können die Rohdaten weitere Benutzerinformationen enthalten, die nicht über die Attribute des Benutzerobjektes abgebildet werden.

role

Rolle des angemeldeten Benutzers

title

Titel des angemeldeten Benutzers

typedId

Typ des Authentifikators, der vom Benutzer verwendet wurde, um sich anzumelden.

userName

Benutzername des angemeldeten Benutzers

Terminplatzhaler

Terminplatzhalter können verwendet werden, wenn mit dem Formular Termine gebucht werden.

[%$APPOINTMENT_LIST%]

Erzeugt eine Zusammenfassung der mit dem Vorgang gebuchten Termine in Form einer ul-HTML-Liste. Für jeden Termin wird zudem ein Button erzeugt, mit welchem der gebuchte Termin zu einem Kalender hinzugefügt werden kann. Ist für die Verwendung in HTML-Templates angedacht.

[%$APPOINTMENT_LINK%]

Erzeugt einen Link zu einer iCal-Datei, die sämtliche Termine des Vorgangs beinhaltet.

Systemplatzhalter für HTML-Templates

Zusätzlich zu den allgemeingültigen Systemplatzhaltern gibt es noch einige weitere Systemplatzhalter, welche nur innerhalb eines HTML-Templates verwendet werden können. Diese dienen zum Herunterladen von Anhängen und sind hierfür nur innerhalb der Browser-Session nach dem Absenden eines Formulars nutzbar.

[%$ATTACHMENT_LIST%]

Stellt alle an einem Vorgang verfügbaren Anhänge (Attachments) in einer Liste zum Herunterladen bereits. Die erzeugte Liste wird als ul-HTML-Element in das Tempalte eingefügt.

[%$ATTACHMENT_ZIP=Dateiname,Link-Text%]

Erzeugt einen Link zum Herunterladen aller Anhänge eines Vorgangs. Die Parameter Dateiname sowie Link-Textsind optional, sodass dieser Systemplatzhalter in folgenden Varianten genutzt werden kann.

[%$ATTACHMENT_ZIP=Dateiname,Link-Text%]

Erzeugt einen Link mit dem Text Link-Text zum Herunterladen der Datei, die den Dateinamen Dateiname erhält.

[%$ATTACHMENT_ZIP=Dateiname%]

Erzeugt einen Link mit dem Text Dateiname zum Herunterladen der Datei, die den Dateinamen Dateiname erhält.

[%$ATTACHMENT_ZIP%]

Erzeugt einen Link mit dem Text attachment.zip zum Herunterladen der Datei, die den Dateinamen attachment.zip erhält.

[%$ATTACHMENT=Anhang,Link-Text,Dateiname%]

Erzeugt einen Link zum Download eines einzelnen Anhangs eines Vorgangs mit dem Namen "Anhang". Dieser muss für eine korrekte Funktion den Namen einer erzeugten bzw. an den Vorgang angehangenen Datei entsprechen. Die Parameter "Link-Text" und "Dateiname" sind hierbei optional, sodass sich folgende Verwendungsmöglichkeiten ergeben:

[%$ATTACHMENT=Anhang,Link-Text,Downloadname%]

Erzeugt einen Link mit dem Text Link-Text zum Herunterladen des Anhangs mit dem Namen Anhang, der den Dateinamen Dateiname erhält.

[%$ATTACHMENT=Anhang,Link-Text%]

Erzeugt einen Link mit dem Text Link-Text zum Herunterladen des Anhangs mit dem Namen Anhang, der den Dateinamen Anhang erhält.

[%$ATTACHMENT=Anhang%]

Erzeugt einen Link mit dem Text Anhang zum Herunterladen des Anhangs mit dem Namen Anhang, der den Dateinamen Anhang erhält.

Zusätzlich ist bei dieser Art von Platzhaltern zu beachten, dass sie automatisch aus dem Template entfernt werden, wenn keine entsprechende Datei gefunden wurde bzw. erzeugt werden konnte.

Textbausteinplatzhalter

Syntax: [%$$<Name>%]

Ein Textbausteinplatzhalter gibt den Inhalt eines Templates (zum Beispiel Text-, Mail-, Link-Templates) zurück und wird beispielsweise in Aktionen vom Typ E-Mail verwendet.

Aktionsplatzhalter

Syntax: [%$<Aktionsname>.<RückgabeWert>%]

Einige Aktionen haben Rückgabewerte, die über diesen Platzhalter ausgelesen werden können.

Sie sehen ähnlich wie Systemplatzhalter aus, haben aber im Unterschied zu diesen einen Punkt als Trennzeichen zwischen dem Namen der Aktion und dem Rückgabewert. Folgende Rückgabebezeichner sind vorhanden.

[%$<Aktionsname>.SUCCESS%]

Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.

[%$<Aktionsname>.RESULT%]

Rückgabe eines einzelnen Ergebnis. Liefert String-Wert zurück.

[%$<Aktionsname>.RESULT.<Bezeichner>%]

Rückgabe eines bestimmten Wertes aus einem Ergebnis. Liefert String-Wert zurück.

[%$<Aktionsname>.RESULT[<Index>].<Bezeichner>%]

Die meisten Aktionen liefern mehrere Ergebnisse zurück in Form von benamten Eigenschaften. Welche Eigenschaften zur Verfügung stehen, hängt von der Aktion ab. Durch Klick auf das Info-Icon rechts oben an einer Aktion kann eigesehen werden, welche Werte die Aktion bereitstellt und wie der Platzhalter dafür aussieht.

[%$<Aktionsname>.RESULT.rows[<Index>][<Eigenschaft>]%]

Einige Aktionen liefern ein JSON-Array mit den Ergebnissen zurück, zum Beispiel Datenbank-Statement. Jeder Eintrag im JSON-Array ist ein JSON-Objekt, wobei der Schlüssel dem Namen der Datenbankspalte entspricht. Der Index i beginnt mit 0. Welche Eigenschaften zur Verfügung stehen, hängt von der Aktion ab. Durch Klick auf das Info-Icon rechts oben an einer Aktion kann eigesehen werden, welche Werte die Aktion bereitstellt und wie der Platzhalter dafür aussieht.

[%$<Aktionsname>.RESULT.rows.length()%]

Wenn mehrere Ergebnisse zurückgeliefert werden, kann die Anzahl in Platzhalterwerten mittels .length() abgefragt werden.

[%$<Aktionsname>.ERROR_CODE%]

Der geworfene Fehler-Code im Fehlerfall der Aktion.

[%$<Aktionsname>.ERROR_MESSAGE%]

Die geworfene Fehler-Nachricht im Fehlerfall der Aktion.