Funktion „Validate“

Gilt für: Canvas-Apps Modellgesteuerte Apps

Die Validate-Funktion überprüft, ob der Wert einer einzelnen Spalte oder eines vollständigen Datensatzes für eine Datenquelle gilt.

Beschreibung

Bevor ein Benutzer eine Änderung von Daten übermittelt, können Sie unmittelbar Feedback zur Gültigkeit dieser Übermittlung geben, was zu einer besseren Benutzerfreundlichkeit führt.

Datenquellen können Informationen dazu bereitstellen, was gültige Werte in einem Datensatz auszeichnen. Diese Informationen können viele Einschränkungen enthalten, z. B.:

• ob eine Spalte einen Wert erfordert
• wie lang eine Textzeichenfolge sein kann
• wie groß oder klein eine Zahl sein kann
• wie früh oder spät ein Datum sein kann

Die Validate-Funktion verwendet diese Informationen, um zu bestimmen, ob ein Wert gültig ist, und um eine entsprechende Fehlermeldung zurückzugeben, falls dies nicht der Fall ist. Sie können die DataSourceInfo-Funktion verwenden, um die gleichen Informationen anzuzeigen, die Validate verwendet.

Datenquellen stellen unterschiedlich viele Gültigkeitsinformationen zur Verfügung, manchmal sogar gar keine. Validate kann Werte nur auf Grundlage dieser Informationen überprüfen. Auch wenn Validate kein Problem findet, kann bei der Anwendung der Datenänderung dennoch ein Fehler auftreten. Sie können die Errors-Funktion verwenden, um Informationen über den Fehler abzurufen.

Wenn Validate ein Problem findet, gibt die Funktion eine Fehlermeldung zurück, die Sie dem Benutzer der App anzeigen können. Wenn alle Werte gültig sind, gibt Validate blank zurück. Beim Arbeiten mit einer Sammlung, die über keine Gültigkeitsinformationen verfügt, sind Werte immer gültig.

Syntax

Validate( DataSource, Column, Value )

• DataSource : Erforderlich. Die Datenquelle, mit der überprüft werden soll.
• Spalte – Erforderlich. Die Spalte, die überprüft werden soll.
• Wert – Erforderlich. Der Wert für die ausgewählte Spalte, die überprüft werden soll.

Validieren( Datenquelle, Originaldatensatz, Aktualisierungen )

• DataSource : Erforderlich. Die Datenquelle, mit der überprüft werden soll.
• OriginalRecord – Erforderlich. Der Datensatz, für den Updates überprüft werden sollen.
• Updates – Erforderlich. Die Änderungen, die am ursprünglichen Datensatz vorgenommen werden sollen.

Beispiele

Für diese Beispiele müssen die Werte in der Percentage-Spalte der Scores-Datenquelle zwischen 0 und (einschließlich) 100 liegen. Wenn die Daten die Überprüfung bestehen, gibt die Funktion leer zurück. Andernfalls gibt die Funktion eine Fehlermeldung zurück.

Überprüfen mit einer einzelnen Spalte

Formel	Beschreibung	Ergebnis
Validieren (Punktzahlen, Prozentsatz, 10)	Überprüft, ob 10 ein gültiger Wert für die Percentage-Spalte in der Scores-Datenquelle ist.	leer
Validieren (Punktzahlen, Prozentsatz, 120)	Überprüft, ob 120 ein gültiger Wert für die Percentage-Spalte in der Scores-Datenquelle ist.	"Werte müssen zwischen 0 und 100 liegen."

Überprüfen mit einem vollständigen Datensatz

Formel	Beschreibung	Ergebnis
Validieren(Ergebnisse, Datensatz bearbeiten, Galerie.Updates)	Überprüft, ob die Werte in allen Spalten für die Scores-Datenquelle gültig sind. In diesem Beispiel lautet der Wert der Percentage-Spalte 10.	leer
Validieren(Ergebnisse, Datensatz bearbeiten, Galerie.Updates)	Überprüft, ob die Werte in allen Spalten für die Scores-Datenquelle gültig sind. In diesem Beispiel lautet der Wert der Percentage-Spalte 120.	"Werte müssen zwischen 0 und 100 liegen."