Validate funció

S'aplica a: Aplicacions de llenç Aplicacions basades en models

La Validate funció comprova si el valor d'una sola columna o d'un registre complet és vàlid per a una font de dades.

Descripció

Per tal que un usuari enviï un canvi de dades, podeu proporcionar comentaris immediats sobre la validesa de l'enviament, cosa que us permet una millor experiència d'usuari.

Les fonts de dades poden proporcionar informació sobre què constitueixen valors vàlids dins d'un registre. Aquesta informació pot incloure moltes restriccions, com ara aquests exemples:

• si una columna necessita un valor
• com de llarga pot ser una cadena de text
• com d'alt o baix pot ser un nombre
• com d'hora o tard pot ser una data

La Validate funció utilitza aquesta informació per determinar si un valor és vàlid i per retornar un missatge d'error adequat si no. Podeu utilitzar la funció DataSourceInfo per visualitzar la mateixa informació que Validate utilitza.

Les fonts de dades varien segons la quantitat d'informació de validació que proporcionen i, fins i tot, pot ser que no en proporcionin. Validate només pot verificar els valors basats en aquesta informació. Fins i tot si Validate no troba cap problema, l'aplicació del canvi de dades pot fallar. Podeu utilitzar la funció Errors per obtenir informació sobre l'error.

Si Validate troba un problema, la funció retorna un missatge d'error que podeu mostrar a l'usuari de l'aplicació. Si tots els valors són vàlids, Validate retorna en blanc. Quan treballeu amb una col·lecció que no té informació de validació, els valors sempre són vàlids.

Sintaxi

Validate( Font de dades, columna, valor )

• DataSource : obligatori. La font de dades amb la qual es validarà.
• Columna : Obligatori. La columna que es validarà.
• Valor : obligatori. El valor de la columna seleccionada que es validarà.

Validate( DataSource, OriginalRecord, Actualitzacions )

• DataSource : obligatori. La font de dades amb la qual es validarà.
• OriginalRecord : obligatori. El registre amb el qual es validaran les actualitzacions.
• Actualitzacions : obligatòries. Els canvis que s'aplicaran al registre original.

Exemples

Per a aquests exemples, els valors de la columna Percentatge de la font de dades Puntuacions han d'estar entre 0 i 100, inclosos. Si les dades superen la validació, la funció torna un valor en blanc. En cas contrari, la funció torna un missatge d'error.

Validate amb una sola columna

Fórmula	Descripció	Resultat
Validate( Puntuacions, Percentatge, 10 )	Comprova si 10 és un valor vàlid per a la columna Percentatge de la font de dades Puntuacions.	Buit
Validate( Puntuacions, Percentatge, 120 )	Comprova si 120 és un valor vàlid per a la columna Percentatge de la font de dades Puntuacions.	"Els valors han d'oscil·lar entre 0 i 100".

Validate amb un registre complet

Fórmula	Descripció	Resultat
Validate( Partitures, EditRecord, Galeria.Actualitzacions )	Comprova si els valors de totes les columnes són vàlids per a la font de dades Puntuacions. En aquest exemple, el valor de la columna Percentatge és 10.	Buit
Validate( Partitures, EditRecord, Galeria.Actualitzacions )	Comprova si els valors de totes les columnes són vàlids per a la font de dades Puntuacions. En aquest exemple, el valor de la columna Percentatge és 120.	"Els valors han d'oscil·lar entre 0 i 100".