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 basierend auf diesen 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 Validateblank 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.
• Column – Erforderlich. Die Spalte, die überprüft werden soll.
• Wert – Erforderlich. Der Wert für die ausgewählte Spalte, die überprüft werden soll.

Validate( DataSource, OriginalRecord, Updates )

• 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

Überprüfen mit einem vollständigen Datensatz