Datensätze selektieren
Hinweis: Diese Feature sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
Für ein besseres Verständnis empfehlen wir die Dokumentation vollständig durchzulesen und mit dem
Abschnitt Einleitung
zu beginnen.
Zusammenhänge, die in früheren Abschnitten der Dokumentation erklärt wurden, werden hier nicht wiederholt.
Das Plugin ermöglicht es Ihnen spezifische Datensätze für die Anzeige zu selektieren. Dies erfolgt anhand der Werte, die der Benutzer für ein beliebiges Formularfeld übermittelt hat.
Sie benötigen im Formular Felder, die eindeutige Werte enthalten. Mit diesen eindeutigen Werten können Sie dann für die Datenselektion verwenden.
Dazu gehören etwa:
- Listboxen
- Radio Buttons oder Checkboxen
- Felder mit Defaultwerten, die gesetzt wurden durch die Verwendung des Content Plugin - Visforms Form View.
Die konkrete Datensatzauswahl erfolgt allein mit Hilfe des Plugin-Parameters fieldselect.
Anders als alle anderen Plugin-Parameter erwartet der Parameter fieldselect selbst wieder eine Auflistung von Name-Wert Paaren. Die Auflistung von Name-Wert Paaren muss ebenfalls den Syntaxregeln für Plugin-String entsprechen. Mehr dazu in: Formulardaten im Beitrag.
Als Name verwenden Sie die ID des Feldes über dessen Werte selektiert wird. Als Wert können Sie entweder einen eindeutigen Feldwert angeben, etwa gruen oder 3. Oder Sie können ausgewählte Variablen verwenden, etwa für die URL der aktuellen Seite oder den Benutzernamen des angemeldeten Benutzers.
Der folgende fieldselect Parameter etwa sorgt für das Folgende. Es werden nur Datensätze angezeigt, die die Zahl 1 im Feld mit der ID 1 stehen haben und den Wert gruen im Feld mit der ID 5.
"fieldselect":{"1":"1","5":"gruen"}
Note: Bitte beachten Sie, dass auch bei Feldern, die für die Datenselektion verwendet werden, immer die Datenanzeige im Frontend erlaubt sein muss. Das ist selbst dann der Fall, wenn Sie das Feld in der Datenansicht selbst nicht anzeigen, sondern es nur als Steuerfeld für die Datenselektion im Parameter fieldselect verwenden. Das Feld ist also im Parameter fieldlist selbst gar nicht enthalten.
Einbettung des Parameters fieldselect in die Plugin-Zeichenkette
{vfdataview}{"formid":"6","fieldselect":{"1":"1","5":"gruen"},"fieldlist":"1,2,3,5","layout":"list"}{/vfdataview}
Verwendung von Variablen für die Datensatzauswahl
Neben konkreten Werten können Sie auch eine Reihe von Variablen in der Datensatzauswahl verwenden. Der folgende Parameter <span class=code">fieldselect sorgt dafür, dass nur Datensätze angezeigt werden, die im Feld mit der ID 1 die URL der aktuellen Seite stehen haben.
"fieldselect”:{“1”:"[_url]"}
Das Plugin unterstützt folgende Variablen:
- [_url]: URL der aktuellen Seite.
- [_name]: Name des angemeldeten Benutzers.
- [_username]: Benutzername des angemeldeten Benutzers.
- [_email]: E-Mail des angemeldeten Benutzers.
Mit dem Content Plugin - Visforms Form View können Sie ein Formularfeld mit der URL der aktuellen Seite füllen. Das gilt auch für versteckte Formularfelder.
Sie können die Defaultwert-Einstellungen der Felder vom Typ “Text” und “E-Mail” verwenden, um Felder anzulegen, die als Default mit Informationen des angemeldeten Benutzers gefüllt sind. Zu den Informationen gehören:
- der Benutzernamen und
- der E-Mail des angemeldeten Benutzers.
Durch die Option “Readonly” sperren Sie diese Felder zusätzlich vor Veränderungen. Dadurch stehen die entsprechenden Werte dem Plugin für die Datensatzauswahl zur Verfügung stehen.