Función Validate

Se aplica a: Aplicaciones de lienzo Aplicaciones basadas en modelos

La función Validate comprueba si el valor de una única columna o un registro completo es válido para un origen de datos.

Descripción

Antes de que un usuario envíe un cambio de datos, puede proporcionar información inmediata sobre la validez de ese envío, lo que se traduce en una mejor experiencia de usuario.

Los orígenes de datos pueden proporcionar información sobre qué constituyen valores válidos en un registro. Esta información puede incluir muchas restricciones, como en estos ejemplos:

• si una columna requiere un valor
• qué longitud puede tener una cadena de texto
• cuál puede ser el valor más alto y más bajo de un número
• cuál puede ser la fecha más temprana y la más tardía

La función Validate usa esta información para determinar si un valor es válido y para devolver el correspondiente mensaje de error si no lo es. Puede usar la función DataSourceInfo para ver la misma información que usa Validate.

Los orígenes de datos varían en la cantidad de información de validación que proporcionan; incluso pueden no ofrecer ninguna. Validate solo puede verificar valores basándose en esta información. Incluso si Validate no detecta ningún problema, es posible que se siga produciendo un error al aplicar el cambio de datos. Puede usar la función Errors para obtener información sobre el error.

Si Validate encuentra un problema, la función devuelve un mensaje de error que puede mostrar al usuario de la aplicación. Si todos los valores son válidos, Validate devuelve blank. Cuando trabaja con una colección que no tiene ninguna información de validación, los valores siempre son válidos.

Sintaxis

Validate( DataSource, Column, Value )

• DataSource: requerido. El origen de datos con el que realizar la validación.
• Column: requerido. La columna que se va a validar.
• Value (obligatorio). El valor de la columna seleccionada que se debe validar.

Validate( DataSource, OriginalRecord, Updates )

• DataSource: requerido. El origen de datos con el que realizar la validación.
• OriginalRecord (obligatorio). El registro con el que se van a validar las actualizaciones.
• Updates (obligatorio). Los cambios que se van a aplicar al registro original.

Ejemplos

Para estos ejemplos, los valores de la columna Percentage del origen de datos Scores deben estar comprendidos entre 0 y 100, ambos incluidos. Si los datos pasan la validación, la función devuelve blank. En caso contrario, la función devuelve un mensaje de error.

Validar con una sola columna

Fórmula	Descripción	Resultado
Validate( Scores, Percentage, 10 )	Comprueba si 10 es un valor válido para la columna Percentage del origen de datos Scores.	blank
Validate( Scores, Percentage, 120 )	Comprueba si 120 es un valor válido para la columna Percentage del origen de datos Scores.	"Los valores deben estar comprendidos entre 0 y 100".

Validar con un registro completo

Fórmula	Descripción	Resultado
Validate( Scores, EditRecord, Gallery.Updates )	Comprueba si los valores de todas las columnas son válidos para el origen de datos Puntuaciones. En este ejemplo, el valor de la columna Porcentaje es 10.	blank
Validate( Scores, EditRecord, Gallery.Updates )	Comprueba si los valores de todas las columnas son válidos para el origen de datos Puntuaciones. En este ejemplo, el valor de la columna Porcentaje es 120.	"Los valores deben estar comprendidos entre 0 y 100".