Änderungen von Dokument Platzhalter


Von Version 54.3
bearbeitet von gru
am 27.09.2023, 17:58
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 46.1
bearbeitet von jdr
am 22.07.2021, 17:44
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.gru
1 +XWiki.jdr
Inhalt
... ... @@ -1,6 +1,6 @@
1 1  {{content/}}
2 2  
3 -Platzhalter werden für die Ersetzung von Formular- oder Systemwerten verwendet und stehen in [[Aktionen>>doc:Formcycle.Designer.Workflow.Actions.WebHome]], [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]] sowie [[Datenbank-Abfragen>>Formcycle.UserInterface.Data.DBQueries]] zur Verfügung.
3 +Platzhalter werden für die Ersetzung von Formular- oder Systemwerten verwendet und stehen in [[Aktionen>>doc:Formcycle.Designer.Workflow.Actions.WebHome]], [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]] sowie [[Datenbank-Abfragen>>Formcycle.UserInterface.Data.DBQueries.WebHome]] zur Verfügung.
4 4  
5 5  == Verwenden von Platzhaltern ==
6 6  
... ... @@ -38,22 +38,6 @@
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 -
57 57  === Spezielle Formularplatzhalter ===
58 58  
59 59  Einige spezielle Formularplatzhalter existieren für alle Formulare:
... ... @@ -65,8 +65,6 @@
65 65  
66 66  === Systemplatzhalter ===
67 67  
68 -{{id name="system"/}}
69 -
70 70  {{panel monospace="true" title="Syntax"}}
71 71  [%$<Name>%]
72 72  {{/panel}}
... ... @@ -75,13 +75,8 @@
75 75  
76 76  ; [%$CLIENT_ID%]
77 77  : Gibt die Mandant-ID des Formulars zurück.
78 -; [%$DEFAULT_MAIL_SENDER%] {{version major="7" minor="3"}}{{/version}}
79 -: 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.
80 -; [%$DEFAULT_MAIL_SENDERNAME%] {{version major="7" minor="3"}}{{/version}}
81 -: Liefert den Absendername (System) für den konfigurierten Mailserver zurück. Wenn dieser nicht konfiguriert wurde, wird ein Leerstring zurückgegeben.
82 82  ; [%$FORM_LINK%]
83 83  : Gibt die URL des Formulars zurück.
84 -{{id name="ph_form_process_link"/}}
85 85  ; [%$FORM_PROCESS_LINK%]
86 86  : Gibt die URL des Formulars mit dem Inhalt des Vorgangs zurück.
87 87  ; [%$FORM_VERIFY_LINK%]
... ... @@ -92,8 +92,6 @@
92 92  : Gibt den Link des Postfachs zurück, indem sich der Vorgang derzeit befindet.
93 93  ; [%$FORM_INVITE_LINK%]
94 94  : 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.
97 97  ; [%$PROCESS_ID%]
98 98  : Gibt die aktuelle Prozess-ID des Vorgangs zurück.
99 99  ; [%$PROJECT_ALIAS%]
... ... @@ -101,7 +101,7 @@
101 101  ; [%$PROJECT_ID%]
102 102  : Gibt die Formular-ID zurück.
103 103  ; [%$PROJECT_TITLE%]
104 -: Ab 7 heißt [%$PROJECT_NAME%] nun [%$PROJECT_TITLE%] .
79 +: Ab Version 7 heißt [%$PROJECT_NAME%] nun [%$PROJECT_TITLE%] .
105 105  : Titel des derzeitigen Formulars.
106 106  ; [%$RECORD_ID%]
107 107  : ID des derzeitigen Vorgangs.
... ... @@ -125,8 +125,8 @@
125 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 126  ; [%$TRIGGER.<JSON_PATH>%]
127 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]].
103 +; [%$COUNTER_CLIENT.<counterName>%]
104 +: Der aktuelle Wert eines Mandantzählers.
130 130  
131 131  ==== Parametrisierbare Systemplatzhalter ====
132 132  
... ... @@ -160,50 +160,8 @@
160 160  {{/html}}
161 161  
162 162  
138 +Benutzerplatzhalter können in [[Aktionen>>doc:Formcycle.Designer.Workflow.Actions.WebHome]], [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]], [[Datenbank-Abfragen>>Formcycle.UserInterface.Data.DBQueries.WebHome]] und direkt in [[Formularelementen>>Formcycle.Designer.Form.FormElements.WebHome]] zur Vorbefüllung des Formulars verwendet werden (siehe [[Abbildung>>||anchor="fig_prefill_user_variables"]]).
163 163  
164 -{{html wiki="true"}}
165 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
166 -{{/html}}
167 -
168 -
169 -
170 -{{html wiki="true"}}
171 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
172 -{{/html}}
173 -
174 -
175 -
176 -{{html wiki="true"}}
177 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
178 -{{/html}}
179 -
180 -
181 -
182 -{{html wiki="true"}}
183 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
184 -{{/html}}
185 -
186 -
187 -
188 -{{html wiki="true"}}
189 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
190 -{{/html}}
191 -
192 -
193 -
194 -{{html wiki="true"}}
195 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
196 -{{/html}}
197 -
198 -
199 -
200 -{{html wiki="true"}}
201 -<div class='xm-figure xm-float-right xm-clear-h2' data-alt='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='prefill_user_variables_de.png' width='300' group='$height' group='$group' title='Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.'/}}<div class='xm-figure-caption'>Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.</div></div></div>
202 -{{/html}}
203 -
204 -
205 -Benutzerplatzhalter können in [[Aktionen>>doc:Formcycle.Designer.Workflow.Actions.WebHome]], [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]], [[Datenbank-Abfragen>>Formcycle.UserInterface.Data.DBQueries]] und direkt in [[Formularelementen>>Formcycle.Designer.Form.FormElements.WebHome]] zur Vorbefüllung des Formulars verwendet werden (siehe [[Abbildung>>||anchor="fig_prefill_user_variables"]]).
206 -
207 207  {{panel monospace="true" title="Syntax"}}
208 208  [%$&lt;Benutzerobjekt&gt;.&lt;Attribut&gt;%]
209 209  {{/panel}}
... ... @@ -210,7 +210,7 @@
210 210  
211 211  Über verschiedene Benutzerobjekte kann auf die Informationen der angemeldeten Benutzer zugrgriffen werden (Benutzerprofil). Wird der Platzhalter ohne Attribut angegeben (z.b. [%$USER%]), so werden sämtliche Benutzerinformation im [[JSON>>https://de.wikipedia.org/wiki/JavaScript_Object_Notation]]-Format ausgegeben.
212 212  
213 -Für die sinnvolle Verwendung von Benutzerplatzhaltern ist es nötig, dass eine [[Formularanmeldung>>doc:Formcycle.UserInterface.MyForms.Access||anchor="form_login"]] am Formular konfiguriert ist. Ist dies nicht der Fall, ist das Benutzerobjekt mit einem anonymen Nutzer vorbelegt.
146 +Für die sinnvolle Verwendung von Benutzerplatzhaltern ist es nötig, dass eine [[Formularanmeldung>>doc:Formcycle.UserInterface.MyForms.Access.WebHome||anchor="form_login"]] am Formular konfiguriert ist. Ist dies nicht der Fall, ist das Benutzerobjekt mit einem anonymen Nutzer vorbelegt.
214 214  
215 215  ==== Benutzerobjekte ====
216 216  
... ... @@ -324,8 +324,6 @@
324 324  
325 325  === Aktionsplatzhalter ===
326 326  
327 -{{id name="action"/}}
328 -
329 329  {{panel monospace="true" title="Syntax"}}
330 330  [%$&lt;Aktionsname&gt;.&lt;RückgabeWert&gt;%]
331 331  {{/panel}}
... ... @@ -336,21 +336,17 @@
336 336  
337 337  ; [%$<Aktionsname>.SUCCESS%]
338 338  : Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.
270 +; [%$<Aktionsname>.COUNT%]
271 +: Dieser Platzhalter wird im neuen Workflow nicht unterstützt.
272 +: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück.
339 339  ; [%$<Aktionsname>.RESULT%]
340 340  : Rückgabe eines einzelnen Ergebnis. Liefert String-Wert zurück.
341 341  ; [%$<Aktionsname>.RESULT[<Index>].<Bezeichner>%]
342 342  : 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.
343 343  
344 -Die folgenden Aktionsplatzhalter werden __nicht__ im alten Workflow unterstützt:
278 +Diese Aktionsplatzhalter werden nicht im alten Workflow unterstützt:
345 345  
346 346  ; [%$<Aktionsname>.ERROR_CODE%]
347 347  : Der geworfene Fehler-Code im Fehlerfall der Aktion.
348 348  ; [%$<Aktionsname>.ERROR_MESSAGE%]
349 349  : Die geworfene Fehler-Nachricht im Fehlerfall der Aktion.
350 -
351 -Im neuen Workflow kann die Anzahl der Elemente von JSON-Arrays in Platzhalterwerten mit //.length()// erfragt werden, z.B.: **[%$Database query.RESULT.rows.length()%]**
352 -
353 -Der folgende Aktionsplatzhalter wird __nur__ im alten Workflow unterstützt:
354 -
355 -; [%$<Aktionsname>.COUNT%]
356 -: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück.