Chamar um Bot de Mensagens diretamente do Formulário

Visão Geral

O Bot de Mensagens foi originalmente projetada pra funcionar de forma isolada e independente. Se queremos enviar mensagens por ele, criamos uma fila (ex: uma tabela ou coluna de controle do banco de dados) e preparamos o Bot para monitorá-la.

Problema

No entanto, em muitos casos, seria mais prático se pudéssemos simplesmente chamar de forma direta o Bot de Mensagens em uma ação de Formulário, como por exemplo, quando o queremos enviar um e-mail de confirmação após a operação realizada.

Neste tópico, temos um exemplo dessa necessidade.

Solução

Criar uma nova ação nos procedimentos do Formulário chamada “Executar Bot de Mensagens” (RunMessageBot).

Interface Visual

A nova ação, deve abrir uma tela de Vinculação de Objeto (a mesma que já é usada para vincular outros tipos de Objetos no Formulário):

Atualização das Dependências

Adicionando a Dependência

Ao vincular o Bot de Mensagens ao Formulário, ele deve se tornar automaticamente uma dependência (seção do Formulário). No entanto, esse tipo de dependência precisa ser de um tipo especial. Um tipo que não permita que ela seja removida enquanto o Bot de Mensagens estiver sendo referenciado.

Para criar este comportamento, vamos criar um diferenciador para o tipo de dependência (kind), podendo ser Automática (A=auto) ou Manual (M=manual)

Tipo Metadado Comportamento
Automática A Gerada automaticamente quando um Objeto for referenciado no Formulário.
Manual M Adicionada manualmente pelo desenvolvedor. Usada em casos de Objetos que são chamados diretamente do código fonte ou em URL’s

Removendo a Dependência

Assim como a dependência surge de forma automática quando vinculamos o Bot de Mensagens, ela deve ser removida também de forma automática quando não estiver sendo usada em nenhum ponto do Formulário.