Función Validate en PowerAppsValidate function in PowerApps

La función Validate comprueba si el valor de una única columna o un registro completo es válido para un origen de datos.The Validate function checks whether the value of a single column or a complete record is valid for a data source.

DescripciónDescription

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.Before a user submits a data change, you can provide immediate feedback on the validity of that submission, resulting in a better user experience.

Los orígenes de datos pueden proporcionar información sobre qué constituyen valores válidos en un registro.Data sources can provide information on what constitutes valid values within a record. Esta información puede incluir muchas restricciones, como en estos ejemplos:This information can include many constraints, such as these examples:

  • si una columna requiere un valorwhether a column requires a value
  • qué longitud puede tener una cadena de textohow long a string of text can be
  • cuál puede ser el valor más alto y más bajo de un númerohow high and low a number can be
  • cuál puede ser la fecha más temprana y la más tardíahow early and late a date can be

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.The Validate function uses this information to determine whether a value is valid and to return an appropriate error message if not. Puede usar la función DataSourceInfo para ver la misma información que usa Validate.You can use the DataSourceInfo function to view the same information that Validate uses.

Los orígenes de datos varían en la cantidad de información de validación que proporcionan; incluso pueden no ofrecer ninguna.Data sources vary in how much validation information they provide, including not providing any at all. Validate solo puede verificar valores basándose en esta información.Validate can only verify values based on this information. Incluso si Validate no detecta ningún problema, es posible que se siga produciendo un error al aplicar el cambio de datos.Even if Validate doesn't find a problem, applying the data change may still fail. Puede usar la función Errors para obtener información sobre el error.You can use the Errors function to obtain information about the failure.

Si Validate encuentra un problema, la función devuelve un mensaje de error que puede mostrar al usuario de la aplicación.If Validate finds a problem, the function returns an error message that you can show to the user of the app. Si todos los valores son válidos, Validate devuelve blank.If all values are valid, Validate returns blank. Cuando trabaja con una colección que no tiene ninguna información de validación, los valores siempre son válidos.When you work with a collection that has no validation information, values are always valid.

SintaxisSyntax

Validate( DataSource, Column, Value )Validate( DataSource, Column, Value )

  • DataSource: requerido.DataSource – Required. El origen de datos con el que realizar la validación.The data source to validate with.
  • Column: requerido.Column – Required. La columna que se va a validar.The column to validate.
  • Value: requerido.Value – Required. El valor de la columna seleccionada que se debe validar.The value for the selected column to be validated.

Validate( DataSource, OriginalRecord, Updates )Validate( DataSource, OriginalRecord, Updates )

  • DataSource: requerido.DataSource – Required. El origen de datos con el que realizar la validación.The data source to validate with.
  • OriginalRecord: requerido.OriginalRecord - Required. El registro con el que se van a validar las actualizaciones.The record to which updates are to be validated.
  • Updates: requerido.Updates - Required. Los cambios que se van a aplicar al registro original.The changes to apply to the original record.

EjemplosExamples

Para estos ejemplos, los valores de la columna Percentage del origen de datos Scores deben estar comprendidos entre 0 y 100, ambos incluidos.For these examples, values in the Percentage column of the Scores data source must be between 0 and 100, inclusive. Si los datos pasan la validación, la función devuelve blank.If the data passes validation, the function returns blank. En caso contrario, la función devuelve un mensaje de error.Otherwise, the function returns an error message.

Validar con una sola columnaValidate with a single column

FórmulaFormula DescripciónDescription ResultadoResult
Validate( Scores, Percentage, 10 )Validate( Scores, Percentage, 10 ) Comprueba si 10 es un valor válido para la columna Percentage del origen de datos Scores.Checks whether 10 is a valid value for the Percentage column in the Scores data source. en blancoblank
Validate( Scores, Percentage, 120 )Validate( Scores, Percentage, 120 ) Comprueba si 120 es un valor válido para la columna Percentage del origen de datos Scores.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Los valores deben estar comprendidos entre 0 y 100"."Values must be between 0 and 100."

Validar con un registro completoValidate with a complete record

FórmulaFormula DescripciónDescription ResultadoResult
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Comprueba si 10 es un valor válido para la columna Percentage del origen de datos Scores.Checks whether 10 is a valid value for the Percentage column in the Scores data source. en blancoblank
Validate( Scores, EditRecord, Gallery.Updates )Validate( Scores, EditRecord, Gallery.Updates ) Comprueba si 120 es un valor válido para la columna Percentage del origen de datos Scores.Checks whether 120 is a valid value for the Percentage column in the Scores data source. "Los valores deben estar comprendidos entre 0 y 100"."Values must be between 0 and 100."