Funktionen Validate

Gäller för: Arbetsyteappar Modellbaserade appar

Funktionen Validate kontrollerar om värdet för en enda kolumn eller en fullständig post är giltigt för en datakälla.

Beskrivning

Innan en användare skickar en dataändring kan du ge direkt feedback på giltigheten, vilket ger en bättre användarupplevelse.

Datakällor kan tillhandahålla information om vad som är giltiga värden i en post. Den här informationen kan innehålla många begränsningar, till exempel:

• om en kolumn kräver ett värde
• hur lång en textsträng kan vara
• hur högt och lågt ett tal kan vara
• hur tidigt och sent ett datum kan vara

Funktionen Validate använder denna information för att avgöra om ett värde är giltigt och för att returnera ett lämpligt felmeddelande om det inte är det. Du kan använda funktionen DataSourceInfo för att se samma information som Validate använder.

Det varierar hur mycket verifieringsinformation datakällorna ger, ibland kan de inte ge någon alls. Validate kan bara verifiera värden baserat på den här informationen. Även om Validate inte hittar något problem, kan tillämpningen av dataändringen fortfarande misslyckas. Du kan använda funktionen Errors för att hämta information om felet.

Om Validate hittar ett problem returnerar funktionen ett felmeddelande som du kan visa för användaren av programmet. Om alla värden är giltiga returnerar Validate ett blank-värde. När du arbetar med en samling som inte har någon verifieringsinformation, är värdena alltid giltiga.

Syntax

Validera( Datakälla; Kolumn; Värde )

• DataSource – Obligatoriskt. Datakällan som man ska verifiera med.
• Kolumn – obligatoriskt. Kolumnen som ska verifieras.
• Värde – Obligatoriskt. Värdet för den markerade kolumnen som ska verifieras.

Validera (DataSource,OriginalRecord,Uppdateringar )

• DataSource – Obligatoriskt. Datakällan som man ska verifiera med.
• OriginalRecord – obligatoriskt. Den post som uppdateringar ska verifieras till.
• Uppdateringar – krävs. Ändringar som ska tillämpas på den ursprungliga posten.

Exempel

I de här exemplen måste värdena i kolumnen Percentage i datakällan Scores vara mellan 0 och 100. Om datan har klarat verifieringen returnerar funktionen ett blank-värde. I annat fall returneras ett felmeddelande.

Verifiera med en enda kolumn

Formel	Beskrivning	Resultat
Validera ( Poäng, Procent, 10 )	Kontrollerar om 10 är ett giltigt värde för kolumnen Percentage i datakällan Scores.	blank
Validera ( Poäng, Procent, 120 )	Kontrollerar om 120 är ett giltigt värde för kolumnen Percentage i datakällan Scores.	”Värdena måste vara mellan 0 och 100”.

Verifiera med en fullständig post

Formel	Beskrivning	Resultat
Validera ( Scores, EditRecord, Gallery.Updates )	Kontrollerar om värden i alla kolumner är giltiga för datakällan Poäng. I det här exemplet är värdet i Procent-kolumnen 10.	blank
Validera ( Scores, EditRecord, Gallery.Updates )	Kontrollerar om värden i alla kolumner är giltiga för datakällan Poäng. I det här exemplet är värdet i kolumnen Procent 120.	”Värdena måste vara mellan 0 och 100”.