Proporciona información de error para los cambios anteriores en un origen de datos.

Información general

Pueden producirse errores cuando se cambia un registro de un origen de datos. Esto puede deberse a numerosas causas, como interrupciones de red, permisos inadecuados y conflictos de edición.

La función Patch y otras funciones de datos no devuelven errores directamente. En su lugar, devuelven el resultado de la operación. Una vez que se haya ejecutado una función de datos, puede usar la función Errors para obtener los detalles de los errores. Puede comprobar la existencia de errores con la función [IsEmpty] en la fórmula IsEmpty( Errors ( ... ) ).

Puede evitar que se produzcan algunos errores mediante las funciones Validate y DataSourceInfo. En el tema relativo al trabajo con orígenes de datos, encontrará más sugerencias sobre cómo trabajar con los errores y evitarlos.

Descripción

La función Errors devuelve una tabla de errores que contiene las columnas siguientes:

  • Registro. Registro del origen de datos que contenía el error. Si el error se produjo durante la creación de un registro, esta columna estará en blanco.

  • Columna. Columna que produjo el error, en caso de que el error pueda atribuirse a una sola columna. De lo contrario, estará en blanco.

  • Mensaje. Descripción del error. Esta cadena de error se puede mostrar para el usuario final. Tenga en cuenta que este mensaje puede generarlo el origen de datos, por lo que podría ser largo y contener nombres de columna sin formato carentes de significado para el usuario.

  • Error. Código de error que se puede usar en las fórmulas para ayudar a resolver el error:

ErrorKind Descripción
ErrorKind.Conflict Se ha realizado otro cambio en el mismo registro, lo que produce un conflicto de cambios. Use la función Refresh para volver a cargar el registro e intente de nuevo el cambio.
ErrorKind.ConstraintViolation Se han infringido una o más restricciones.
ErrorKind.CreatePermission Se ha intentado crear un registro, pero el usuario actual no tiene permiso para crear registros.
ErrorKind.DeletePermission Se ha intentado eliminar un registro, pero el usuario actual no tiene permiso para eliminar registros.
ErrorKind.EditPermission Se ha intentado editar un registro, pero el usuario actual no tiene permiso para editar registros.
ErrorKind.GeneratedValue Se ha intentado cambiar una columna que el origen de datos genera automáticamente.
ErrorKind.MissingRequired El valor de una columna necesaria no está en el registro.
ErrorKind.None No hay ningún error.
ErrorKind.NotFound Se ha intentado editar o eliminar un registro, pero no se pudo encontrar. Es posible que otro usuario haya cambiado el registro.
ErrorKind.ReadOnlyValue Se ha intentado cambiar una columna que es de solo lectura.
ErrorKind.Sync El origen de datos ha notificado un error. Consulte la columna Mensaje para obtener más información.
ErrorKind.Unknown Se ha producido un error, pero es de tipo desconocido.
ErrorKind.Validation Se ha detectado un problema de validación general que no se corresponde con ninguno de los demás tipos.

Los errores pueden devolverse para el origen de datos completo o para una sola fila seleccionada si se proporciona el argumento Record a la función.

La función Patch u otras funciones de datos pueden devolver un valor en blanco si, por ejemplo, no se pudo crear un registro. Si pasa un valor en blanco a Errors, le devolverá información de error adecuada en estos casos. El uso posterior de funciones de datos en el mismo origen de datos borrará esta información de error.

Si no hay ningún error, la tabla que Errors devuelve estará vacía y se podrá probar con la función IsEmpty.

Sintaxis

Errors( DataSource [, Record ] )

  • DataSource: requerido. Origen de datos para el que quiere devolver errores.
  • Record: opcional. Registro específico para el que quiere devolver errores. Si no especifica este argumento, la función devuelve errores para todo el origen de datos.

Ejemplos

Paso a paso

En este ejemplo, vamos a trabajar con el origen de datos IceCream:

A través de la aplicación, un usuario carga el registro Chocolate en un formulario de entrada de datos y cambia el valor de Quantity a 90. El registro con el que se va a trabajar se coloca en la variable de contexto EditRecord:

  • UpdateContext( { EditRecord: First( Filter( IceCream, Flavor = "Chocolate" ) ) } )

Para realizar este cambio en el origen de datos, se usa la función Patch:

  • Patch( IceCream, EditRecord, Gallery.Updates )

donde Gallery.Updates se evalúa como { Quantity: 90 }, ya que solo se ha modificado la propiedad Quantity.

Por desgracia, justo antes de que se invoque la función Patch, otra persona modifica la propiedad Quantity de Chocolate y la establece en 80. PowerApps lo detecta y no permite que se produzca el cambio en conflicto. Puede comprobar esta situación mediante la fórmula:

  • IsEmpty( Errors( IceCream, EditRecord ) )

que devuelve false, ya que la función Errors ha devuelto la tabla siguiente:

Registro Columna Mensaje Error
{ Flavor: "Chocolate", Quantity: 100 } en blanco "Otro usuario ha modificado el registro que está intentando modificar. Vuelva a cargar el registro e inténtelo de nuevo." ErrorKind.Conflict

Puede colocar una etiqueta en el formulario para mostrar este error al usuario.

  • Para mostrar el error, establezca la propiedad Text de la etiqueta en esta fórmula:
    Label.Text = First(Errors( IceCream, EditRecord )).Message

También puede agregar un botón Recargar en el formulario para que el usuario pueda resolver eficazmente el conflicto.

  • Para mostrar el botón solo cuando se haya producido un conflicto, establezca la propiedad Visible del botón en esta fórmula:
    !IsEmpty( Lookup( Errors( IceCream, EditRecord ), Error = ErrorKind.Conflict ) )

  • Para revertir el cambio cuando el usuario selecciona el botón, establezca su propiedad OnSelect en esta fórmula:
    ReloadButton.OnSelect = Revert( IceCream, EditRecord )