Esse tipo de evento costumava estar relacionado ao envio de e-mails. Agora, está relacionado a uma situação mais genérica, de envio de mensagens. Se a mensagem será recebida via e-mail ou outro formato, trata-se de uma opção do receptor da mensagem.
O evento de Envio de Mensagem consiste em uma ação computacional que instruirá ao Orquestra BPM enviar uma mensagem durante o andamento do processo, conforme configurado em sua caixa de propriedades.
Essa mensagem poderá ser enviada, atualmente, na forma de um e-mail e/ou notificação do sistema.
Ao clicar em um elemento deste tipo, sua caixa de propriedades possuirá os seguintes campos:
- Título: o título do evento, para identificação;
- Descrição: uma breve descrição do evento, para referência;
- Assunto: o assunto da mensagem de notificação. Esse assunto pode conter variáveis do processo (ex.: {Processo.Codigo} ou do formulário (ex.: {Formulario.idDoCampo});
O token {Processo.LinkTarefa} não pode ser utilizado para eventos de e-mail, já que este evento não possui uma tarefa.
- Variáveis: selecione uma das variáveis do processo para utilizá-las no corpo da mensagem;
- Corpo: digite o corpo da mensagem de notificação. O corpo da mensagem pode ser formatado utilizando tag´s HTML;
- Configuração de Atores: similarmente a configuração de atores da Tarefa de Aprovação, já analisada, podemos aqui determinar quem será o destinatário desta mensagem. O destinatário pode ser um dos atores do sistema a partir de sua configuração posição/área, ou pode ser um endereço de e-mail fixo (ex.: endereco@email.com.br). No caso do uso do endereço fixo, pode ser utilizado o endereço de um grupo de e-mails para enviar a mensagem a diversos usuários ao mesmo tempo (Ex.: grupo@email.com.br). Nesse caso do uso do endereço fixo, também, é possível utilizar variáveis que apontem para um campo do formulário (por exemplo "{Formulario.idDoCampo}") ;
É importante destacar que, apesar de ser possível configurar/incluir mais de uma posição / área ou destinatário no e-mail, esse é sempre enviado somente para o primeiro item de configuração cadastrado. O e-mail somente será enviado para os próximos atores casos os primeiros não estejam disponíveis, ou seja, estejam em ausência temporária. Esse é o mesmo comportamento das tarefas humanas. Caso deseja enviar e-mail para mais de um ator, configure dois eventos de e-mail.
- Cópia: digite o endereço de e-mail fixo para cópia da mensagem ("CC") ou cópia oculta da mensagem ("CO"). Atualmente, va versão corrente, é possível incluir somente um endereço de e-mail. Caso deseja enviar para mais de um, solicite a seu administrador para criar um grupo de e-mails. É possível utilizar variáveis nesses campos (ex.: {Formulario.idDoCampo})
Esse recurso está disponível somente para notificações do tipo e-mail
; - Responder para: esse e-mail será enviado com remetente igual ao remetente padrão do sistema (gerenciado pelo administrador da ferramenta no módulo de parâmetros) ou remetente igual ao endereço de e-mail cadastrado junto ao cadastro principal do processo. Ainda assim, é possível definir aqui um novo endereço de e-mail, conhecido como "reply-to". Caso o usuário queira responder o e-mail recebido, o e-mail de destino será o endereço aqui digitado. É possível utilizar variáveis nesse campo (ex.: {Formulario.idDoCampo})
Esse recurso está disponível somente para notificações do tipo e-mail
; - Anexos: selecione, entre as opções disponíveis, o nome de uma atividade desse mesmo processo. Todos os arquivos anexados durante a execução dessa atividade serão enviados como anexos nessa mensagem.
Atenção
Esse recurso somente está disponível para notificações do tipo e-mail | Atenção!| Ao permitir o envio de anexos o tempo de processamento do evento irá depender do tamanho do anexo sendo enviado. Além disso, o servidor de envio de e-mails pode bloquear o envio caso o anexo esteja acima do limite permitido. Contate seu administrador de redes para maiores informações. |
- Eventos: eventos são chamadas a comandos de banco de dados customizados ("stored procedures"). Devem ser utilizados somente por profissionais técnicos:
- Pré-criação: comando que é executado antes que a mensagem seja enviada;
- Definição do ator: comando que é executado para determinar o destinatário dessa mensagem; nesse caso o box "configuração de atores" acima é ignorado;
- Pós-criação: comando que é executado depois que a mensagem é enviada;
Exemplo de chamada para um evento (considerando que "sp_RegistraDadosNoBD" é uma stored procedure pré-criada no banco de dados):
sp_RegistraDadosNoBD {Processo.Codigo}, '{Formulario.idDoCampo}
No caso de notificações enviadas via e-mail, o e-mail é enviado com o endereço fixo de remetente definido nos parâmetros do sistema, ou com o endereço de e-mail configurado especialmente para este processo.
Para enviar uma mensagem para um e-mail definido em um campo do formulário, existem duas alternativas:
1. Similarmente ao modo como é feito para enviar uma tarefa para um usuário selecionado em um campo do formulário é possível usar exatamente a mesma abordagem para enviar uma mensagem para um usuário selecionado em um campo do formulário. Observe que nessa alternativa o destinatário do email deve ser necessamente um usuário cadastrado e ativo do sistema, e o campo do formulário deve ter armazenado o ID do usuário (e NÃO o endereço de e-mail do usuário)
2. Se o seu campo do formulário é do tipo texto e ele armazendo o próprio endereço de e-mail do usuário, então você deve configurar o evento de mensagem para enviar para um endereço fixo. No campo de endereço fixo do e-mail, digite um token que corresponda ao seu campo onde o endereço é armazenado, no formato {Formulario.idDoCampo}. Saiba mais sobre tokens aqui .
Obs.: Em SIMULAÇÃO / TESTE de processos, o Evento de Envio de E-mail, enviará um e-mail para o usuário que está testando o processo mesmo que haja outros atores configurados para a tarefa.
Os e-mails de CC (com cópia)" e "CO (cópia oculta)", NÃO serão enviados.