Februar 2016

AFS-Tutorials Datumsvalidierung

Datumsvalidierung Mit AFS-Formularen können Sie einfach Datums-Validierungen durchführen um z. B. zu überprüfen ob ein Antragsteller bzw. eine Antragstellerin bereits 18 Jahre und somit volljährig ist. Hierzu wird in diesem Tutorial mithilfe von Formularlogik das Systemdatum mit dem eingegebenen Datum verglichen um zu überprüfen, ob dieses auf den Tag genau 18 Jahre in der Vergangenheit liegt. Wenn dies nicht der Fall ist, wird eine Fehlermeldung ausgelöst. Im gezeigten Beispiel erfahren Sie in wenigen Schritten wie Sie die beiden notwendigen Extender konfigurieren und in ein Formular einbauen.

Schritt 1: In AFS-Webadmin einloggen: Loggen Sie sich mit folgenden Zugangsdaten in den AFS-Webadmin ein. Demo-WebAdmin Falls Sie noch keine Zugangsdaten haben, können Sie diese unter folgendem Link anfordern: Zugangsdaten anfordern

Abbildung 1: Loginfenster WebAdmin

Schritt 2: Formular auswählen: Im aktuellen Beispiel handelt es sich um die Formulare „Datum_Validierung_Demo“ in welchem bereits das Datum überprüft wird und „Datum_Validierung_Demo_Leer“ in das Sie in diesem Tutorial eigenständig eine Überprüfung des eingetragenen Datums einfügen. Hierzu existiert bereits das Eingabefeld, jedoch wird nicht überprüft ob das eingegebene Alter auf den Tag genau 18 Jahren entspricht. Über den Button “Voransicht“ rechts in der Zeile der Formulare können Sie sich die beiden Formulare ansehen. Einmal mit und einmal ohne Datums-Validierung. Klicken Sie danach in der Spalte „Formularname“ auf das Formular „Datum_Validierung_Demo _Leer“ um dieses zu bearbeiten.

Abbildung 2: Formularübersicht mit Voransicht

Seite 2 / 5

Abbildung 3: Fertiges Formular „Datum_Validierung_Demo“ inkl. Fehlermeldung. Der Antragsteller wird zum Zeitpunkt der Eingabe (20.01.2016) erst in einem Tag 18 Jahre alt.

Schritt 3: Extender „Datum berechnen“ Klicken Sie nun unter dem Punkt „Extender“ auf „Hinzufügen“ um einen neuen Extender in das Formular einzufügen.

Abbildung 4: Extender hinzufügen Hier wählen Sie den Extender „Datum berechnen“ und konfigurieren ihn wie folgt. Als Verwendungszweck können Sie zur besseren Übersicht eine Funktion eintragen, welche der Extender ausführt. Im aktuellen Fall nennen wir ihn „Datum + 18 Jahre berechnen“ und setzen darunter ein Häkchen bei „Selbsterstellter Verwendungszweck. Im nächsten Schritt wählen wie unter „Datumsfeld“ über die Funktion „Aus Formularbaum auswählen“ das Feld „GEBURTSDATUM (Geburtsdatum (tt.mm.jjjj))“ auf Seite_1 aus. Die Eingabe dieses Feldes wird mithilfe des Extenders modifiziert. Unter „Modifikatoren“ geben Sie nun an, was mit diesem Wert passieren soll. Wir wollen 18 Jahre dazu rechnen und geben daher unter „Tage“, „Wochen“ und „Monate“ den Wert „0“ ein und unter „Jahre“ den Wert „18“. Unter „Modifiziertes Datum“ wählen Sie nun das Feld „Geburtsdatum18 (Geburtsdatzmü18) auf „Seite_2“ aus. In dieses Feld wird der neue Wert nun übertragen. Klicken Sie nun auf „Übernehmen“ um die Änderungen zu speichern.

Seite 3 / 5

Abbildung 5: Extender Konfiguration „Felder: Datum berechnen“

Schritt 4: Extender „Benutzerdefinierte Fehlermeldung anzeigen Klicken Sie nun wieder unter „Extender“ auf „Hinzufügen“ und wählen nun „Formular: Benutzerdefinierte Fehlermeldung anzeigen“ aus. Geben Sie unter Verwendungszweck wieder eine Beschreibung dafür an, die die Funktion des Extenders beschreibt und setzen Sie das Häkchen unter „Selbsterstellter Verwendungszweck“. Danach wählen Sie mittels Fieldpicker die beiden Variablen aus, die mit einander verglichen werden sollen. Wählen Sie dazu unter „Variable 1“ das Feld „Geburtsdatum18 (Geburtsdatum +18) von „Seite_2“ über den Formularbaum aus. Um eine weitere Variable zu verwenden müssen Sie auf das grüne Plussymbol in der Zeile der Variable klicken. Wählen Sie unter „Variable 2 „ das Feld „Systemdatum (Systemdatum (TT.MM.JJJJ) auf „Seite_2“ über den Formularbaum aus. Unter Bedingungen geben Sie nun an „{1} > {2}“ an und sagen damit, dass Variable 1, in dem Fall dass das eingegebene Geburtsdatum plus 18 Jahren höher als das Systemdatum ist, eine Fehlermeldung angezeigt wird. Unter „Fehlermeldung“ geben Sie nun eine beliebige Meldung ein, welche in diesem Fall angezeigt wird und unter „Fehlerfeld“ „GEBURTSDATUM (Geburtsdatum(tt.mm.jjjj)) auf „Seite_1“ an. Dadurch wird der Fehler über dem Eingabefeld auf der ersten Seite angezeigt.

Abbildung 6: Extender Konfiguration „Formular: Benutzerdefinierte Fehlermeldung anzeigen“ Seite 4 / 5

Schritt 5: Fertiges Formular Klicken Sie nun auf „Übernehmen“ und danach „Speichern“ um auf die Formularübersichtsseite zurück zu kehren. Anschließend müssen Sie noch einen „Voll-Abgleich“ durchführen, damit die Änderungen wirksam werden. Danach können Sie über Voransicht das Formular „Datum_Validierung_Demo_Leer“ mit der eben eingebauten Datumsüberprüfung aufrufen.

Abbildung 7: Voll-Abgleich durchführen und Voransicht des Formulars aufrufen

Kontakt aforms2web solutions & services GmbH Alser Straße 4/Hof 1, 1.17, A-1090 Wien www.aforms2web.com Peter Marvin Behrendt, MSc. MBA. Tel: +43 676 305 44 04 [email protected]

Mag. Kurt Waldherr, MSc. MBA. Tel : +43 664 455 83 62 [email protected]

David Glieber Tel : +43 664 384 63 67 [email protected]

Geschäftsführung

Geschäftsführung

IT-Beratung & Vertrieb

Für den Inhalt verantwortlich: aforms2web solutions & services GmbH, A-1090 Wien, Alser Str. 4/Hof 1, 1.17. Alle Rechte vorbehalten. Die verwendeten Namen sind Handelsnamen und/oder Marken der jeweiligen Hersteller. aforms2web übernimmt weder Verantwortung noch Verpflichtungen in Bezug auf dieses Dokument. Druckfehler und Änderungen vorbehalten. Copyright © aforms2web, 2016

Seite 5 / 5