Utilizar InvalidPluginExecutionException en actividades de complementos y de flujo de trabajo

Categoría: mantenimiento, uso

Potencial de impacto: medio

Síntomas

Si un complemento sincrónico devuelve a la plataforma una excepción que no sea InvalidPluginExecutionException, en un cliente de Power Apps se mostrará un error al usuario con el mensaje de la excepción Message y el seguimiento de la pila. Esto proporciona una experiencia hostil de usuario ya que es probable que ya sea una situación de frustración.

Si está usando InvalidPluginExecutionException para cancelar intencionalmente la operación debido a un problema de lógica de validación de datos, debe proporcionar orientación aplicable al usuario de la aplicación para que pueda corregir el problema y continuar.

Si el error es inesperado, aún se recomienda detectar la excepción, convertirla en un InvalidPluginExecutionException y luego iniciar la nueva excepción para que las aplicaciones puedan mostrar un mensaje de error amigable con orientación para ayudar a un usuario o personal técnico a identificar rápidamente el problema.

Instrucciones

Los complementos solo deben devolver un InvalidPluginExecutionException por las siguientes razones:

• Mostrar un mensaje útil al usuario
• Se evita que aumente el archivo de seguimiento/registro de eventos

Una excepción InvalidPluginExecutionException iniciada devuelve a la persona que llama con un mensaje amistoso y un código de error IsvAborted. Si no se captura y convierte una excepción en InvalidPluginExecutionException, se generará un código de error IsvUnExpected sin mensaje amistoso mostrado al usuario desde un cliente de Power Apps.

Administrar errores de funciones llamadas en complementos

Dentro de su complemento, normalmente llamará a otras funciones para reutilizar código. La forma de administrar errores en estas funciones es muy importante porque un error no manejado puede hacer que el proceso de trabajo se bloquee. Esto no solo terminará su complemento, sino que también puede finalizar cualquier complemento simultáneo que se esté ejecutando para su organización. Más información: Error: el proceso de trabajador de espacio aislado se interrumpió

Patrones problemáticos

Advertencia

Estos patrones deben evitarse.

No use HTML dentro del texto del mensaje de error.

Las aplicaciones web que acceden a los datos de Dataverse deben codificar en HTML cualquier texto de mensaje de error antes de mostrárselo al usuario. Esto evitará que se procese cualquier HTML en su mensaje como lo desea. Solo mostrará el código HTML.

Vea también

Cancelación de una operación
Depurar actividades de flujo de trabajo personalizadas

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).