Änderungen von Dokument Platzhalter

Von Version < 44.11 >
bearbeitet von awa
am 03.01.2020, 08:58
Auf Version < 68.3
bearbeitet von sas
am 01.10.2020, 11:14
<
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.awa
1 +XWiki.sas
Inhalt
... ... @@ -1,6 +1,6 @@
1 1  {{content/}}
2 2  
3 -Platzhalter werden für die Ersetzung von Formularwerten verwendet und stehen in [[Aktionen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]] sowie [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]] zur Verfügung.
3 +Platzhalter werden für die Ersetzung von Formular- oder Systemwerten verwendet und stehen in [[Aktionen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.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  
... ... @@ -26,10 +26,12 @@
26 26  
27 27  == Platzhaltertypen ==
28 28  
29 +{{id name="sec_form_placeholder"/}}
30 +
29 29  === Formularplatzhalter ===
30 30  
31 31  {{panel monospace="true" title="Syntax"}}
32 -[%{{italic}}&lt;NameDesFormularelements&gt;{{/italic}}%]
34 +[%&lt;NameDesFormularelements&gt;%]
33 33  {{/panel}}
34 34  
35 35  Dieser Platzhalter wird ersetzt durch den Wert des Formularelements mit dem angegebenen Namen. Formularplatzhalter werden in Aktionen wie z.B. [[E-Mail>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.EMail]], [[Text erzeugen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WriteTextFile]], [[Datenbank>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.SQLStatement]] sowie bei [[Templates>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ResponsePage]] verwendet.
... ... @@ -40,13 +40,15 @@
40 40  
41 41  Einige spezielle Formularplatzhalter existieren für alle Formulare:
42 42  
43 -* [%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.
44 -* [%lang%] Verweist auf die Sprache, die beim Ausfüllen des Formulars verwendet wurde, z.B. //de//, //de-CH//, //en/ oder //fr-FR//.//
45 +; [%xf-action%]
46 +: 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.
47 +; [%lang%]
48 +: Verweist auf die Sprache, die beim Ausfüllen des Formulars verwendet wurde, z.B. //de//, //de-CH//, //en// oder //fr-FR//.
45 45  
46 46  === Systemplatzhalter ===
47 47  
48 48  {{panel monospace="true" title="Syntax"}}
49 -[%${{italic}}&lt;Name&gt;{{/italic}}%]
53 +[%$&lt;Name&gt;%]
50 50  {{/panel}}
51 51  
52 52  Dieser Platzhalter wird ersetzt durch den entsprechenden Systemwert. Aktuell stehen folgende Systemplatzhalter in Aktionen und Templates zur Verfügung.
... ... @@ -83,16 +83,118 @@
83 83  ==== Parametrisierbare Systemplatzhalter ====
84 84  
85 85  {{panel monospace="true" title="Syntax"}}
86 -[%$&lt;Name&gt;(&lt;Paramater&gt;...)%]
90 +[%$&lt;Name&gt;(&lt;Parameter&gt;...)%]
87 87  {{/panel}}
88 88  
89 89  ; [%$DATE("<format>", <lang>)%]
90 -: {{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}}[%$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}}.
91 91  ; [%$FORM_DATE_CREATED("<format>", <lang>)%]
92 -: {{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. Siehe [[SimpleDateFormat>>https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html]]) für mehr Informationen zum Datumsformat. Beispiel: {{code}}[%$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}}
93 93  ; [%$FORM_DATE_MODIFIED("<format>", <lang>)%]
94 -: {{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 Paramater 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}}[%$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}}
95 95  
100 +{{id name="sec_user_variables"/}}
101 +
102 +=== Benutzerplatzhalter {{version major="6" minor="4" patch="0"/}} ===
103 +
104 +{{id name="fig_prefill_user_variables"/}}
105 +{{figure image="prefill_user_variables_de.png"}}Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.{{/figure}}
106 +
107 +
108 +{{html wiki="true"}}
109 +<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>
110 +{{/html}}
111 +
112 +
113 +
114 +{{html wiki="true"}}
115 +<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>
116 +{{/html}}
117 +
118 +
119 +Benutzerplatzhalter können in [[Aktionen>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.WebHome]], [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]], [[Datenbank-Abfragen>>Formcycle.UserInterface.Data.DBQueries.WebHome]] und direkt in [[Formularelementen>>Formcycle.FormDesigner.FormElements.WebHome]] zur Vorbefüllung des Formulars verwendet werden (siehe [[Abbildung>>||anchor="fig_prefill_user_variables"]]).
120 +
121 +{{panel monospace="true" title="Syntax"}}
122 +[%$&lt;Benutzerobjekt&gt;.&lt;Attribut&gt;%]
123 +{{/panel}}
124 +
125 +Ü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.
126 +
127 +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.
128 +
129 +==== Benutzerobjekte ====
130 +
131 +; [%$USER%]
132 +: Benutzerobjekt für den Zugriff auf den aktuellen Benutzer.
133 +
134 +; [%$LAST_USER%]
135 +: Benutzerobjekt für den Zugriff auf den letzten Benutzer.
136 +
137 +; [%$INITIAL_USER%]
138 +: Benutzerobjekt für den Zugriff auf den Benutzer, der den Vorgang angelegt hat.
139 +
140 +==== Attribute ====
141 +
142 +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>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome]] sich der Benutzer angemeldet hat.
143 +
144 +Beispiel: Mit dem Platzhalter **[%$USER.mail%]** gelangt man an die E-Mailadresse des angemeldeten Benutzers.
145 +
146 +; authTypeId
147 +: ID des [[Authentifikators>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome]], der vom Benutzer verwendet wurde, um sich anzumelden.
148 +; displayName
149 +: Anzeigename des angemeldeten Benutzers
150 +; familyName
151 +: Nachname des angemeldeten Benutzers
152 +; firstName
153 +: Vorname des angemeldeten Benutzers
154 +; gender
155 +: Geschlecht des angemeldeten Benutzers
156 +; groups
157 +: Namen der Gruppen, denen der Benutzer angehört
158 +; id
159 +: ID des angemeldeten Benutzers. (System-ID bei FORMCYCLE-Benutzern)
160 +; linkedId
161 +: Ein Benutzerprofil kann einen sog. "linked identifier" haben. Dies ist der Identifikator eines anderen Benutzerprofils.
162 +; locale
163 +: Sprache des angemeldeten Benutzers
164 +; location
165 +: Ort des angemeldeten Benutzers
166 +; mail
167 +: E-Mailadresse des angemeldeten Benutzers
168 +; phone
169 +: Telefonnummer des angemeldeten Benutzers
170 +; pictureUrl
171 +: URL zum Profilbild des angemeldeten Benutzers
172 +; profileUrl
173 +: URL zum Profil des angemeldeten Benutzers
174 +; rawData
175 +: Die gesamte Rohdaten des angemeldeten Benutzers im [[JSON>>https://de.wikipedia.org/wiki/JavaScript_Object_Notation]]-Format. Abhängig vom verwendeten Authentifikator können die Rohdaten weitere Benutzerinformationen enthalten, die nicht über die Attribute des Benutzerobjektes abgebildet werden.
176 +; role
177 +: Rolle des angemeldeten Benutzers
178 +; title
179 +: Titel des angemeldeten Benutzers
180 +; typedId
181 +: Typ des [[Authentifikators>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome]], der vom Benutzer verwendet wurde, um sich anzumelden.
182 +; userName
183 +: Benutzername des angemeldeten Benutzers
184 +
185 +{{id name="sec_appointment_variables"/}}
186 +
187 +=== Terminplatzhaler {{version major="6" minor="5" patch="0"/}} ===
188 +
189 +Terminplatzhalter können verwendet werden, wenn mit dem Formular [[Termine>>doc:Formcycle.FormDesigner.FormElements.Appointment.WebHome]] gebucht werden.
190 +
191 +{{panel monospace="true" title="Syntax"}}
192 +[%$&lt;Name&gt;%]
193 +{{/panel}}
194 +
195 +; [%$APPOINTMENT_LIST%]
196 +: 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.
197 +; [%$APPOINTMENT_LINK%]
198 +: Erzeugt einen Link zu einer iCal-Datei, die sämtliche Termine des Vorgangs beinhaltet.
199 +
200 +{{id name="sec_system_placeholder_html"/}}
201 +
96 96  === Systemplatzhalter für HTML-Templates ===
97 97  
98 98  {{panel monospace="true" title="Syntax"}}
prefill_user_variables_de.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.nlo
Größe
... ... @@ -1,0 +1,1 @@
1 +46.3 KB
Inhalt
prefill_user_variables_en.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.nlo
Größe
... ... @@ -1,0 +1,1 @@
1 +45.9 KB
Inhalt

Navigation

Copyright 2000-2024