Validierungs- und Benachrichtigungsmechanismen

Überblick

Die Validierung stellt sicher, dass Benutzereingaben die erforderlichen Kriterien erfüllen. Nach der Validierung erhalten Benutzer Feedback über klar definierte Benachrichtigungsmechanismen. In dieser Dokumentation wird beschrieben, wann und wie Validierungen anzuwenden sind und welche Feedback-Methoden zu verwenden sind.

Eine ausführliche Orientierungshilfe zur Verwendung von Validierungs- und Benachrichtigungsmechanismen finden Sie im folgenden Entscheidungsbaum für UI-Komponenten.

Validierungsmechanismen

Typ	Zweck	Zu verwenden	Feedback-Methode
Clientseitige Validierung	Einzelne Felder in Echtzeit validieren	Wenn ein Feld den Fokus verliert (klicken oder mit der Tab-Taste verlassen)	Integriertes Eingabeverhalten: Warnstatus für Felder
Serverseitige Validierung	Daten validieren, nachdem ein Formular, ein Schritt oder eine Seite an den Server übermittelt wurde	Für komplexe oder Backend-Validierungen	Warnstatus für Felder, Popup, Modal oder Inline-Benachrichtigung

Clientseitige Validierung

Clientseitige Validierungen werden durchgeführt, sobald der Benutzer die Eingabe von Daten in einem Feld abgeschlossen hat. Die Validierung wird ausgelöst, wenn das Feld den Fokus verliert, d. h., wenn der Benutzer das Fenster über die Tab-Taste verlässt oder außerhalb des Felds klickt. Diese Validierung erfolgt nahezu umgehend und hilft Benutzern, Fehler zu beheben, sobald sie auftreten.

Jutro empfiehlt die Verwendung von Benachrichtigungen über den Status von Feldern, um clientseitige Validierungsmeldungen anzuzeigen. Viele Eingabekomponenten, z. B. die Texteingabekomponente, verfügen über diese integrierten Warnstatus, die kontextbezogenes Feedback auf Feldebene direkt im Feld anzeigen. Diese Status geben visuell das Ergebnis der Benutzereingabe oder der Systemvalidierung an. Sie können die Status durch Verwendung des Fehlerstatus im Eingabefeld aktivieren. Dieses Verhalten wird für alle Eingabetypen unterstützt.

Ein Beispiel für die Verwendung des Fehlerstatus bei Eingaben zur Anzeige von Warnstatus finden Sie unter Verwenden von Fehlertext zur Anleitung der Benutzer in der Dokumentation zur Texteingabekomponente.

Serverseitige Validierung

Diese Validierungen werden durchgeführt, wenn ein Formular, ein Schritt, eine Seite oder ein Prozess an den Server übermittelt wird. Der Server gibt die Ergebnisse der Validierung je nach Dringlichkeit und Schweregrad der Meldung mithilfe verschiedener Mechanismen zurück.

Jutro empfiehlt, wo immer möglich clientseitige Validierungen zu verwenden, um eine schnellere Fehlerbehebung zu gewährleisten. Verschiedene Benachrichtigungstypen wie Inline-Benachrichtigung, Popup und Modal können in Verbindung mit Feldstatusmeldungen zur Anzeige serverseitiger Validierungsmeldungen verwendet werden.

Bei Aufgaben, die Schritte oder Seiten umfassen, sollten Sie Validierungen auf jeder Seite und nicht erst am Ende des Prozesses vornehmen. Dadurch wird die kognitive Überlastung durch Fehler reduziert und eine bessere Orientierungshilfe bei Fehlern geboten.

Mechanismen zur Verwendung von Meldungen

Benachrichtigungstyp	Dringlichkeit	Zweck	Auslöser	Platzierung/Ort	Validierungstyp
Feedback auf Feldebene	Hoch	Validierungsstatus für Felder in Echtzeit anzeigen	Wenn ein Feld den Fokus verliert (klicken oder mit der Tab-Taste verlassen) oder nach der Formularübermittlung	Direkt im Feld	Clientseite
Inline-Benachrichtigung	Mittel	Kontextbezogenes Feedback in der Nähe von Feldern oder Bereichen	Nach der serverseitigen Validierung	In der Nähe der zugehörigen Eingabe oder des zugehörigen Bereichs	Serverseite
Popup	Gering	Kurzes Status-Update für System-Feedback	Nach der serverseitigen Validierung	Oben rechts im Viewport	Serverseite
Modal	Hoch	Blockiert den Ablauf, um kritische Fehler oder Aktionen anzuzeigen	Nach der serverseitigen Validierung	Über abgeblendetem Hauptinhalt	Serverseite

Meldungstypen (nach Schweregrad)

Jeder Meldungstyp kann die folgenden Schweregrade haben:

• Fehler
• Warnung
• Erfolg
• Informatorisch

Modale werden für kritische Meldungen verwendet, die die gezielte Aufmerksamkeit des Benutzers erfordern. Verwenden Sie für Meldungen, die weniger Aufmerksamkeit erfordern, andere verfügbare Möglichkeiten zum Übermitteln von Meldungen.

Fehlermeldungen

Fehlermeldungen informieren Benutzer über Fehler, fehlgeschlagene Aktionen oder kritische Probleme, die den Benutzer daran hindern können, den Vorgang fortzusetzen. Fehlermeldungen müssen ausreichende Informationen zur Behebung des Problems oder Alternativen zum Abschließen des Vorgangs enthalten.

Einige Beispiele:

• Ungültige oder falsche Einträge in Feldern
• Fehlende erforderliche Felder
• Überschrittene Grenzwerte
• Systemfehler

Warnmeldungen

Warnmeldungen informieren Benutzer über Bedingungen, die zwar nicht den aktuellen Arbeitsablauf beeinträchtigen, aber in einer späteren Phase oder einem späteren Schritt zu Fehlern im Arbeitsablauf führen können.

Einige Beispiele:

• Probleme mit Formulareinträgen, z. B. doppelte Einträge
• Aktualisierungen mit Auswirkungen auf den Aufgabenablauf
• Benachrichtigung bei Inaktivität oder Ablauf der Sitzung
• Seite oder Ablauf aufgrund unzureichender Berechtigungen blockiert

Erfolgsmeldungen

Erfolgsmeldungen informieren Benutzer darüber, dass eine Aufgabe erfolgreich abgeschlossen wurde. Diese Meldungen können als Reaktion auf eine Benutzeraktion oder automatische Hintergrundprozesse erfolgen.

Einige Beispiele:

• Richtiger Feldwert
• Erfolgreiches Erstellen, Aktualisieren oder Löschen
• Gültige Datenauswahl

Informationsmeldungen

Informationsmeldungen enthalten hilfreiche Informationen für Benutzer, die bei der Ausführung von Aufgaben helfen können oder auf die nächsten Schritte hinweisen.

Einige Beispiele:

• Felder, die vor der Hochstufung ausgefüllt werden müssen
• Benachrichtigung, dass ein Objekt schreibgeschützt ist
• Aktualisierungen auf Systemebene, z. B. Objekt zur Bearbeitung verfügbar

Inhalt

Allgemeine Richtlinien fürs Schreiben

• Verwenden Sie die Großschreibung des ersten Worts und von Substantiven für alle Aspekte der Gestaltung von Guidewire-Produktschnittstellen. Schreiben Sie nicht alles groß.
• Verwenden Sie in den meisten Situationen Verben im Präsens und im Aktiv.
• Verwenden Sie gebräuchliche Abkürzungen, um Ihrem Text einen natürlichen und informellen Ton zu verleihen.
• Verwenden Sie eine einfache Sprache. Vermeiden Sie unnötigen Jargon und komplexe Sprache.
• Halten Sie Wörter und Sätze kurz.

Eine Anleitung zum Schreiben von Benachrichtigungen finden Sie unter Schreiben effektiver Meldungen.

Um Stilrichtlinien auf Komponentenebene anzuzeigen, klicken Sie auf der Jutro Design System-Website für die jeweilige Komponente auf die Registerkarte Verwendung und navigieren Sie dann zum Abschnitt Inhalt.

Barrierefreiheit

Jutro-Komponenten wurden validiert, um die WCAG 2.1 AA-Richtlinien für Barrierefreiheit zu erfüllen. Von Autoren des Inhalts vorgenommene Änderungen können sich jedoch auf die Konformität mit der Barrierefreiheit auswirken. Weitere Informationen finden Sie in der folgenden Anleitung und im WAI-ARIA Authoring Practices Guide:

• Geben Sie alle notwendigen Anweisungen und Hinweise an, damit der Benutzer eine Aufgabe ausführen kann.
• Stellen Sie sicher, dass Validierungsmeldungen in einer logischen Lesereihenfolge angezeigt werden und über die Tastatur bearbeitet und übermittelt werden können.
• Beschriftungen müssen programmgesteuert mit den entsprechenden Elementen verknüpft werden.
• Der Zustand eines Felds darf nicht allein durch Farbe kenntlich gemacht werden. Verwenden Sie unterstützenden Text und Symbole, um den Zustand für Screenreader zugänglich zu machen.
• Symbole oder Grafiken können nur dann als einzige visuelle Kennzeichnung (ohne visuellen Text) verwendet werden, wenn die Bedeutung des Symbols visuell offensichtlich ist UND wenn eine programmgesteuerte zugeordnete semantische Kennzeichnung für assistive Technologien vorhanden ist.
• Längere Fehlermeldungen müssen unter Verwendung von aria-describedby mit Eingaben verknüpft werden. Dadurch wird sichergestellt, dass der Screenreader den angezeigten Fehler ausgibt, wenn Benutzer zu einem Eingabefeld navigieren. Weitere Informationen zu aria-describedby finden Sie unter Describing aria-describedby.
• Geben Sie Fehlerzusammenfassungen und gegebenenfalls Möglichkeiten an, zu einzelnen Fehlern zu navigieren.

Reaktionsfähigkeit

Die Mechanismen zur Verarbeitung von Benachrichtigungen in Jutro sind responsiv, solange die Komponente, das Seitenlayout oder das Muster, in denen sie verwendet werden, responsiv sind.

Theming

Standardmäßig entsprechen Theming und Branding der Anwendung, es sei denn, sie werden überschrieben.

Muster können mit Themes gestaltet werden, um bestimmte Markenanforderungen und Kundenwünsche zu erfüllen. Dazu gehören visuelle Elemente wie Farben, Typografie, Symbole, Schaltflächen und andere Komponenten und grafische Elemente.

Erfahren Sie mehr über das Theming mit Design-Token