Validar funció

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

La funció Validate comprova si el valor d'una única 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 funció Validate utilitza aquesta informació per determinar si un valor és vàlid i per retornar un missatge d'error adient si no ho és. Podeu utilitzar la funció DataSourceInfo per visualitzar la mateixa informació que utilitza Validate.

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 en funció d'aquesta informació. Encara que Validate no detecti cap problema, pot ser que el canvi de dades no s'apliqui correctament. Podeu utilitzar la funció Errors per obtenir informació sobre l'error.

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

Sintaxi

Validate(DataSource, 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: obligatori. 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.

Valida amb una única columna

Fórmula	Descripció	Resultat
Validate(Puntuació, Percentatge, 10)	Comprova si 10 és un valor vàlid per a la columna Percentatge de la font de dades Puntuacions.	blank
Validate(Puntuació, 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".

Valida amb un registre complet

Fórmula	Descripció	Resultat
Validate(Puntuacions, EditRecord, Gallery.Updates)	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.	blank
Validate(Puntuacions, EditRecord, Gallery.Updates)	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".