Änderungen von Dokument Platzhalter

Von Version < 50.2 >
bearbeitet von nlo
am 29.04.2020, 17:59
Auf Version < 68.1 >
bearbeitet von sas
am 16.07.2020, 16:26
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.nlo
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,6 +26,8 @@
26 26  
27 27  == Platzhaltertypen ==
28 28  
29 +{{id name="formularplatzhalter"/}}
30 +
29 29  === Formularplatzhalter ===
30 30  
31 31  {{panel monospace="true" title="Syntax"}}
... ... @@ -82,14 +82,41 @@
82 82  ; [%$STATUS_NAME%]
83 83  : Name des derzeitigen Status.
84 84  
85 -=== Benutzerplatzhalter ===
87 +==== Parametrisierbare Systemplatzhalter ====
88 +
86 86  {{panel monospace="true" title="Syntax"}}
90 +[%$&lt;Name&gt;(&lt;Parameter&gt;...)%]
91 +{{/panel}}
92 +
93 +; [%$DATE("<format>", <lang>)%]
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}}.
95 +; [%$FORM_DATE_CREATED("<format>", <lang>)%]
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}}
97 +; [%$FORM_DATE_MODIFIED("<format>", <lang>)%]
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}}
99 +
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 +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"]]).
114 +
115 +{{panel monospace="true" title="Syntax"}}
87 87  [%$&lt;Benutzerobjekt&gt;.&lt;Attribut&gt;%]
88 88  {{/panel}}
89 89  
90 -Über verschiedene Benutzerobjekte kann auf die Informationen der angemeldeten Benutzer zugrgriffen werden. 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.
119 +Ü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.
91 91  
92 -Für die sinnvolle Verwendung von Benutzerplatzhaltern ist es nötig, dass eine [[Formularanmeldung>>doc:Formcycle.UserInterface.MyForms.Access.WebHome]] am Formular konfiguriert ist. Ist dies nicht der Fall, ist das Benutzerobjekt mit einem anonymen Nutzer vorbelegt.
121 +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.
93 93  
94 94  ==== Benutzerobjekte ====
95 95  
... ... @@ -104,21 +104,66 @@
104 104  
105 105  ==== Attribute ====
106 106  
107 -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.
136 +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.
108 108  
109 -==== Parametrisierbare Systemplatzhalter ====
138 +Beispiel: Mit dem Platzhalter **[%$USER.mail%]** gelangt man an die E-Mailadresse des angemeldeten Benutzers.
110 110  
140 +; authTypeId
141 +: ID des [[Authentifikators>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome]], der vom Benutzer verwendet wurde, um sich anzumelden.
142 +; displayName
143 +: Anzeigename des angemeldeten Benutzers
144 +; familyName
145 +: Nachname des angemeldeten Benutzers
146 +; firstName
147 +: Vorname des angemeldeten Benutzers
148 +; gender
149 +: Geschlecht des angemeldeten Benutzers
150 +; groups
151 +: Namen der Gruppen, denen der Benutzer angehört
152 +; id
153 +: ID des angemeldeten Benutzers. (System-ID bei FORMCYCLE-Benutzern)
154 +; linkedId
155 +: Ein Benutzerprofil kann einen sog. "linked identifier" haben. Dies ist der Identifikator eines anderen Benutzerprofils.
156 +; locale
157 +: Sprache des angemeldeten Benutzers
158 +; location
159 +: Ort des angemeldeten Benutzers
160 +; mail
161 +: E-Mailadresse des angemeldeten Benutzers
162 +; phone
163 +: Telefonnummer des angemeldeten Benutzers
164 +; pictureUrl
165 +: URL zum Profilbild des angemeldeten Benutzers
166 +; profileUrl
167 +: URL zum Profil des angemeldeten Benutzers
168 +; rawData
169 +: 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.
170 +; role
171 +: Rolle des angemeldeten Benutzers
172 +; title
173 +: Titel des angemeldeten Benutzers
174 +; typedId
175 +: Typ des [[Authentifikators>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome]], der vom Benutzer verwendet wurde, um sich anzumelden.
176 +; userName
177 +: Benutzername des angemeldeten Benutzers
178 +
179 +{{id name="sec_appointment_variables"/}}
180 +
181 +=== Terminplatzhaler {{version major="6" minor="5" patch="0"/}} ===
182 +
183 +Terminplatzhalter können verwendet werden, wenn mit dem Formular [[Termine>>doc:Formcycle.FormDesigner.FormElements.Appointment.WebHome]] gebucht werden.
184 +
111 111  {{panel monospace="true" title="Syntax"}}
112 -[%$&lt;Name&gt;(&lt;Parameter&gt;...)%]
186 +[%$&lt;Name&gt;%]
113 113  {{/panel}}
114 114  
115 -; [%$DATE("<format>", <lang>)%]
116 -: {{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}}.
117 -; [%$FORM_DATE_CREATED("<format>", <lang>)%]
118 -: {{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}}
119 -; [%$FORM_DATE_MODIFIED("<format>", <lang>)%]
120 -: {{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. 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}}
189 +; [%$APPOINTMENT_LIST%]
190 +: 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.
191 +; [%$APPOINTMENT_LINK%]
192 +: Erzeugt einen Link zu einer iCal-Datei, die sämtliche Termine des Vorgangs beinhaltet.
121 121  
194 +{{id name="systemplatzhalter-html"/}}
195 +
122 122  === Systemplatzhalter für HTML-Templates ===
123 123  
124 124  {{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