Wiki-Quellcode von Platzhalter

Verstecke letzte Bearbeiter
gru 1.1 1 {{content/}}
2
nlo 55.1 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.
gru 1.1 4
5 == Verwenden von Platzhaltern ==
6
awa 44.9 7 {{figure image="1_de_PlatzhalterEMail.png" group="platzhalter"}}
gru 15.5 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]].
gru 1.1 9 {{/figure}}
10
awa 44.9 11 {{figure image="2_de_Platzhalter.png" width="150" group="platzhalter"}}
gru 1.1 12 Die geöffnete Platzhalterauswahl. Hier kann ein Formularfeld ausgewählt werden, dessen Wert genutzt wird.
13 {{/figure}}
14
gru 15.2 15 === Verwendung in Aktionen ===
gru 1.1 16
gru 15.2 17 Bei Optionsfeldern von Aktionen, die diese unterstützen, kann über das Symbol rechts die Platzhalterauswahl geöffnet werden.
18
gru 1.1 19 === Verwendung in Templates ===
20
awa 44.10 21 {{figure image="3_de_PlatzhalterTemplates.png" group="platzhalter"}}
gru 15.3 22 Platzhalter können auch in Templates genutzt werden. Der Knopf //Platzhalter// öffnet das entsprechende Auswahlmenü.
gru 1.1 23 {{/figure}}
24
gru 15.3 25 Das Platzhaltermenü kann über den Knopf //Platzhalter// im Template-Editor geöffnet werden oder auch über die Tastenkombination //Strg// + //Leerzeichenzeichentaste//.
gru 1.1 26
27 == Platzhaltertypen ==
28
sas 68.2 29 {{id name="sec_form_placeholder"/}}
sas 68.1 30
gru 1.1 31 === Formularplatzhalter ===
32
33 {{panel monospace="true" title="Syntax"}}
awa 44.12 34 [%<NameDesFormularelements>%]
gru 1.1 35 {{/panel}}
36
gru 15.1 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.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.
gru 1.1 38
awa 30.1 39 Beispielweise wird der Platzhalter //[%tfVorname%]// durch den Wert des [[Eingabefelds>>doc:Formcycle.FormDesigner.FormElements.Input]] mit Namen //Vorname// ersetzt.
gru 1.1 40
41 === Spezielle Formularplatzhalter ===
42
gru 24.3 43 Einige spezielle Formularplatzhalter existieren für alle Formulare:
gru 1.1 44
awa 44.12 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//.
gru 1.1 49
50 === Systemplatzhalter ===
51
52 {{panel monospace="true" title="Syntax"}}
awa 44.12 53 [%$<Name>%]
gru 1.1 54 {{/panel}}
55
56 Dieser Platzhalter wird ersetzt durch den entsprechenden Systemwert. Aktuell stehen folgende Systemplatzhalter in Aktionen und Templates zur Verfügung.
57
awa 44.8 58 ; [%$CLIENT_ID%]
59 : Gibt die Mandant-ID des Formulars zurück.
60 ; [%$FORM_LINK%]
61 : Gibt die URL des Formulars zurück.
62 ; [%$FORM_PROCESS_LINK%]
63 : Gibt die URL des Formulars mit dem Inhalt des Vorgangs zurück.
64 ; [%$FORM_VERIFY_LINK%]
65 : Gibt die einmalige Bestätigungs-URL zurück (nötig für [[Double-Opt-In>>doc:Formcycle.UserInterface.MyForms.DoubleOptIn.WebHome]]).
66 ; [%$FORM_INBOX_NAME%]
67 : {{version major="6" minor="1"/}}Gibt den Namen des Postfachs zurück, indem sich der Vorgang derzeit befindet.
68 ; [%$PROCESS_ID%]
69 : Gibt die aktuelle Prozess-ID des Vorgangs zurück.
70 ; [%$PROJECT_ALIAS%]
71 : Alias des derzeitigen Formulars.
72 ; [%$PROJECT_ID%]
73 : Gibt die Formular-ID zurück.
74 ; [%$PROJECT_NAME%]
75 : Name des derzeitigen Formulars.
76 ; [%$RECORD_ID%]
77 : ID des derzeitigen Vorgangs.
78 ; [%$SOURCE_SERVER%]
79 : Gibt den Namen des Servers zurück, auf welchem dieser bereitgestellt und abgesendet wurde (Name des {{fserver case="gen"/}} oder lokal).
80 ; [%$SOURCE_SERVER_URL%]
81 : Gibt die URL des Servers zurück, auf welchem dieser bereitgestellt und abgesendet wurde (Name des {{fserver case="gen"/}} oder lokal).
82 ; [%$STATUS_ID%]
83 : ID des derzeitigen Status.
84 ; [%$STATUS_NAME%]
85 : Name des derzeitigen Status.
gru 1.1 86
nlo 52.1 87 ==== Parametrisierbare Systemplatzhalter ====
88
89 {{panel monospace="true" title="Syntax"}}
90 [%$<Name>(<Parameter>...)%]
91 {{/panel}}
92
93 ; [%$DATE("<format>", <lang>)%]
gru 67.4 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}}.
nlo 52.1 95 ; [%$FORM_DATE_CREATED("<format>", <lang>)%]
gru 67.4 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}}
nlo 52.1 97 ; [%$FORM_DATE_MODIFIED("<format>", <lang>)%]
gru 67.4 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}}
nlo 52.1 99
sas 68.1 100 {{id name="sec_user_variables"/}}
nlo 53.4 101
nlo 53.1 102 === Benutzerplatzhalter {{version major="6" minor="4" patch="0"/}} ===
nlo 52.1 103
nlo 59.2 104 {{id name="fig_prefill_user_variables"/}}
nlo 60.1 105 {{figure image="prefill_user_variables_de.png"}}Vorbefüllung von Formularfeldern mit Daten des angemeldeten Benutzers.{{/figure}}
nlo 59.2 106
sas 68.1 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
sas 68.3 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
nlo 60.1 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"]]).
nlo 54.1 120
nlo 45.2 121 {{panel monospace="true" title="Syntax"}}
nlo 46.2 122 [%$&lt;Benutzerobjekt&gt;.&lt;Attribut&gt;%]
nlo 45.2 123 {{/panel}}
nlo 45.1 124
sas 68.3 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.
nlo 48.1 126
nlo 61.1 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.
nlo 49.1 128
nlo 46.2 129 ==== Benutzerobjekte ====
nlo 45.1 130
nlo 46.2 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
nlo 48.1 140 ==== Attribute ====
141
nlo 53.2 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.
nlo 49.1 143
nlo 51.1 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
nlo 57.1 152 ; firstName
153 : Vorname des angemeldeten Benutzers
nlo 51.1 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
nlo 62.1 161 : Ein Benutzerprofil kann einen sog. "linked identifier" haben. Dies ist der Identifikator eines anderen Benutzerprofils.
nlo 51.1 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
sas 68.1 185 {{id name="sec_appointment_variables"/}}
186
nlo 64.1 187 === Terminplatzhaler {{version major="6" minor="5" patch="0"/}} ===
188
nlo 67.2 189 Terminplatzhalter können verwendet werden, wenn mit dem Formular [[Termine>>doc:Formcycle.FormDesigner.FormElements.Appointment.WebHome]] gebucht werden.
nlo 67.1 190
nlo 66.1 191 {{panel monospace="true" title="Syntax"}}
192 [%$&lt;Name&gt;%]
193 {{/panel}}
194
nlo 64.1 195 ; [%$APPOINTMENT_LIST%]
nlo 65.1 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.
nlo 64.1 197 ; [%$APPOINTMENT_LINK%]
198 : Erzeugt einen Link zu einer iCal-Datei, die sämtliche Termine des Vorgangs beinhaltet.
199
sas 68.2 200 {{id name="sec_system_placeholder_html"/}}
sas 68.1 201
gru 1.1 202 === Systemplatzhalter für HTML-Templates ===
203
204 {{panel monospace="true" title="Syntax"}}
awa 44.11 205 [%$&lt;Name&gt;(&lt;Parameter1&gt;,&lt;Parameter2&gt;)%]
gru 1.1 206 {{/panel}}
207
gru 10.1 208 Zusätzlich zu den allgemeingültigen Systemplatzhaltern gibt es noch einige weitere Systemplatzhalter, welche nur innerhalb eines [[HTML-Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.HTML.WebHome]] verwendet werden können. Diese dienen zum Herunterladen von Anhängen und sind hierfür nur innerhalb der Browser-Session nach dem Absenden eines Formulars nutzbar.
gru 1.1 209
awa 44.11 210 ; [%$ATTACHMENT_LIST%]
211 : Stellt alle an einem Vorgang verfügbaren Anhänge (Attachments) in einer Liste zum Herunterladen bereits. Die erzeugte Liste wird als //ul//-HTML-Element in das Tempalte eingefügt.
212 ; [%$ATTACHMENT_ZIP=Dateiname,Link-Text%]
213 : Erzeugt einen Link zum Herunterladen aller Anhänge eines Vorgangs. Die Parameter //Dateiname// sowie //Link-Text// sind optional, sodass dieser Systemplatzhalter in folgenden Varianten genutzt werden kann.
214 :; [%$ATTACHMENT_ZIP=Dateiname,Link-Text%]
215 :: Erzeugt einen Link mit dem Text //Link-Text// zum Herunterladen der Datei, die den Dateinamen //Dateiname// erhält.
216 :; [%$ATTACHMENT_ZIP=Dateiname%]
217 :: Erzeugt einen Link mit dem Text //Dateiname// zum Herunterladen der Datei, die den Dateinamen //Dateiname// erhält.
218 :; [%$ATTACHMENT_ZIP%]
219 :: Erzeugt einen Link mit dem Text //attachment.zip// zum Herunterladen der Datei, die den Dateinamen //attachment.zip// erhält.
220 ; [%$ATTACHMENT=Anhang,Link-Text,Dateiname%]
221 : Erzeugt einen Link zum Download eines einzelnen Anhangs eines Vorgangs mit dem Namen "Anhang". Dieser muss für eine korrekte Funktion den Namen einer erzeugten bzw. an den Vorgang angehangenen Datei entsprechen. Die Parameter "Link-Text" und "Dateiname" sind hierbei optional, sodass sich folgende Verwendungsmöglichkeiten ergeben:
222 :; [%$ATTACHMENT=Anhang,Link-Text,Downloadname%]
223 :: Erzeugt einen Link mit dem Text //Link-Text// zum Herunterladen des Anhangs mit dem Namen //Anhang//, der den Dateinamen //Dateiname// erhält.
224 :; [%$ATTACHMENT=Anhang,Link-Text%]
225 :: Erzeugt einen Link mit dem Text //Link-Text// zum Herunterladen des Anhangs mit dem Namen //Anhang//, der den Dateinamen //Anhang// erhält.
226 :; [%$ATTACHMENT=Anhang%]
227 :: Erzeugt einen Link mit dem Text //Anhang// zum Herunterladen des Anhangs mit dem Namen //Anhang//, der den Dateinamen //Anhang// erhält.
gru 1.1 228
229 Zusätzlich ist bei dieser Art von Platzhaltern zu beachten, dass sie automatisch aus dem Template entfernt werden, wenn keine entsprechende Datei gefunden wurde bzw. erzeugt werden konnte.
230
231 === Textbausteinplatzhalter ===
232
233 {{panel monospace="true" title="Syntax"}}
awa 44.11 234 [%$$&lt;Name&gt;%]
gru 1.1 235 {{/panel}}
236
awa 44.11 237 Ein Textbausteinplatzhalter gibt den Inhalt eines [[Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]] (zum Beispiel [[Text->>doc:Formcycle.UserInterface.FilesAndTemplates.Text]], [[Mail->>doc:Formcycle.UserInterface.FilesAndTemplates.Email]], [[Link-Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.Link]]) zurück und wird beispieslweise in Aktionen vom Typ [[E-Mail>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.EMail]] verwendet.
gru 1.1 238
239 === Aktionsplatzhalter ===
240
241 {{panel monospace="true" title="Syntax"}}
awa 44.11 242 [%$&lt;Aktionsname&gt;.&lt;RückgabeWert&gt;%]
gru 1.1 243 {{/panel}}
244
245 Einige Aktionen haben Rückgabewerte, die über diesen Platzhalter ausgelesen werden können.
246
247 Sie sehen ähnlich wie Systemplatzhalter aus, haben aber im Unterschied zu diesen einen Punkt als Trennzeichen zwischen dem Namen der Aktion und dem Rückgabewert. Folgende Rückgabebezeichner sind vorhanden.
248
awa 44.11 249 ; [%$<Aktionsname>.SUCCESS%]
250 : 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.
253 ; [%$<Aktionsname>.RESULT%]
254 : Rückgabe eines einzelnen Ergebnis. Liefert String-Wert zurück.
255 ; [%$<Aktionsname>.RESULT[<Index>].<Bezeichner>%]
256 : 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.

Navigation

Copyright 2000-2024