... |
... |
@@ -38,6 +38,22 @@ |
38 |
38 |
|
39 |
39 |
Beispielweise wird der Platzhalter //[%tfVorname%]// durch den Wert des [[Eingabefelds>>doc:Formcycle.Designer.Form.FormElements.Input]] mit Namen //Vorname// ersetzt. |
40 |
40 |
|
|
41 |
+=== Platzhalter für Fragenelemente === |
|
42 |
+ |
|
43 |
+Um auf die Werte von [[Auswahlelementen>>doc:Formcycle.Designer.Form.FormElements.Selection]] 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: |
|
44 |
+ |
|
45 |
+{{table}} |
|
46 |
+|= - |= A1 |= A2 |= A3 |
|
47 |
+|Q1|☑|☐|☐ |
|
48 |
+|Q2|☑|☑|☐ |
|
49 |
+|Q3|☑|☑|☑ |
|
50 |
+{{/table}} |
|
51 |
+ |
|
52 |
+Dann: |
|
53 |
+ |
|
54 |
+* //[%sel1%]// wird ersetzt durch //A1;A1,A2;A1,A2,A3// |
|
55 |
+* //[%sel1_0%]// wird ersetzt durch //A1//, //[%sel1_1%]// durch //A1,A2//, //[%sel1_2%]// durch //A1,A2,A3// |
|
56 |
+ |
41 |
41 |
=== Spezielle Formularplatzhalter === |
42 |
42 |
|
43 |
43 |
Einige spezielle Formularplatzhalter existieren für alle Formulare: |
... |
... |
@@ -49,6 +49,8 @@ |
49 |
49 |
|
50 |
50 |
=== Systemplatzhalter === |
51 |
51 |
|
|
68 |
+{{id name="system"/}} |
|
69 |
+ |
52 |
52 |
{{panel monospace="true" title="Syntax"}} |
53 |
53 |
[%$<Name>%] |
54 |
54 |
{{/panel}} |
... |
... |
@@ -57,8 +57,13 @@ |
57 |
57 |
|
58 |
58 |
; [%$CLIENT_ID%] |
59 |
59 |
: Gibt die Mandant-ID des Formulars zurück. |
|
78 |
+; [%$CLIENT_MAIL_SENDER%] {{version major="7" minor="0" patch="4"/}} |
|
79 |
+: Liefert die Mailabsenderadresse des Mandanten zurück. Wenn diese nicht konfiguriert wurde, wird ein Leerstring zurückgegeben. |
|
80 |
+; [%$CLIENT_MAIL_SENDERNAME%] {{version major="7" minor="0" patch="4"/}} |
|
81 |
+: Liefert den Mailabsendernamen des Mandanten zurück. Wenn dieser nicht konfiguriert wurde, wird ein Leerstring zurückgegeben. |
60 |
60 |
; [%$FORM_LINK%] |
61 |
61 |
: Gibt die URL des Formulars zurück. |
|
84 |
+{{id name="ph_form_process_link"/}} |
62 |
62 |
; [%$FORM_PROCESS_LINK%] |
63 |
63 |
: Gibt die URL des Formulars mit dem Inhalt des Vorgangs zurück. |
64 |
64 |
; [%$FORM_VERIFY_LINK%] |
... |
... |
@@ -69,6 +69,8 @@ |
69 |
69 |
: Gibt den Link des Postfachs zurück, indem sich der Vorgang derzeit befindet. |
70 |
70 |
; [%$FORM_INVITE_LINK%] |
71 |
71 |
: Gibt den Einladungslink zum Formular zurück. |
|
95 |
+; [%$FORM_HISTORY_HTML%] {{version major="7" minor="2" patch="0"/}} |
|
96 |
+: Gibt den Verlauf eines Formulars als (HTML-) Tabelle zurück. |
72 |
72 |
; [%$PROCESS_ID%] |
73 |
73 |
: Gibt die aktuelle Prozess-ID des Vorgangs zurück. |
74 |
74 |
; [%$PROJECT_ALIAS%] |
... |
... |
@@ -76,6 +76,7 @@ |
76 |
76 |
; [%$PROJECT_ID%] |
77 |
77 |
: Gibt die Formular-ID zurück. |
78 |
78 |
; [%$PROJECT_TITLE%] |
|
104 |
+: Ab 7 heißt [%$PROJECT_NAME%] nun [%$PROJECT_TITLE%] . |
79 |
79 |
: Titel des derzeitigen Formulars. |
80 |
80 |
; [%$RECORD_ID%] |
81 |
81 |
: ID des derzeitigen Vorgangs. |
... |
... |
@@ -94,15 +94,13 @@ |
94 |
94 |
; [%$STATUS_NAME%] |
95 |
95 |
: Name des derzeitigen Status. |
96 |
96 |
; [%$STATUS_TYPE%] |
97 |
|
-: Typ des derzeitigen Status. Diese vier Werte sind möglich: //RECEIVED// (Eingegangen), //SAVED// (Zwischengespeichert), //ERROR// (Fehlerstatus) and //CUSTOM// (Benutzerdefinierter Status, der durch den Nutzer angelegt wurde). |
98 |
|
-; [%$TRIGGER.actionName%] |
99 |
|
-: Name der Aktion des bereitstellenden Ereignisses |
100 |
|
-; [%$TRIGGER.taskName%] |
101 |
|
-: Name des Tasks, wo sich die Aktion des Ereignis befindet. |
102 |
|
-; [%$TRIGGER.triggerName%] |
103 |
|
-: Name des Ereignisses, wo sich die Aktion des Ereignis befindet. |
104 |
|
-; [%$COUNTER_CLIENT.<counterName>%] |
105 |
|
-: Der aktuelle Wert eines Mandantzählers. |
|
123 |
+: Typ des derzeitigen Status. Diese Werte sind möglich: //RECEIVED// (Eingegangen) und //CUSTOM// (Benutzerdefinierter Status, der durch den Nutzer angelegt wurde). |
|
124 |
+; [%$TRIGGER%] |
|
125 |
+: 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>%]). |
|
126 |
+; [%$TRIGGER.<JSON_PATH>%] |
|
127 |
+: 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. |
|
128 |
+; [%$COUNTER_CLIENT.<Name des Zählers>%] |
|
129 |
+: Der aktuelle Wert eines [[Mandantzählers>>doc:Formcycle.UserInterface.Data.Counter]]. |
106 |
106 |
|
107 |
107 |
==== Parametrisierbare Systemplatzhalter ==== |
108 |
108 |
|
... |
... |
@@ -258,6 +258,8 @@ |
258 |
258 |
|
259 |
259 |
=== Aktionsplatzhalter === |
260 |
260 |
|
|
285 |
+{{id name="action"/}} |
|
286 |
+ |
261 |
261 |
{{panel monospace="true" title="Syntax"}} |
262 |
262 |
[%$<Aktionsname>.<RückgabeWert>%] |
263 |
263 |
{{/panel}} |
... |
... |
@@ -268,14 +268,21 @@ |
268 |
268 |
|
269 |
269 |
; [%$<Aktionsname>.SUCCESS%] |
270 |
270 |
: Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück. |
271 |
|
-; [%$<Aktionsname>.COUNT%] |
272 |
|
-: Dieser Platzhalter wird im neuen Workflow nicht unterstützt. |
273 |
|
-: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück. |
274 |
274 |
; [%$<Aktionsname>.RESULT%] |
275 |
275 |
: Rückgabe eines einzelnen Ergebnis. Liefert String-Wert zurück. |
276 |
276 |
; [%$<Aktionsname>.RESULT[<Index>].<Bezeichner>%] |
277 |
277 |
: Einige Aktionen liefern mehrere Ergebnisse zurück (//List<Map<String,String>>// in Java). Der Bezeichner ist dabei fest durch die Verarbeitung definiert. Wird häufig bei Plugins verwendet, falls mehrere Ergebnisse zurückgegeben werden. |
|
301 |
+ |
|
302 |
+Die folgenden Aktionsplatzhalter werden __nicht__ im alten Workflow unterstützt: |
|
303 |
+ |
278 |
278 |
; [%$<Aktionsname>.ERROR_CODE%] |
279 |
279 |
: Der geworfene Fehler-Code im Fehlerfall der Aktion. |
280 |
280 |
; [%$<Aktionsname>.ERROR_MESSAGE%] |
281 |
281 |
: Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. |
|
308 |
+ |
|
309 |
+Im neuen Workflow kann die Anzahl der Elemente von JSON-Arrays in Platzhalterwerten mit //.length()// erfragt werden, z.B.: **[%$Database query.RESULT.rows.length()%]** |
|
310 |
+ |
|
311 |
+Der folgende Aktionsplatzhalter wird __nur__ im alten Workflow unterstützt: |
|
312 |
+ |
|
313 |
+; [%$<Aktionsname>.COUNT%] |
|
314 |
+: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück. |