| ... |
... |
@@ -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 |
|
| ... |
... |
@@ -89,21
+89,28 @@ |
| 89 |
89 |
{{/panel}} |
| 90 |
90 |
|
| 91 |
91 |
; [%$DATE("<format>", <lang>)%] |
| 92 |
|
-: {{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}}. |
|
92 |
+: {{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}}. |
| 93 |
93 |
; [%$FORM_DATE_CREATED("<format>", <lang>)%] |
| 94 |
|
-: {{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}} |
|
94 |
+: {{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 language="none"}}[%$FORM_DATE_CREATED("dd.MM.yyyy", de)%]{{/code}} |
| 95 |
95 |
; [%$FORM_DATE_MODIFIED("<format>", <lang>)%] |
| 96 |
|
-: {{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}} |
|
96 |
+: {{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 language="none"}}[%$FORM_DATE_MODIFIED("dd.MM.yyyy", de)%]{{/code}} |
| 97 |
97 |
|
|
98 |
+ |
|
99 |
+{{id name="sec_user_variables" /}} |
| 98 |
98 |
=== Benutzerplatzhalter {{version major="6" minor="4" patch="0"/}} === |
| 99 |
99 |
|
|
102 |
+{{id name="fig_prefill_user_variables"/}} |
|
103 |
+{{figure image="prefill_user_variables_de.png"}}Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.{{/figure}} |
|
104 |
+ |
|
105 |
+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"]]). |
|
106 |
+ |
| 100 |
100 |
{{panel monospace="true" title="Syntax"}} |
| 101 |
101 |
[%$<Benutzerobjekt>.<Attribut>%] |
| 102 |
102 |
{{/panel}} |
| 103 |
103 |
|
| 104 |
|
-Ü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. |
|
111 |
+Ü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. |
| 105 |
105 |
|
| 106 |
|
-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. |
|
113 |
+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. |
| 107 |
107 |
|
| 108 |
108 |
==== Benutzerobjekte ==== |
| 109 |
109 |
|
| ... |
... |
@@ -118,7
+118,7 @@ |
| 118 |
118 |
|
| 119 |
119 |
==== Attribute ==== |
| 120 |
120 |
|
| 121 |
|
-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. |
|
128 |
+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. |
| 122 |
122 |
|
| 123 |
123 |
Beispiel: Mit dem Platzhalter **[%$USER.mail%]** gelangt man an die E-Mailadresse des angemeldeten Benutzers. |
| 124 |
124 |
|
| ... |
... |
@@ -128,6
+128,8 @@ |
| 128 |
128 |
: Anzeigename des angemeldeten Benutzers |
| 129 |
129 |
; familyName |
| 130 |
130 |
: Nachname des angemeldeten Benutzers |
|
138 |
+; firstName |
|
139 |
+: Vorname des angemeldeten Benutzers |
| 131 |
131 |
; gender |
| 132 |
132 |
: Geschlecht des angemeldeten Benutzers |
| 133 |
133 |
; groups |
| ... |
... |
@@ -135,7
+135,7 @@ |
| 135 |
135 |
; id |
| 136 |
136 |
: ID des angemeldeten Benutzers. (System-ID bei FORMCYCLE-Benutzern) |
| 137 |
137 |
; linkedId |
| 138 |
|
-: |
|
147 |
+: Ein Benutzerprofil kann einen sog. "linked identifier" haben. Dies ist der Identifikator eines anderen Benutzerprofils. |
| 139 |
139 |
; locale |
| 140 |
140 |
: Sprache des angemeldeten Benutzers |
| 141 |
141 |
; location |