Validar función
Aplícase a:
Aplicacións de lenzo Aplicacións baseadas en modelos
A función Validate comproba se o valor dunha única columna ou dun rexistro completo é válido para unha orixe de datos.
Descripción
Antes de que un usuario envíe un cambio de datos, pode fornecer comentarios inmediatos sobre a validez dese envío, obtendo unha mellor experiencia do usuario.
As orixes de datos poden proporcionar información sobre o que constitúe valores válidos nun rexistro. Esta información pode incluír moitas restricións, como estes exemplos:
- se unha columna require un valor
- canto tempo pode ser unha cadea de texto
- como de alto e baixo pode ser un número
- como de pronto e tarde pode ser unha data
A función Validate usa esta información para determinar se un valor é válido e para devolver unha mensaxe de erro axeitada se non. Pode usar a función DataSourceInfo para ver a mesma información que Validate usa.
As orixes de datos varían na cantidade de información de validación que fornecen, incluso sen proporcionar ningunha. Validate só pode verificar valores en función desta información. Mesmo se Validate non atopa ningún problema, a aplicación do cambio de datos pode fallar. Pode usar a función Errors para obter información sobre o fallo.
Se Validate atopa un problema, a función devolve unha mensaxe de erro que pode mostrar ao usuario da aplicación. Se todos os valores son válidos, Validate devolve blank. Cando traballa cunha colección que non ten información de validación, os valores son sempre válidos.
Sintaxe
Validate( DataSource, Columna, Valor )
- DataSource – Obrigatorio. Orixe de datos coa que validar.
- Column – Obrigatorio. Columna que validar.
- Value – Obrigatorio. Valor da columna seleccionada que se vai validar.
Validate( DataSource, OriginalRecord, Actualizacións )
- DataSource – Obrigatorio. Orixe de datos coa que validar.
- OriginalRecord - Obrigatorio. Rexistro do que se van validar as actualizacións.
- Updates - Obrigatorio. Cambios que se van aplicar no rexistro orixinal.
Exemplos
Para estes exemplos, os valores da columna Porcentaxe da orixe de datos Puntuacións deben estar entre 0 e 100, inclusive. Se os datos pasan a validación, a función regresa en branco. Se non, a función devolve unha mensaxe de erro.
Validar cunha única columna
| Fórmula | Descripción | Resultado |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | Comproba se 10 é un valor válido para a columna Porcentaxe na orixe de datos Puntuacións. | blank |
| Validate( Scores, Percentage, 120 ) | Comproba se 120 é un valor válido para a columna Porcentaxe na orixe de datos Puntuacións. | "Os valores deben estar entre 0 e 100". |
Validar cun rexistro completo
| Fórmula | Descripción | Resultado |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Comproba se os valores de todas as columnas son válidos para a orixe de datos Puntuacións. Neste exemplo, o valor da columna Porcentaxe é 10. | blank |
| Validate( Scores, EditRecord, Gallery.Updates ) | Comproba se os valores de todas as columnas son válidos para a orixe de datos Puntuacións. Neste exemplo, o valor da columna Porcentaxe é 120. | "Os valores deben estar entre 0 e 100". |