Neste momento, utilizando o Fluig Studio, estaremos realizando o cadastro e configuração do processo "Aprovação de Contrato de Matéria Prima", que será acionado pelo TOTVS Agro Bioenergia.
Estas configurações são primordiais para que o processo interaja com o Bioenergia, principalmente ao final do processo, onde serão acionadas rotinas específicas, fechando o ciclo de integração entre os produtos.
Antes de prosseguirmos, é de suma importância que o Fluig Studio esteja configurado. Sendo assim, sugerimos as seguintes documentações de apoio, para a configuração da IDE:
Com o Fluig Studio devidamente configurado, criaremos nosso primeiro processo. Os passos iniciais necessários para a criação do processo estão disponíveis neste link.
IMPORTANTE
Atente-se ao código atribuído para o processo e também sua descrição. Estas informações serão importantes para o momento de cadastrar este processo no Bioenergia.
Atenção
Os processos criados com a finalidade de serem acionados por meio das APIs Fluig, via TOTVS Agro Bioenergia, deverão ser exclusivos para essa finalidade, não sendo recomendado realizar solicitações de tal processo diretamente pela plataforma Fluig.
Complementando a criação do processo apresentado no link anterior, demonstraremos algumas configurações extras que necessitam ser realizadas em todos os processos relacionados a aprovação de contratos de matéria-prima, para o contexto da integração entre os produtos TOTVS Agro Bioenergia e TOTVS Fluig.
Dentre as configurações complementares, demonstraremos:
- Indicação de scripts para serem executados em eventos do processo;
- Cadastro e configuração de formulários;
- Mecanismo de atribuição de usuários;
- Exportação do processo, formulário e scripts para a plataforma Fluig.
IMPORTANTE
No que diz respeito a montagem do diagrama, a sua composição, caminhos, pessoas envolvidas e outras configurações necessárias a respeito do fluxo de aprovação contratos de matéria-prima, cada cliente pode gerar o seu próprio processo.
Entretanto, os pontos que serão apresentados a seguir são OBRIGATÓRIOS para todos os processos de aprovação de contratos de matéria-prima, pois são etapas fundamentais na integração entre os produtos TOTVS Agro Bioenergia e TOTVS Fluig.
1) Indicação de scripts para serem executados em eventos do processo
Começaremos cadastrando os scripts que serão executados em eventos específicos do processo. Estes scripts permitem que sejam realizadas ações complementares, em situações específicas do fluxo de movimentação do processo.
No Fluig Studio, clicaremos sobre a pasta "scripts", com o botão direito do mouse, e selecionaremos a opção "New", e em seguida "Script Fluig", conforme exemplo abaixo:
A tela a seguir será apresentada, onde deverá ser escolhido a opção "Script Evento Workflow". Em seguida, clicar em "Next":
Nesta próxima tela indicaremos o nome do evento e relacionaremos ele ao diagrama criado anteriormente. Neste momento, escolheremos o evento "afterProcessFinish". Este evento será acionado assim que o processo for finalizado. Escolhendo os atributos indicados, clicaremos em "Finish".
Feito isso, será criado uma função do tipo do evento escolhido. Nesta função, devemos passar os comandos conforme o exemplo apresentado abaixo:
Este script será acionado após o processo ser finalizado no Fluig, acionando a API gerada pelo Bioenergia, referente a finalização da aprovação do contrato de matéria prima e oficialização do mesmo. Com isso, podemos constatar que a oficialização do contrato de matéria prima somente será realizada após a finalização do processo na plataforma Fluig.
Repetiremos os mesmos passos realizados anteriormente, criando um novo script, entretanto, referente ao evento "afterCancelProcess", que será acionado após o processo ser cancelado na plataforma Fluig. Após o processo ser cancelado, o Fluig consumirá mais uma API do TOTVS Agro Bioenergia, registrando o cancelamento do processo e disponibilizando ao usuário o envio do contrato para aprovação novamente, gerando um novo código de processo vinculado ao contrato de matéria prima.
Atenção
2) Cadastro e configuração de formulários
Após a criação do formulário base de aprovação de contratos de matéria-prima, precisaremos configurar a estrutura deste formulário. Para isso, inseriremos no arquivo .html que foi gerado, o bloco de código a seguir.
Atenção
3) Mecanismo de atribuição de usuários
Esta configuração consiste na definição do usuário (ou grupo de usuários) que dará sequência ao processo iniciado pelo TOTVS Bioenergia.
Os processos iniciados pelo Bioenergia via API, necessariamente precisam possuir na composição e configuração da primeira tarefa após o evento de início do processo, um mecanismo de atribuição configurado.
Sem este mecanismo de atribuição definido, o processo não será startado e a API retornará com um erro.
Para as demais tarefas, o uso deste recurso é opcional.
No Fluig Studio, com o processo aberto na tela principal, deve-se clicar na tarefa em que se deseja configurar um mecanismo de atribuição. Neste exemplo, configuraremos a tarefa "Aprova Contrato de Matéria Prima". Clicando sobre a caixa da tarefa, podemos visualizar algumas configurações desta tarefa na aba "Properties". Dentre as opções, temos o "Mec. Atribuição", responsável por indicar o mecanismo de atribuição escolhido. Nos é apresentado um combo box, com algumas opções de atribuições, e ao lado a opção "Configurar":
Neste exemplo, escolhemos o mecanismo de Atribuição "Por Usuário". Clicando em "Configurar", nos é apresentado todos os usuários cadastrados neste servidor Fluig. Clicando duas vezes sobre o nome escolhido, será indicado o usuário que estará atribuído como responsável por assumir esta tarefa, assim que o processo for iniciado pelo TOTVS Agro Bioenergia.
Atenção
4) Exportação do processo, formulário e scripts para a plataforma Fluig
Após realizada todas as configurações e ajustes necessários do processo de Aprovação de Contratos de Matéria-Prima, realizaremos a exportação deste processo e todos os seus demais itens envolvidos (formulário, scripts, etc) para o servidor Fluig onde a plataforma está disponibilizada.
Clicaremos com o botão direito do mouse sobre o processo escolhido para ser exportado, e selecionaremos a opção "Export":
Em seguida, selecionaremos a opção "Exportar para servidor Fluig":
Feito isso, confirmaremos o servidor escolhido para a exportação, além do processo selecionado. Caso esteja tudo correto, deve-se selecionar os checkboxes "Liberar Versão" (para realizar a liberação de uma nova versão do processo) e "Exportar formulário" (para que o formulário vinculado ao processo também seja exportado). Em seguida, clicaremos em "Next":
Por fim, confirmaremos as informações sobre a exportação do formulário. Com todas as informações indicadas corretamente, podemos clicar em "Finish":
Assim que a configuração da exportação do processo for finalizada, o processo estará registrado em uma nova versão e disponível para ser acionado pela API.