Partilhar via

Lidar com exceção nos plug-ins

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Para plug-ins síncronos, se registrado na área restrita ou não, a plataforma Microsoft Dynamics 365 lida com as exceções transmitidas de um plug-in exibindo uma mensagem de erro em um diálogo da interface do usuário do aplicativo Web. A mensagem de exceção para plug-ins registrados assíncronos é gravada em um registro de Trabalho do Sistema (AsyncOperation) que pode ser exibido na área Trabalho do Sistema do aplicativo Web.

Para plug-ins síncronos, você tem a opção de exibir uma mensagem de erro personalizada na caixa de diálogo de erro do aplicativo Web, fazendo com que seu plug-in lance uma exceção InvalidPluginExecutionException com a cadeia de caracteres da mensagem personalizada como o valor de propriedade da Mensagem da exceção. Se você lançar InvalidPluginExecutionException e não oferecer uma mensagem personalizada, uma mensagem padrão genérica será exibida na caixa de diálogo de erro. Recomenda-se que os plug-ins transmitam somente um InvalidPluginExecutionException de volta para a plataforma.

Se um plug-in síncrono retorna uma exceção diferente de InvalidPluginExecutionException de volta para a plataforma, o diálogo de erro será exibido ao usuário e a mensagem de exceção (System.Exception.Message) com rastreamento de pilha também é gravada em um dos dois lugares. Para os plug-ins não registrados na área restrita, as informações são gravadas no log de eventos do aplicativo no servidor que executa o plug-in. O log de eventos pode ser exibido com a ferramenta administrativa Visualizador de Eventos. Para plug-ins registrados na área restrita, a mensagem de exceção e o rastreamento de pilha são gravados no rastreamento da plataforma do Microsoft Dynamics 365. Para obter mais informações sobre o rastreamento, consulte a seção Log e Rastreamento do tópico Depurar um plug-in.

Confira Também

Desenvolvimento de plug-in
Transmitir dados entre os plug-ins
Gravar um plug-in
Depurar um plug-in
Manipular exceções no código

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais