Änderungen von Dokument Platzhalter


Von Version 53.1
bearbeitet von sas
am 16.02.2023, 14:39
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 14.1
bearbeitet von gru
am 29.06.2021, 14:19
Änderungskommentar: Renamed back-links.

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.sas
1 +XWiki.gru
Inhalt
... ... @@ -5,7 +5,7 @@
5 5  == Verwenden von Platzhaltern ==
6 6  
7 7  {{figure image="1_de_PlatzhalterEMail.png" group="platzhalter"}}
8 -Symbol für das Öffnen einer Platzhalterauswahl an einem Options- und einem Textfeld im Aktionstyp [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail]].
8 +Symbol für das Öffnen einer Platzhalterauswahl an einem Options- und einem Textfeld im Aktionstyp [[E-Mail>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.EMail.WebHome]].
9 9  {{/figure}}
10 10  
11 11  {{figure image="2_de_Platzhalter.png" width="150" group="platzhalter"}}
... ... @@ -34,26 +34,10 @@
34 34  [%<NameDesFormularelements>%]
35 35  {{/panel}}
36 36  
37 -Dieser Platzhalter wird ersetzt durch den Wert des Formularelements mit dem angegebenen Namen. Formularplatzhalter werden in Aktionen wie z.B. [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail]], [[Text erzeugen>>doc:Formcycle.Designer.Workflow.Actions.CreateTextFile]], [[Datenbank>>doc:Formcycle.Designer.Workflow.Actions.SQLStatement]] sowie bei [[Templates>>doc:Formcycle.Designer.Workflow.Actions.HtmlResponsePage]] verwendet.
37 +Dieser Platzhalter wird ersetzt durch den Wert des Formularelements mit dem angegebenen Namen. Formularplatzhalter werden in Aktionen wie z.B. [[E-Mail>>doc:Formcycle.Designer.Workflow.Actions.EMail]], [[Text erzeugen>>doc:Formcycle.Designer.Workflow.Actions.WriteTextFile]], [[Datenbank>>doc:Formcycle.Designer.Workflow.Actions.SQLStatement]] sowie bei [[Templates>>doc:Formcycle.Designer.Workflow.Actions.ResponsePage]] verwendet.
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,25 +75,14 @@
75 75  
76 76  ; [%$CLIENT_ID%]
77 77  : Gibt die Mandant-ID des Formulars zurück.
78 -; [%$DEFAULT_MAIL_SENDER%] {{version major="7" patch="3"}}{{/version}}
79 -: Liefert den E-Mail Absender (System) für den konfigurierten Mailserver zurück. Falls unter Mandant > Einstellung ein eigener Mailserver konfiguriert ist, wird diese Einstellung verwendet, sonst der System E-Mail Server.
80 -; [%$DEFAULT_MAIL_SENDERNAME%] {{version major="7" patch="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%]
88 88  : Gibt die einmalige Bestätigungs-URL zurück (nötig für [[Double-Opt-In>>doc:Formcycle.UserInterface.MyForms.DoubleOptIn.WebHome]]).
89 89  ; [%$FORM_INBOX_NAME%]
90 -: Gibt den Namen des Postfachs zurück, indem sich der Vorgang derzeit befindet.
91 -; [%$FORM_INBOX_LINK%]
92 -: Gibt den Link des Postfachs zurück, indem sich der Vorgang derzeit befindet.
93 -; [%$FORM_INVITE_LINK%]
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.
67 +: {{version major="6" minor="1"/}}Gibt den Namen des Postfachs zurück, indem sich der Vorgang derzeit befindet.
97 97  ; [%$PROCESS_ID%]
98 98  : Gibt die aktuelle Prozess-ID des Vorgangs zurück.
99 99  ; [%$PROJECT_ALIAS%]
... ... @@ -100,17 +100,10 @@
100 100  : Alias des derzeitigen Formulars.
101 101  ; [%$PROJECT_ID%]
102 102  : Gibt die Formular-ID zurück.
103 -; [%$PROJECT_TITLE%]
104 -: Ab 7 heißt [%$PROJECT_NAME%] nun [%$PROJECT_TITLE%] .
105 -: Titel des derzeitigen Formulars.
74 +; [%$PROJECT_NAME%]
75 +: Name des derzeitigen Formulars.
106 106  ; [%$RECORD_ID%]
107 107  : ID des derzeitigen Vorgangs.
108 -; [%$RECORD_READ%]
109 -: Rückgabe ob der derzeitige Vorgang gelesen wurde. Liefert Boolean (true/false) zurück.
110 -; [%$RECORD_UNREAD%]
111 -: Rückgabe ob der derzeitige Vorgang nicht gelesen wurde. Liefert Boolean (true/false) zurück.
112 -; [%$RECORD_ATTR.<customAttrKey>%]
113 -: Auslesen von benutzerdefinierten Vorgangswerten (z.B. [%$RECORD_ATTR.loopCount%]). Damit können am Vorgang Werte gespeichert und in jeder Aktion darauf zugegriffen werden.
114 114  ; [%$SOURCE_SERVER%]
115 115  : Gibt den Namen des Servers zurück, auf welchem dieser bereitgestellt und abgesendet wurde (Name des {{fserver case="gen"/}} oder lokal).
116 116  ; [%$SOURCE_SERVER_URL%]
... ... @@ -119,14 +119,6 @@
119 119  : ID des derzeitigen Status.
120 120  ; [%$STATUS_NAME%]
121 121  : Name des derzeitigen Status.
122 -; [%$STATUS_TYPE%]
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]].
130 130  
131 131  ==== Parametrisierbare Systemplatzhalter ====
132 132  
... ... @@ -135,15 +135,15 @@
135 135  {{/panel}}
136 136  
137 137  ; [%$DATE("<format>", <lang>)%]
138 -: 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$DATE("dd.MM.yyyy", de)%]{{/code}}.
94 +: {{version major="6" minor="0" patch="5"/}} 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$DATE("dd.MM.yyyy", de)%]{{/code}}.
139 139  ; [%$FORM_DATE_CREATED("<format>", <lang>)%]
140 -: 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$FORM_DATE_CREATED("dd.MM.yyyy", de)%]{{/code}}
96 +: {{version major="6" minor="0" patch="5"/}} 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$FORM_DATE_CREATED("dd.MM.yyyy", de)%]{{/code}}
141 141  ; [%$FORM_DATE_MODIFIED("<format>", <lang>)%]
142 -: 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$FORM_DATE_MODIFIED("dd.MM.yyyy", de)%]{{/code}}
98 +: {{version major="6" minor="0" patch="5"/}} 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>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]] für mehr Informationen zum Datumsformat. Beispiel: {{code language="none"}}[%$FORM_DATE_MODIFIED("dd.MM.yyyy", de)%]{{/code}}
143 143  
144 144  {{id name="sec_user_variables"/}}
145 145  
146 -=== Benutzerplatzhalter ===
102 +=== Benutzerplatzhalter {{version major="6" minor="4" patch="0"/}} ===
147 147  
148 148  {{id name="fig_prefill_user_variables"/}}
149 149  {{figure image="prefill_user_variables_de.png"}}Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.{{/figure}}
... ... @@ -160,24 +160,6 @@
160 160  {{/html}}
161 161  
162 162  
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 181  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"]]).
182 182  
183 183  {{panel monospace="true" title="Syntax"}}
... ... @@ -246,7 +246,7 @@
246 246  
247 247  {{id name="sec_appointment_variables"/}}
248 248  
249 -=== Terminplatzhaler ===
187 +=== Terminplatzhaler {{version major="6" minor="5" patch="0"/}} ===
250 250  
251 251  Terminplatzhalter können verwendet werden, wenn mit dem Formular [[Termine>>doc:Formcycle.Designer.Form.FormElements.Appointment.WebHome]] gebucht werden.
252 252  
... ... @@ -300,8 +300,6 @@
300 300  
301 301  === Aktionsplatzhalter ===
302 302  
303 -{{id name="action"/}}
304 -
305 305  {{panel monospace="true" title="Syntax"}}
306 306  [%$&lt;Aktionsname&gt;.&lt;RückgabeWert&gt;%]
307 307  {{/panel}}
... ... @@ -312,21 +312,9 @@
312 312  
313 313  ; [%$<Aktionsname>.SUCCESS%]
314 314  : Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.
251 +; [%$<Aktionsname>.COUNT%]
252 +: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück.
315 315  ; [%$<Aktionsname>.RESULT%]
316 316  : Rückgabe eines einzelnen Ergebnis. Liefert String-Wert zurück.
317 317  ; [%$<Aktionsname>.RESULT[<Index>].<Bezeichner>%]
318 318  : 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.
319 -
320 -Die folgenden Aktionsplatzhalter werden __nicht__ im alten Workflow unterstützt:
321 -
322 -; [%$<Aktionsname>.ERROR_CODE%]
323 -: Der geworfene Fehler-Code im Fehlerfall der Aktion.
324 -; [%$<Aktionsname>.ERROR_MESSAGE%]
325 -: Die geworfene Fehler-Nachricht im Fehlerfall der Aktion.
326 -
327 -Im neuen Workflow kann die Anzahl der Elemente von JSON-Arrays in Platzhalterwerten mit //.length()// erfragt werden, z.B.: **[%$Database query.RESULT.rows.length()%]**
328 -
329 -Der folgende Aktionsplatzhalter wird __nur__ im alten Workflow unterstützt:
330 -
331 -; [%$<Aktionsname>.COUNT%]
332 -: Rückgabe der Anzahl von Ergebnissen. Liefert Integer-Wert zurück.