Histórico da Página
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 que serão realizadas no ambiente do Bioenergiaespecíficas, fechando o ciclo de integração entre os produtos.
...
| Dica |
|---|
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: |
...
| Nota | ||
|---|---|---|
| ||
Atente-se ao código atribuído para o processo e também sua descrição. Estas informações serão importantes no cadastro deste para o momento de cadastrar este processo no Bioenergia.
|
| Aviso | ||
|---|---|---|
| ||
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.
...
- 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.
| Nota | ||
|---|---|---|
| ||
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 que realizamos o cadastro e configuração inicial. 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á realizado realizada após a finalização do processo criado pelo usuáriona 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.
...
| Aviso | ||
|---|---|---|
| ||
| As rotinas demonstradas acima devem ser cadastradas da mesma forma que está estão sendo apresentada nos blocos de códigos, alterando somente os campos que possuem comentários a sua frente. |
...
| Dica |
|---|
| Para o cadastro de um novo formulário, recomendamos que seja realizada a leitura da documentação disponibilizada neste link. |
| Nota |
|---|
| Recomendamos que, antes de finalizar a exportação dos formulários para a plataforma Fluig, que os passos seguidos na página 1.1.3.1. Criação e Configuração de Pasta para Centralizar Formulários sejam realizados, para uma melhor organização dos documentos que serão gerados, a partir do uso dos processos. |
Após a criação do processo 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.
...
| Aviso | ||
|---|---|---|
| ||
| É de suma importância que a estrutura do formulário esteja configurada conforme o bloco de códigos acima, pois estes os IDs dos campos do formulário serão enviados juntamente com os valores aos quais eles representam, na requisição da API de start do processo, disponibilizada pelo Fluig. |
...
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 Fluig, pelo Bioenergia, 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.
...
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 a 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":
...
| Nota |
|---|
| Lembre-se sempre de salvar todas as alterações. |
| Aviso | ||
|---|---|---|
| ||
| Para a integração entre os produtos TOTVS Agro Bioenergia e TOTVS Fluig, todos os processos acionados via API Fluig, a PRIMEIRA TAREFA do processo (tarefa apresentada após o início do processo - circulo verde) OBRIGATÓRIAMENTE OBRIGATORIAMENTE precisa possuir um mecanismo de atribuição configurado. Sem este mecanismo de atribuição configurado para a primeira tarefa do processo, a API apresentará erro, pois ela aguarda a indicação de quem receberá a movimentação do processo. |
...
Após realizada todas as configurações e ajustes necessários no Fluig Studio, para a configuração 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.
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas