Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Produto

:

TOTVS Framework                                                          

Processo

:

Fórmula Visual

Subprocesso

:

Utilizando a atividade "Tratar Exceção"

Data da publicação

:

18/07/2014

Data da última Alteração:

30/12/2022

Índice

INTRODUÇÃO

...

O que é Exceção:

Exceção significa algo que não é comum, que não faz parte das regras. A exceção ocorre quando acontece algo fora da regra comum, um fato inédito, que não era feito ou conhecido antes. Uma maneira de tentar contornar esses imprevistos é realizar o tratamento dos locais no código que podem vir a lançar possíveis exceções.

Para que server a atividade de Tratar Exceção na Fórmula Visual

Objetivo: A finalidade da atividade "Tratar Exceção" é capturar e tratar as exceções que ocorrem quando se utiliza uma fórmula visual. Ela se difere da atividade Gerar Exceção, uma vez que, esta tende somente a gerar uma nova exceção interrompendo o processo e exibindo uma mensagem.

Quando a atividade pode ser utilizada

Essa atividade pode ser utilizada nos casos em que a fórmula visual gerar erros não tratados, ou desconhecidos.

FUNCIONALIDADE

...

Esta atividade depende de outras atividades que possuem a da funcionalidade de tratamento de falhas. Como Podendo ser utilizada diretamente pelo Fluxo de Trabalho Sequencial ou através de atividades com essa funcionalidade como por exemplo as atividades "Enquanto , Sequência , Se/SeNão , Grupo de Condições, Para Cada Iteração e entre outras atividades disponíveis.No exemplo será utilizada a atividade "Sequência" 

As opções de Tratamento disponíveis são:

Manipuladores de Fault

Essa opção é usada para manipular falhas ocorrentes durante a atividade

EXEMPLOS

...


Expandir
titleUtilizando o Fluxo de Trabalho Sequencial

Utilizando o Fluxo de Trabalho Sequencial

Passo 1: Neste Exemplo, foi utilizada uma Fórmula Visual para criar um novo usuário. Para selecionar a funcionalidade de tratamento de falhas basta clicar no

...

ícone Image Added e selecionar a opção "Exibir Manipuladores de Fault".

...


Image Added


Passo 2: Após selecionar a opção, será exibida a funcionalidade de tratamento de falhas.

Image Modified

Passo 3: Agora é  necessário associar a atividade "Tratar Exceção" ao "fluxo de trabalho" à atividade Sequência.

Image Modified

Passo 4: Após atividade ter sido associada, é necessário configurar as propriedades da atividade.

Image Modified

Selecione a atividade Image Modified e preencha a propriedade FaultType.

Image Modified

No exemplo vamos utilizar a exceção System.Exception que é uma exceção genérica.

 


Passo 5: Após configurar a exceção é necessário associar a atividade "Gerar Exceção" ao "Fluxo de Trabalho Sequencial".

Image Modified

Passo 6: Após configurar a atividade "Gerar Exceção" caso a fórmula visual apresente algum erro, será exibida a mensagem de erro configurada na atividade "Gerar Exceção".

Após selecionar a opção, será exibida a funcionalidade de tratamento de falhas. Agora é  necessário associar a atividade "Tratar Exceção" as Exceções de Fluxo de Trabalho.

Image Added

Passo 7: A atividade "Tratar Exceção" contêm tipos diferentes de alternativas para tratamento da exceção.

Para escolher, basta selecionar a atividade Image Added e preencher a propriedade FaultType. Neste caso será utilizada o tipo Exception. 

Image AddedImage Added

Passo 8: Após configurar a exceção é necessário associar a atividade "Gerar Exceção" à "Exceções de Fluxo de Trabalho".

Image AddedImage Added

Passo 9: Após configurar a atividade "Gerar Exceção" caso a fórmula visual apresente algum erro, será exibida a mensagem de erro configurada na atividade "Gerar Exceção".

Image Added

Expandir
titleEnvio de e-mail da exceção 

Envio de e-mail da exceção 

É possível utilizar a funcionalidade "Tratar Exceção" para enviar um email com a exceção para pessoa responsável.

Neste Exemplo, foi utilizada a mesma fórmula visual do exemplo anterior para criação de um usuário. 

...

Para simular um erro, foi realizada a alteração da senha do usuário criado

Image Added

Após seguir  os passos do exemplo anterior, podemos adicionar o envio de email antes da atividade "Gerar Exceção"

Image Added

Em seguida, deve selecionar a atividade rmsSendEmailActivity1 e adicionar as propriedades. Adicione o Assunto, o destinatário e o remetente desejado.

Image Added

No campo Texto do E-mail deve ser adicionada a mensagem da falha da Exception. Para isso, clique no ícone de inserção e selecione a atividade de "Tratar Exception". O caminho para adicionar a mensagem é RMSWorkflow > faultHandlersActivity > faultHandlerActivity > Fault > Message

Image Added      Image Added


Após a configuração, basta salvar e executar a Fórmula Visual e o email com a exceção capturada será enviado ao destinatário. Como foi utilizada a atividade "Gerar Exception" a mensagem exibida  após a execução será a mensagem tratada.

Image Added

Mensagem enviada para o email:

Image Added

Expandir
titleUtilizando uma atividade padrão

Utilizando uma atividade padrão

Neste Exemplo, foi utilizada a mesma fórmula visual do exemplo anterior, no entanto foi adicionada uma atividade para enviar email dentro da atividade "Sequência" onde será adicionado o tratamento da exceção. 

Image Added

Para selecionar a funcionalidade de tratamento de falhas basta clicar no ícone Image Added e selecionar a opção "Exibir Manipuladores de Fault".

Image Added


Após selecionar a opção, basta seguir os passos 2 ao 9 do exemplo anterior.

Informações
É importante frisar que neste caso, o tratamento da exceção será válida somente para as falhas presentes dentro do fluxo da sequência.

Image Added



Informações
titlePara maiores informações:

Consulte o WikiHelp TOTVS


COMUNIDADE  @FRAMEWORK


Canais de Atendimento:

Chamado: Através do Portal Totvs www.suporte.totvs.com.br

Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 4 – (BI) e 3 –  (Gerador de Relatórios e Planilha).