Daten aus einem Datapool können zum Validieren des eingegebenen Werts in einem Formularelement verwendet werden. Diese Lösung braucht keine eigene Anzeige im Datapool, die Konfiguration erfolgt direkt im Formularfeld. Typische Anwendungsfälle sind Formulare, die nur mit einem gültigen Zugangscode aufgerufen / ausgefüllt werden können.
Ist die Überprüfung positiv, können weitere Werte in andere Formularfelder geladen werden (wie Name, Vorname, etc.).
Vorbedingung: Die auszulesenden Spalten im Datapool und die zu befüllenden Formularfelder müssen identisch benannt werden, also beide mit "Nachname".
Schritt 1: Datapool anlegen
Zuerst die Datengrundlage für den Datapool zusammenstellen. Dazu eine CSV-Datei mit den benötigten Angaben füllen und speichern.
Beispiel-Datenquelle:
Danach einen neuen Datapool gem. Anleitung (s. Erstellung eines Datapools) erstellen.
Die bereitgestellte CSV-Datei als Datenquelle in den Datapool laden und die Felder automatisch aus der CSV-Datei generieren. Dazu auf das Zauberstab-Icon klicken:
Den Datapool speichern und schliessen, es müssen keine weiteren Anzeigen definiert oder Einstellungen angepasst werden.
Tipp: Die GUID-Nummer des Datapools notieren, diese wird später noch gebraucht.
2. Schritt: Formular aufbauen
Ein neues Formular aufbauen und die benötigten Felder anlegen. Bitte beachten, dass die Felder, die mit Daten aus dem Datapool befüllt werden sollen, gleich benannt werden wie die Spalten im Datapool.
Für die Eingabe des Zugangscodes / Tokens ein Feld vom Typ Textfeld erstellen.
Im Popup-Fenster mit den Feldeigenschaften den Reiter Eigenschaften aufrufen und eine neue Eigenschaft mit dem Key dataPoolField und dem Wert Token anlegen. So wird definiert, dass bei der Überprüfung des Zugangscodes (Eingabe in diesem Feld) mit der Datapool-Spalte Token verglichen wird:
Im Reiter Validierung einen neuen Datensatz mit der Klassifizierung Fehler erstellen.
Die Checkbox Syntax (java expression parser) verwenden? aktivieren. Im nun sichtbaren Eingabefeld JEP Syntax die Konfiguration eingeben:
Beispielkonfiguration:
searchAndMapDatapoolFields("49ce37db-bfcd-4677-bc76-e98624046704", node("."), Nachname, Vorname, Email) == false
- GUID das Datapools
- Kommagetrennte Liste der Felder, die mit den Daten aus dem Datapool befüllt werden sollen
Zu guter Letzt noch eine Validierungsnachricht hinterlegen, die den Fehler sinnvoll beschreibt, sollte der eingegebene Zugangscode nicht im Datapool gefunden werden.
3. Schritt: Finetuning
In der beschriebenen Umsetzung sind noch keine Zugriffsbeschränkungen definiert.