Categorias
FLUIG

FLUIG – Modelo simples de envio de email personalizado em eventos de processo + template de email

No post de hoje, trago uma solução bem simples para envio de emails em eventos de workflow.

Explicarei cada trecho do código ao longo do post, e no final, disponibilizarei os arquivos javascript, e html, para vocês baixarem.

*Lembrando que para os scripts abaixo, funcionem corretamente, as configurações de email devem estar ajustadas e testadas no WCMADMIN.


Vamos iniciar pelo script de envio, declarando algumas variáveis com informações provenientes dos campos do formulário utilizado no processo.

Em seguida, crio uma lista java, chamada PARAMETROS.

Nessa lista PARAMETROS, insiro as informações que eu preciso passar para o template de email, utilizando o padrão (CHAVE, VALOR)

Essa chave SUBJECT, em específico, é a responsável pelo assunto do email.
Nesse exemplo, estou informando o pagamento de uma solicitação, e concatenando algumas variáveis.

Agora, vamos aos destinatários. Para isso, eu crio um array java, chamado DESTINATARIOS.

Utilizo o método SPLIT para dividir os emails inseridos no campo do formulário separados por “;”.

Rodo um FOR a partir da quantidade de emails detectados na variável EMAILS.

Pra finalizar o script e enviar o email, utilizamos a função NOTIFY, alimentando os 5 parâmetros, com as seguintes informações:

Parâmetro 1: Matricula Fluig do usuário remetente deste email.
Recomendamos a criação de um usuário especialmente para utilização como remetente, e que no cadastro dele, seja inserido o mesmo endereço de email da conta cadastrada para envios no WCMADMIN, pois, alguns servidores de email, como o OUTLOOK, não aceitam que uma conta envie mensagens utilizando um endereço de remetente diferente do endereço dela.

Parâmetro 2: Código do TEMPLATE DE EMAIL cadastrado no Painel de Controle do Fluig. Ainda nesse post, exibo um template exemplo.

Parâmetro 3: A variável PARAMETROS, com as informações que serão utilizadas no Template de Email.

Parâmetro 4: A variável DESTINATÁRIOS com a lista de endereços que receberão o email.

Parâmetro 5: Formato do email enviado.


Agora, vamos ao Template de Email:

Lembram daquelas informações que adicionamos a lista java PARAMETROS para posteriormente serem exibidas no template de email? Aqui estão elas, referenciadas entre ${} no arquivo html. Esse é um exemplo básico, mas vocês podem passar quantas informações precisarem do script para o template.

O destinatário receberá o email parecido com esse, com as informações preenchidas no lugar das variáveis entre ${}:

Agora, mãos a obra! Clique no link abaixo, e faça o download dos arquivos que exibi ao longo desse post.

https://drive.google.com/file/d/1eY4ogAjhAxiJBj8ykTQtz44Yp7ApmfmJ/view?usp=sharing

Caso este tutorial tenha lhe ajudado, deixe um comentário abaixo. Adoraremos saber!

¹Fluig é uma marca registrada da Totvs S.A.

Categorias
FLUIG

FLUIG – Como contornar limitação de 350 caracteres na expressão de uma condição de gateway?

Sabe aquele momento em que você está preenchendo a expressão de um gateway, com 1.000 condições, todo felizão, e de repente quando vai exportar o diagrama, recebe esse erro?

Calma! Não se desespere… rsrsrs

Como corrigir?
Uma solução prática para resolver esse problema, é criando um script de workflow personalizado.

No Eclipse, clique em FILE >> NEW >> SCRIPT FLUIG.

Uma janela será aberta, selecione “Script Evento Workflow” e clique em “Next”.

Digite um nome para o evento, relacione ao diagrama e clique em “Finish”.

O código será criado, e ficará disponível na pasta workflow/scripts. Ao abrir o arquivo, visualizamos que uma função é criada com o mesmo nome do evento. Insira as condições necessárias para o seu projeto, e retorne um valor, ele será utilizado na chamada dentro da expressão do gateway.

Após isso, é só chamar a função dentro da Expressão, e informar o valor desejado para a determinada condição:

Caso este tutorial tenha lhe ajudado, deixe um comentário abaixo. Adoraremos saber!

¹Fluig é uma marca registrada da Totvs S.A.

Categorias
FLUIG

FLUIG – Como contornar o erro “A different object with the same identifier value was already associated with the session”

Situação: Exportação de Formulário

Erro: A different object with the same identifier value was already associated with the session : [com.datasul.technology.webdesk.forms.model.CardEvent#com.datasul.technology.webdesk.forms.model.EventFichaPK[codEmpresa=1, nrDocumento=29, nrVersao=168000, codEvent=enableFields]]. 
ps: A mensagem de erro no Eclipse aparecerá resumida até o trecho “session:”. Clique na mensagem de erro e arraste para baixo, para visualizar a mensagem completa.

Causa: Em alguns casos, o merge do git pode criar tags HEAD nos scripts, ou até mesmo duplicar arquivos e nomeá-los com HEAD no final, conforme print abaixo:

Nesse caso em específico, o arquivo enableFields foi duplicado e renomeado com HEAD. No final da mensagem de erro, é informado o arquivo que está com problemas, com a propriedade codEvent.

Solução: Exclua o(s) arquivo(s) e/ou trecho(s) de código(s) duplicados(s), e a exportação ocorrerá normalmente.

Caso este tutorial tenha lhe ajudado, deixe um comentário abaixo. Adoraremos saber!

¹Fluig é uma marca registrada da Totvs S.A.

Categorias
FLUIG

FLUIG – Como corrigir o problema que causa logoff automático do usuário?

Nos últimos dias, alguns de nossos clientes nos relataram o seguinte problema na plataforma:
-Ao movimentar solicitações, o sistema efetua logoff do usuário automaticamente.

Analisando o log do servidor, identificamos a seguinte mensagem:

 SEVERE [org.springframework.boot.web.servlet.support.ErrorPageFilter] (default task18) Forwarding to error page from request [/api/v1/pages/versions/published] due to exception [The request was rejected because the URL was not normalized.]: org.springframework.security.web.firewall.RequestRejectedException: The request was rejected because the URL was not normalized. 

Incluímos evidências e anexamos em um ticket na Totvs.

Uma das soluções apresentadas, e que foi a que corrigiu o problema em nossos clientes, foi a desativação de um recurso do Fluig¹, que inclusive a Totvs descontinuou: Fluig Messaging.

Para desativar o serviço, fomos orientados a seguir as seguintes instruções:

-Acesse a plataforma logando com o usuário WCMADMIN. Caso não saiba como realizar esse acesso, há um tutorial neste link: https://bit.ly/2O6t0Gg
-Edite a empresa.
-Clique em “Cadastrar Dados Adicionais”.
-Remova todas as chaves que possuírem a palavra “messaging”.
-Salve, feche o navegador, e acesse novamente com uma aba anônima para testar a correção.

Realizando esses procedimentos, é possível que o problema seja resolvido em seu ambiente Fluig¹.

Caso este tutorial tenha lhe ajudado, deixe um comentário abaixo. Adoraremos saber!

¹Fluig é uma marca registrada da Totvs S.A.

Categorias
FLUIG

FLUIG – Como identificar qual base está sendo utilizada?

Quando se tem diversas bases do Fluig¹, como (Dev, Homologação e Produção), surge a necessidade de acessar determinados arquivos, parâmetros e serviços, dependendo de qual base estamos logados. Para facilitar essa identificação, podemos criar um dataset em cada uma das bases, e chama-lo para retornar o host da base.

Para isso, na tela inicial do Fluig¹, acesse o Painel de Controle, clique em Datasets.

No botão “Novo Dataset”, selecione a opção “Simples”, conforme imagem abaixo:

Um modal será aberto solicitando a inclusão de um código e uma descrição. Preencha da forma que desejar, e clique em próximo.

No campo “Serviço”, selecione a opção FluigDSRO.

No campo Tabela, clique na lupa. Um modal será aberto. Na barra de pesquisa do canto superior direito, procure pela tabela “FDN_PARAMGERAL”, e clique no resultado exibido logo abaixo. Em seguida, clique no botão salvar para concluir a criação do dataset.

Feito! Agora é só chamar esse dataset, aonde desejar, e filtrar a coluna “DATA_KEY” pelo valor fluig/server.url

A identificação da base desejada estará na coluna ao lado “DATA_VALUE”, conforme imagem abaixo:

Fique a vontade para fazer comentários e sugestões!
Em breve, compartilharemos mais conteúdos sobre Fluig¹.

¹Fluig é uma marca registrada da Totvs S.A.