Evento e-mail

Versão 3.1 por FlowFast em 2023/04/05 11:13

Eventos de envio de e-mail podem ser configurados com as seguintes opções:

Corpo e assunto do e-mail

O corpo do e-mail é definido pelo Texto cadastrado que pode ser um HTML formatado, com imagens etc, ou um texto plano, esse texto pode ser reutilizado.

O texto e o assunto podem conter chaves de substituição no formato {CHAVE} que serão substituídas no momento do envio com o valor referente a cada chave, essas chaves podem ser campos da tarefa ou variáveis do fluxo, ex: {DES_NOME}, {XCP_SEQ_EXECUCAO}, {VLR_SOLICITADO}, etc. Todos os campos das tarefas que já foram executadas no fluxo ficam disponíveis para substituição.

Destinatário

O destinatário do e-mail pode ser:

1-Usuário do sistema	Definir um usuário especifico como destinatário. OBS: se o usuário não possuir e-mail no seu cadastro o e-mail não será enviado.
2-E-mail fixo	Definir um e-mail fixo. Exemplo de uso poderia ser um grupo de e-mails: financeiro@empresa.com.br. Aceita vários e-mails separados por virgula(,) ex: pedro@empresa.com.br,maria@empresa.com.br
3-Executor de uma lane	Nesta opção é definida uma das lanes do BPM, o(s) destinatário(s) do e-mail será(ão) os executores da(s) tarefa(s) que já foi(ram) aberta(s) nesta lane. Ou seja, quando o evento for executado será buscado os executores já definidos da lane, caso não tenha sido aberta nenhuma tarefa ainda na lane, nenhum e-mail será enviado. Exemplo de uso: e-mail de aviso ao solicitante do processo, ou aviso do andamento do processo à um executor de uma tarefa anterior.
4-Cargo a partir do exec. da lane	Busca o usuário com o cargo definido a partir do executor de uma lane, assim como no item acima essa lane já deve ter alguma tarefa aberta/executada. A busca do pelo cargo é feita no setor do usuário executor, caso não seja encontrado é feita a busca dentro dos setores do mesmo nível do setor do usuário executor, caso ainda não seja encontrado a busca é feita subindo nos níveis dos setores sucessivamente. OBS: O sistema buscará somente um usuário com o cargo, o primeiro que encontrar seguindo os níveis dos setores. Desta forma é importante que exista somente um usuário com o cargo. Exemplo de uso: Aprovação pelo Gerente
5-Superior a partir do exec. da lane	Busca o usuário responsável pelo setor do executor de uma lane. 1º passo - Verifica-se o responsável pelo setor, se existir e não for o próprio executor da lane este será o destinatário, caso contrario vai para o próximo passo 2º passo - Verifica-se o responsável pelo setor, se existir este é o destinatário, caso não esteja definido buscará um usuário dentro deste setor.
7-Executor da tarefa anterior	O destinatário será o executor da tarefa anterior/origem.
8-Setor	Os destinatários serão todos usuários que pertencem ao setor definido.
9-Equipe	Os destinatários serão todos usuários que pertencem à equipe definida.

Algumas opções é possível definir os valores por programação. Ao selecionar a opção de programação irá mostrar a variável de deverá ser preenchida com o valor desejado. Exemplo, para opção setor a variável é {OUT_COD_SETOR}. Caso a variável retorno não seja definida ou seja um valor que não encontre referencia o e-mail não será enviado.

Campo	Descrição
Texto	Texto cadastrado com o corpo do e-mail que será enviado. O texto pode conter chaves de substituição no formato {CHAVE} que serão substituídas no momento do envio com o valor referente a cada chave, essas chaves podem ser campos da tarefa ou variáveis do fluxo, ex: {DES_NOME}, {XCP_SEQ_EXECUCAO}, {VLR_SOLICITADO}, etc. Todos os campos das tarefas que já foram executadas no fluxo ficam disponíveis para substituição.
Assunto	Assunto do e-mail, também pode conter chaves de substituição como no Texto.
Tipo de link	É possível adicionar ao texto do e-mail um link para que o destinatário clique e abra diretamente a execução da tarefa ou os detalhes do processo. Ao selecionar 1-Detalhes do processo: o link gerado redirecionará para o painel de detalhamento da instância do processo. 2-Tarefa anterior/origem: o link gerado redirecionará para a tela da tarefa que originou a execução deste evento, é útil para ser utilizados a partir de um evento de borda, como por exemplo um timer de aviso de prazo da tarefa. Se for utilizado em uma sequência que partiu de uma execução de tarefa esse link levará a própria tarefa executada, em modo de visualização. 3-Tarefas abertas na sequência: O link gerado será da(s) tarefa(s) aberta(s) que estão na sequência de execução após este evento. Caso sejam abertas mais de uma tarefa para cada tarefa será enviado um e-mail ao(s) destinatário(s) definido(s). Para configurar o link no texto é necessário seguir as instruções abaixo. Será gerada uma URL parcial(relativa a raiz da URL da aplicação) como chave de substituição com o nome {des_url}, essa chave deverá ser colocada numa TAG A no HTML do texto com o atributo href juntamente com a raiz da da URL(endereço da aplicação). Exemplo: <a href="https://www.flowfast.com.br/XCape/{des_url}">Clique aqui para executar</a>. Existe um parâmetro de sistema (Acesso/3) que pode ser configurada a URL principal de acesso à aplicação, com isso pode ser utilizada outra chave de substituição {des_url_root} ao inves de deixar a URL fixa no texto. Desta forma o exemplo ficaria assim: <a href="{des_url_root}{des_url}">Clique aqui para executar</a>.