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 el error y convertirlo en un InvalidPluginExecutionException 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. No convertir el mensaje en un InvalidPluginExecutionException generará un error IsvUnExpected sin mensaje mostrado al usuario desde un cliente de Power Apps.

Administrar errores de funciones llamadas en complementos

Normalmente, los complementos llaman a otras funciones para reutilizar el 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. Este proceso de trabajador que se bloquea no solo termina su complemento, sino que también podría terminar cualquier otro complemento concurrente que se ejecute 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 evita que se procese cualquier HTML en su mensaje como lo desea. Solo mostrará el código HTML.

Consulte también

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