¶ Beschreibung
Konstanten werden für grundlegende Werte wie das aktuelle Datum oder der Loginname des angemeldeten Nutzers verwendet. Wie der Name schon sagt, können Sie Konstanten nur auslesen, nicht verändern. Bitte achten Sie bei der Verwendung der Kontanten auf Groß-/Kleinschreibung.
Syntax: [?Konstante]
In ähnlicher Weise können Sie per Platzhalter auf die aktuellen Eingabewerte von Controls, Variablen bzw. DB-Abfragen zugreifen.
Syntax:
[@Control]
[$Variable]
[%Datenbankabfrage]
[Funktion()]
[@@GlobaleVariable]
So können Sie z. B. als Abschluss einer Datenerhebung die Eingaben des Nutzers noch einmal zusammenfassend anzeigen. Nutzen Sie dazu diese Platzhalter als Ersetzungsvorschrift in einer Funktion.
Bei einigen Controls gibt es die Besonderheit, dass Sie per Platzhalter auf verschiedene Werte zugreifen können. Zum Beispiel bei dem Control CheckBox rufen Sie den aktuellen Wert, die aktuelle Gewichtung bzw. die aktuelle Textbelegung ab. Dazu wird dem Platzhalter ein entsprechendes Suffix angehängt.
Beispiel:
Für das Control mit dem Namen chk_Familienstand liefern die Platzhalter[@chk_Familienstand] den Wert True, falls das Häkchen in der Checkbox gesetzt wurde,[@chk_Familienstand.Value] die Gewichtung 1 bzw. [@chk_Familienstand.Text] die Textbelegung Verheiratet.
Beispiele für andere Controls sind TimePicker mit den Platzhalteranhängen .Max bzw. .Min für die Eigenschaften MaxDate bzw. MinDate oder die ComboBox mit dem Platzhaltersuffix .Key, um die ID der gewählten Option zu ermitteln.
¶ Hinterlegte Konstanten
¶ Formular
| Formulardaten | |
|---|---|
| Ersetzungsvorschrift | Zweck |
[?form_sfx_file] |
Pfad und Dateiname der aktuellen sfx-Datei Hinweis: In Web-Formularen ist dies die Angabe der Datensatznummer (globale ID), die Teil der URL eines Datensatzes ist. Die ID, die je Datensatz in der View (Datentabelle) ausgegeben wird, ist davon verschieden und hat den Platzhalter |
[?form_sfx_filename] |
Dateiname der aktuellen sfx-Datei |
[?form_sfd_file] |
Pfad und Dateiname der aktuellen sfd-Datei |
[?form_sfd_filename] |
Dateiname der aktuellen sfd-Datei |
[?form_sfx_data] |
sfx-Ausgabe |
[?focusedcontrolname] |
Name des Controls mit aktuellem Fokus |
[@AnzahlSeiten] |
Gesamtanzahl der Formularseite Hinweis: Nutzen Sie diese Funktion in einem Label. |
[@aktuelleSeite] |
Aktuelle Seitenzahl Hinweis: Nutzen Sie diese Funktion in einem Label. |
[@aktuelleDruckSeite] |
Aktuelle Seitenzahl bei Druckausgabe |
[?SLID] |
Silverlight-ID (nur bei Webformularen einsetzbar) |
[?form_id] |
FormularID auslesen |
[?form_nr] |
Nummer des aktuellen Datensatzes auslesen, die in der Spalte "ID" in der Datentabelle ausgegeben wird. Hinweis: Diese Funktionalität steht ab Version 5.4 ausschließlich für Webformulare bereit. Diese Nummer wird je Datensatz nach dem Speicherprozess generiert. Windowsformulare werden nicht nummeriert. |
[?form_name] |
FormularName auslesen |
[$Variablenname] |
Zugriff auf den Inhalt einer internen Variable |
| FormManager | |
|---|---|
| Ersetzungsvorschrift | Zweck |
[?fm_state] |
den aktuellen Formularstatus (zur Laufzeit) auslesen |
[?fm_result] |
das aktuelle Ergebnis auslesen |
| Umfragen | |
|---|---|
| Ersetzungsvorschrift | Zweck |
[?Umfrage_Anzahl] |
Anzahl der im Formular vorhandenen Fragen, für die Checkboxen in einer Checkbox-Gruppe mit aktiviertem Feature "Für Umfrage verwenden" als Antwortmöglichkeiten (Multiple Choice) definiert wurden |
[?Umfrage_Richtig] |
Anzahl der korrekten Antworten eines Benutzers, der an der Umfrage teilnimmt (Berechnung zur Laufzeit) |
[?Umfrage_Falsch] |
Anzahl der falschen Antworten eines Benutzers, der an der Umfrage teilnimmt (Berechnung zur Laufzeit) |
¶ Benutzer
¶ Active Directory
| Ersetzungsvorschrift | Zweck |
|---|---|
[?ad:xxxxxxxx] |
Userattribut aus Active-Directory auslesen |
[?ad:nutzername:xxxxxxxx] |
bestimmtes Userattribut aus Active-Directory auslesen |
Mit Hilfe dieser Platzhalter nutzen Sie die Informationen aus Active Directory optimal für die effiziente Datenerhebung.
Zusätzlich empfiehlt sich die Verwendung von PeoplePicker. Denn hier profitieren Sie von dem Zusammenspiel beider Komponenten, indem Sie z. B. folgendes kombinieren: Per PeoplePicker-Control wird eine Person gewählt, woraufhin bestimmte Datenfelder automatisch mit den Informationen zu dieser Person aus dem Active Directory belegt werden. Dazu definieren Sie für Ihr PeoplePicker-Control das AD-Attribut sAMAccountName als Key und belegen per Funktionseditor z. B. eine TextBox automatisch mit dem Wert [?ad:[@peoplepicker_1.Key]:mail].
¶ Systemumgebung
| Ersetzungsvorschrift | Zweck |
|---|---|
[?env_username] |
Loginname des Windows Nutzers |
[?env_machinename] |
Name des Computers |
[?env_domainname] |
Domainname des Rechners |
[?env_systemdirectory] |
Systemverzeichnis |
[?env_OSVersion] |
OS Version |
[?env_OSPlatform] |
OS Plattform |
[?env_tempfolder] |
Ordner für temporäre Dateien |
[?env:Variablenname] |
bestimmte Umgebungsvariable auslesen |
[?sv:Variablename] |
eine gewünschte Variable des Server auslesen (z.B. LOGON_USER, REMOTE_ADDR) |
Das Auslesen von Servervariablen ([?sv:Variablename] ) funktioniert nur in einem Webformular. Eine Liste mit verfügbaren Servervariablen finden sie hier: IIS Server Variables
Hinweis: Wird eine Variable des IIS Servers nicht gefunden, so wird folgende Antwort generiert: SL-Fehler (Variable 'XYZ' nicht gefunden)
Diese Information kann auch auf dem Formularserver im Logprotokoll eingesehen werden.
¶ System
¶ Datum & Zeit
| Ersetzungsvorschrift | Zweck |
|---|---|
[?Time] |
aktuelle Zeit (16:32:32) |
[?Time_1] |
aktuelle Zeit (16:32) |
[?Time_2] |
aktuelle Zeit (Sekunde) |
[?Time_3] |
aktuelle Zeit (Minute) |
[?Time_4] |
aktuelle Zeit (Stunde) |
[?Date] |
aktuelles Datum (Donnerstag, 17. August 2000) |
[?Date_1] |
aktuelles Datum (02.11.2006) |
[?Date_2] |
aktuelles Datum (02. November) |
[?Date_3] |
aktuelles Datum (Tag) |
[?Date_4] |
aktuelles Datum (Monat) |
[?Date_5] |
aktuelles Datum (Jahr) |
[?DateTime] |
aktuelles Datum (Donnerstag, 17. August 2000 16:32:32) |
[?Timestamp] |
abgelaufene Millisekunden seit dem 1.1.1970 (1418818159) |
Platzhalter können auch bezogen auf Eingaben in TimePicker-Controls verwendet werden.
¶ Hilfswerte
| Ersetzungsvorschrift | Zweck |
|---|---|
[?form_lasterror] |
der letzte Fehler im Formular |
[?GUID] |
neuer globaler eindeutiger Identifizierer |
[?TickCount] |
Betriebszeit des PC in ms |
¶ Komponenten
| Ersetzungsvorschrift | Zweck |
|---|---|
[?tb:TextmodulID] |
Platzhalter durch Textbaustein aus tbx Datei über ID |
¶ Funktionen
¶ Datum
| Ersetzungsvorschrift | Zweck |
|---|---|
[add_date("01.01.2006","10","d")] |
Datum um 10 Tage erhöhen |
[sub_date("01.01.2006","10","M")] |
Datum um 10 Monate verringern |
[datediff_toyear("Datum1","Datum2")] |
Differenz zwischen Datum1 und Datum2 in Jahren |
[datediff_tomonth("Datum1","Datum2")] |
Differenz zwischen Datum1 und Datum2 in Monaten |
[datediff_todays("Datum1","Datum2")] |
Differenz zwischen Datum1 und Datum2 in Tagen |
Hinweis: Folgende Optionen können in den Datumsfunktionen add_date und sub_date als Parameter verwendet werden:
| Parameter | Zweck |
|---|---|
"d" |
Tag |
"M" |
Monat |
"y" |
Jahr |
"s" |
Sekunde |
"m" |
Minute |
"h" |
Stunde |
Tipp: Kombinieren Sie diese Funktionen mit Platzhaltern wie etwa [?Date], z. B. [sub_date("[?Date]","1","d")] für die Berechnung des gestrigen Tages ausgehend vom aktuellen Datum.
¶ Zeichenkettenfunktionen
[!Berechnung:0] ist die Mustersyntax für die Durchführung einer Berechnung.
| Ersetzungsvorschrift | Zweck |
|---|---|
[to_lower("HALLO")] |
wandelt String in Kleinbuchstaben um |
[to_upper("hallo")] |
wandelt String in Großbuchstaben um |
[trimend("Zeichenkette"," ")] |
Entfernt Leerzeichen am Ende der Zeichenkette |
[trimstart("Zeichenkette"," ")] |
Entfernt Leerzeichen am Anfang der Zeichenkette |
[str_length("meinString")] |
Gibt die Länge der Zeichenkette zurück |
[str_replace("von","nach","meinString")] |
Ersetzung von Zeichen oder Zeichenketten in einer Zeichenkette |
[isempty("meinString","Standardwert")] |
Prüfung eines Controls auf seinen Inhalt bzw. seinen Wert und Ausgabe des Standardwerts, falls das Control leer ist. Hinweis: isempty bezieht sich bei CheckBoxen, RadioButtons, Rating, TimePicker und UpDownBox auf die Eigenschaft Value, bei ComboBoxen und ChoiceControl auf die selektierten Optionen der Auswahl, bei Label und TextBoxen auf den enthaltenen Text, bei RichTextBoxen auf die Eigenschaft Text, bei LinkLabel, MediaPlayer und WebBrowser auf die Eigenschaft URL bzw. Source, bei PeoplePicker auf die Eigenschaft AD Key bzw. Default Key. |
[regex_replace("[0-9]+;\#","mit","inMeinString")] |
Ersetzung von Zeichen in einer Zeichenkette mit Hilfe regulärer Ausdrücke Gruppierungen können genutzt werden, zB. fünf Zeichen extrahieren: [regex_replace("([\s\S]{5})(.*)","$1","12345 - wegzuschneiden")] |
[regex("Zeichenkette","[0-9]{5}$")] |
Prüfung einer Zeichenkette auf Übereinstimmung mit regulären Ausdrücken |
[encrypt("Zeichenkette","Passwort")] |
Verschlüsselung einer Zeichenfolge |
[decrypt("Codewort","Passwort")] |
Entschlüsselung einer Zeichenfolge |
¶ Dateifunktionen
| Ersetzungsvorschrift | Zweck |
|---|---|
[getdirectoryname("Dateipfad")] |
Verzeichnispfad der Datei |
[getfilename("Dateipfad")] |
Name der Datei |
[getfilenameextension("Dateipfad")] |
Name der Dateiendung |
[getfilenamewithoutextension("Dateipfad")] |
Name der Datei ohne Dateiendung |
¶ Datenbankzugriff
| Ersetzungsvorschrift | Zweck |
|---|---|
[%Datenzugriff:1:SQL Anweisung %] |
SQL Anweisung ausführen |
¶ Weitere Links
- Zur Übersicht über weitere Funktionen
- Verwendung von Platzhaltern in FormServer-Aktionen
- Verwendung von Platzhaltern in E-Mails, die von FormServer versendet werden
- TimePicker-Eingaben per Platzhalter wiederverwenden