Histórico da Página
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 , Sequencia 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 | ||
---|---|---|
| ||
Utilizando o Fluxo de Trabalho SequencialPasso 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 e selecionar a opção "Exibir Manipuladores de Fault". |
...
Passo 2: Após selecionar a opção, será exibida a funcionalidade de tratamento de falhas. Passo 3: Agora é necessário associar a atividade "Tratar Exceção" ao "fluxo de trabalho" à atividade Sequência. Passo 4: Após atividade ter sido associada, é necessário configurar as propriedades da atividade.
Passo 5: Após configurar a exceção é necessário associar a atividade "Gerar Exceção" ao "Fluxo de Trabalho Sequencial". 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. Passo 7: A atividade "Tratar Exceção" contêm tipos diferentes de alternativas para tratamento da exceção. Para escolher, basta selecionar a atividade e preencher a propriedade FaultType. Neste caso será utilizada o tipo Exception. Passo 8: Após configurar a exceção é necessário associar a atividade "Gerar Exceção" à "Exceções de Fluxo de Trabalho". 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". |
Expandir | ||
---|---|---|
| ||
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 Após seguir os passos do exemplo anterior, podemos adicionar o envio de email antes da atividade "Gerar Exceção" Em seguida, deve selecionar a atividade rmsSendEmailActivity1 e adicionar as propriedades. Adicione o Assunto, o destinatário e o remetente desejado. 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
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. Mensagem enviada para o email: |
Expandir | ||
---|---|---|
| ||
Utilizando uma atividade padrãoNeste 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. |
...
Para selecionar a funcionalidade de tratamento de falhas basta clicar no ícone e selecionar a opção "Exibir Manipuladores de Fault". Após selecionar a opção, basta seguir os passos 2 ao 9 do exemplo anterior.
|
...
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). |