Índice

maxLevel	5
outline	true
exclude	.*ndice
style	none

Objetivo

Processo BPM de Liberação de Período de Contrato é uma solução desenvolvida sobre a plataforma Fluig e integrada nativamente com ERP RM para o controle financeiro e aprovações de despesas e receitas de um determinado contrato em projetos.

Através deste processo o usuário realiza a aprovações de Liberações de Períodos de Contrato de um Projeto do TOTVS Obras e Projetos.

Definição da Regra de Negócios

Parâmetros Gerais

No Menu | Projeto | Agrupador Parâmetros | Construção e Projetos | Gerais, escolha a aba chamada “Fluig” nos parâmetros gerais do TOTVS Obras e Projetos. Escolha a aba inferior Liberação de Período para configurar o workflow.

Esta aba contém três parâmetros, sendo: um para definir o processo relativo ao workflow de Liberação de Período de Contrato, mais um para definir quais os estados do workflow que determinam que o mesmo esteja aprovado e um terceiro para definir quais os estados do workflow que determinam que o mesmo esteja reprovado.

Parâmetros de Projeto

Na aba “Integração FLUIG” em “Projeto | Agrupador Parâmetros | Construção e Projetos | Projeto", pasta "Integração | Integração Fluig” foram adicionados os seguintes parâmetros:

“Integração Fluig” que deve é inicializado desmarcado para um novo Projeto.
“Contrato a Pagar - Liberar Período” e “Contrato a Receber - Liberar Período” que são inicializados desmarcados e habilitados somente se o parâmetro “Integração Fluig” estiver marcado.
- Marque os parâmetros acima caso deseje trabalhar com aprovação via Workflow Fluig para os contratos do tipo à pagar e/ou à receber, respectivamente.

Workflow para Liberar Períodos de Contrato

Este tópico irá detalhar os processos e ações realizadas para o Workflow de Liberação de Períodos de Contrato no TOTVS Obras e Projetos. O tópico posterior irá mostrar os detalhes referentes ao Workflow no Fluig.

Processo de Liberar Período

Ao clicar em “Executar”, o sistema inicia o workflow para aprovação no Fluig. Devem ser considerados os parâmetros de projeto para o tipo de contrato (pagar ou receber). O workflow referente a este processo, é definido na aba "Fluig" dos parâmetros gerais do projeto em “Workflow Fluig”.

...

Caso o usuário modifique o valor a ser liberado o Workflow atual será cancelado e será gerado um novo Workflow para o período.

Cancelamento de Liberação

Com o projeto marcado para utilizar integração Fluig, quando realizar um cancelamento de liberação do período de contrato, o processo deverá cancelar o workflow caso exista e esteja pendente de aprovação.

Gerar integração com Suprimentos / Faturamento

Com o projeto marcado para utilizar integração Fluig ao executar este processo, o sistema valida a existência e situação do workflow de aprovação.
O sistema emite uma mensagem informando ao usuário que o processo não poderá ser executado, caso não exista um workflow APROVADO.

Anexo Fluxo de Aprovação Fluig - Liberar Período

Foi criado o anexo “Fluxo de Aprovação Fluig - Liberar Período” na visão de Contratos. Com o projeto marcado para utiliza integração Fluig este anexo exibe os workflows criados para cada período do contrato, além de verificar o status atual do workflow no servidor do Fluig.

Fluig

Processo BPM – Workflow de Liberação de Período de Contrato

Foi criado um processo baseado no padrão BPM (Business Process Management) referente ao workflow para aprovação da liberação de período de contrato. Neste processo são exibidas as informações referentes a medição ou consumo do período que está sendo liberado. O processo do Fluig permite solicitar justificativas durante o processo de aprovação.

Formulário Fluig

Para possibilitar a aprovação, será apresentado em um formulário ao usuário aprovador informações aos itens medidos, conforme descrito na tabela abaixo:

Informações para o formulário do Workflow de Liberação de Períodos de Contrato
Informação	Origem
Código do Projeto	Projeto
Descrição do Projeto	Projeto
Código Cliente/Fornecedor	Cliente/Fornecedor
Nome Cliente/Fornecedor	Cliente/Fornecedor
Contrato	Contrato
Tipo (a pagar ou a receber)	Contrato
Período	Período de Contrato
Data de Início	Período de Contrato
Data de Término	Período de Contrato
Valor Medido ou Consumido	Medição ou Consumo
Valor Retido	Liberação
Valor Liberado	Liberado
Data de Solicitação	Abertura WF
Responsável	Usuário da Abertura WF
Itens medidos ou objetos consumidos	Tarefas medidas ou insumos consumidos

Datasets Fluig

Foram criados dois Datasets Fluig: o primeiro para obter as informações do projeto, cliente/fornecedor, contrato, períodos e dados de medição. O segundo para obter as tarefas medidas ou insumos consumidos pelo período de contrato que deseja liberar.

Os Datasets utilizam o serviço de Consulta SQL, portanto foram elaboradas duas consultas SQL para que os Datasets possam consumí-las e extrair os dados necessários para exibi-los ao usuário no formulário Fluig.

A consulta SQL se encontra junto com os artefatos do Workflow de Liberação de Períodos de Contrato, dentro da pasta objetos gerenciais: <pasta de instalação do RM>\ObjetosGerenciais\Fluig\Workflow\Projetos.zip.

Benefícios

Os principais benefícios na utilização deste processo BPM são:

Rastreabilidade;
Governança;
Aprovação via mobile;
Melhora no gerenciamento e controle dos gastos e/ou receitas de contratos dos projetos.

Ambiente de Negócio

Segmento

Construção e Projeto.

Áreas de Negócios

Materiais e Obras e Projetos.

Processo workflow

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

card

default

true
id	1
label	Processo Fluig

Card

default	true
id	2
label	Processo de Negócio

Atividades do Processo

Atividade: Início.

Descrição: Tarefa inicial do Workflow.

...

Instrução: Aprovação e finalização do workflow.

Como Utilizar

Iniciando Processo BPM pelo RM

Deck of Cards

effectDuration	0.5
history	false
id	samplesprocessos
effectType	fade

Card

default	true
id	1
label	Passo 1

No Menu | Controle | Contratos | Anexo Períodos de Contratos. Escolha um período para liberação, e escolha o processo de Liberar Período, conforme figura abaixo.

Card

id	2
label	Passo 2

Caso tenha um workflow pendente de aprovação uma mensagem é exibida com o código do workflow, conforme figura abaixo.

Card

id	3
label	Passo 3

Após abrir a tela preencha os dados da liberação e clique em "Executar".

Card

id	4
label	Passo 4

Ao final do processo se não estiver um workflow aprovado para o período, o processo não será executado e uma mensagem informando que o workflow não está aprovado será exibida ao final do mesmo, conforme figura abaixo.

Movimentando e Consultando Processo BPM pelo Fluig

Deck of Cards

effectDuration	0.5
history	false
id	samplesprocessosfluig
effectType	fade

Card

default	true
id	1
label	Passo 1

Faça login no Fluig e clique no link Tarefas a concluir, conforme figura abaixo:

Image RemovedImage Added

Card

id	2
label	Passo 2

A página que irá se abrir irá mostrar todas as suas tarefas à concluir. Encontre na tabela de tarefas pelo Workflow “Liberar Períodos de Contrato” e dê um clique sobre ele, conforme figura abaixo:
Image RemovedImage Added

Card

id	3
label	Passo 3

Será aberto o Workflow formulário com os dados informações do Período de Contrato Contrato, Período e Medições, e as opções de “Solicitar Justificativa”, “Aprovar” e “Reprovar” o Workflow. Caso queira solicitar uma justificativa do para o Workflow no campo “Enviar para a atividade” escolha Solicitar Justificativa e insira alguma informação (opcional) no campo Justificativa e escolha para qual usuário você estará pedindo a Justificativa e em seguida clique no botão Salvar e logo depois em Enviar, conforme figura abaixo. Após enviar o Workflow o mesmo irá aparecer para o usuário escolhido informar a justificativa.Image Removed
Abaixo o formulário com informações do Contrato, Período e Medição:
Image Added

Card

id	4
label	Passo 4

Para Aprovar ou Reprovar avançar o workflow escolha no campo “Enviar para a atividade” sua opção e depois clique no botão Enviar . Veja abaixo na figura um exemplo de Aprovação do Workflow:
Image Removed

no canto superior direito da tela. Caso queira Salvar, Transferir ou Descartar clique na seta bem a direita do botão de Enviar, conforme figura abaixo:

Image Added

Card

id	5
label	Passo 5

Ao clicar no botão Enviar, caso tenha mais de uma atividade para o fluxo seguir, a tela abaixo é exibida. Selecione a próxima atividade que o Workflow irá assumir (para aprová-lo selecione a atividade final Aprovar) e escolha quais usuários serão responsáveis pela próxima atividade.

Image Added

Uma vez que o Workflow esteja Aprovado, já podemos fazer nossa Medição ou Liberação do Período de Contrato. Será gerado um Workflow por Período de Contrato.

Como Instalar

Fluig

Instalar o ambiente de Desenvolvimento Fluig

Para realizar a instalação do Processo BPM é preciso ter instalado o TDS (TOTVS Developer Studio) e o plugin do FLUIG para o mesmo. Para instalar o TDS e o plugin do FLUIG visite esta página que contém detalhes para tal: http://tdn.totvs.com/pages/releaseview.action?pageId=73078179.Guia de instalação fluig Studio.

Buscar os Arquivos para Instalação do Processo BPM

O nome do arquivo do projeto processo BPM Fluig de Medição/ Liberação de Períodos de Contratos é: RM.Prj.Contrato.LiberarPDO. rm_prj_liberar_pdo.zip. Estão na pasta de instalação dentro da pasta objetos gerenciais: <pasta de instalação do RM>\ObjetosGerenciais\Fluig\Workflow\Projetos.zip.

Abrir o Arquivo do Instalação do Processo BPM no TDS

No link estão as instruções de como fazer a abertura do arquivo do processo BPM dentro do TDS.

http://tdn.totvs.com/pages/releaseview.action;jsessionid=D2A6F7626B6B8CB061A77A89F9693875?pageId=128681226#ExpediçãodeProcessosdeWorkflowpeloFluigStudio-ExpediçãodeprocessodeworkflowpelopluginFluignoTDS.)

Importação e exportação de projeto no Fluig Studio

Componentes dos Processos BPM

Arquivo de cache de acesso aos webservices do processo

Processo BPM	Medição/Liberação de Períodos de Contratos
Tipo Arquivo	Nome do Arquivo	Descrição
Formulário	prj_cnt_pdo_form.html	Formulário com informações importantes do Contrato, Período e Medições para liberação do período.
Anexo Formulário Mobile	prj_cnt_pdo_form_ecmmobile.html	Formulário para aparelhos móveis.
Evento de Formulário	displayFields.js	Evento para carregar as informações do dataset para o fomulário.
Evento de Processo	prj_cnt_liberar_pdo.beforeStateEntry	Ao mudar de status o atividade no workflow esse evento irá verificar qual tipo de contrato (à pagar ou à receber) e define um fluxo para o mesmo e atualiza os dados do formulário.
Diagrama de Processo	prj_cnt_liberar_pdo.process	Diagrama de processo Fluig BPM para Liberação de Período de Contrato.
Dataset	dsPrjCntPdoFluig.js	Obtém informações do período a liberarcontrato, período e medições através do Dataserver PrjFluigLiberarPdoData para exibição no formulário.
Dataset	dsPrjCntPdoTrfFluig.js	Obtém informações das tarefas medidas do período.
Resouce	prj_cnt_liberar_pdo.ecm30	Arquivo XML com informações das atividades do processo Fluig.
Resouce	prj_cnt_liberar_pdo	Arquivo de imagem do diagrama do processo Fluig.
dos itens medidos através do Dataserver PrjFluigLiberarPdoData para exibição no formulário.
Dataset	dsPrjCntPdoFluigSQL.js	Obtém informações do contrato, período e medições através de uma Consulta SQL (MPDOFLUIG) para exibição no formulário.
Dataset	dsPrjCntPdoObjFluigSQL.js	Obtém informações dos objetos consumidos através de uma Consulta SQL (MOBJPDOFLUIG) para exibição no formulário.
Dataset	dsPrjCntPdoTrfFluigSQL.js	Obtém informações dos itens medidos através de uma Consulta SQL (MTRFPDOFLUIG) para exibição no formulário.
Consulta SQL	ConsultasFluigPrjCntPdo.TotvsSQL	Consultas SQL que retornam as informações para os datasets. Deverão ser importadas para o RM. O arquivo possui três consultas SQL: MPDOFLUIG - Informações do Contrato, Período e Medições MOBJPDOFLUIG - Informações dos objetos consumidos para o período MTRFPDOFLUIG - Informações dos itens medidos para o período	Resouce	prj_cnt_liberar_pdo.processimage ServerBH.ws.cache	.