Índice

maxLevel	5
outline	true
exclude	.*ndice
style	none

Processo BPM Fluig de liberação de Período de contrato de Projeto

Neste documento estão detalhadas as seguintes informações do Processo BPM:

1) Objetivo

2) Benefícios

3) Ambiente de Negócio

4) Como Utilizar

5) Como Instalar

6) Considerações

...

Objetivo

Processo BPM de liberação Liberação de Medições em contrato Período de Projeto 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 projetoum determinado contrato em projetos.

Através deste processo o usuário realiza a aprovações de Medições e Liberações de períodos de contrato de um projeto do TOTVS Obras e Projetos.

...

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.

Image Added

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.

Image Added

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”.

O identificador do workflow é armazenado para permitir a consulta no Fluig e para realizar a liberação de processos. Esta informação pode ser visualizada no anexo "Fluxo de Aprovação Fluig" na visão de Contratos do TOTVS Obras e Projetos.

Quando o usuário acessar o processo de “Liberar Período” o sistema verifica se existe um Workflow criado para o período. Caso não exista, o sistema então irá criá-lo, senão o sistema irá verificar o status atual e irá exibí-lo ao usuário na tela do processo. Caso o status esteja diferente de APROVADO, o sistema irá desabilitar os campos de “Liberar TOTVS Obras e Projetos” e “Enviar para financeiro”. Caso esteja com status APROVADO, o sistema habilitará os campos antes citado e o usuário poderá liberar o período obedecendo também as regras atuais para a liberação.

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.

Image Added

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

...

Materias Materiais e Obras e Projetos.

3.3 Processo de Negócios:

Image Removed

Processo Fluig

Image Removed

Processo workflow

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

default	true
id	1
label	Processo Fluig

Image Added

Card

id	2
label	Processo de Negócio

Image Added

...

Atividades do Processo

Atividade: Início.

Descrição: Tarefa inicial do Workflow.

Instruções: Definir o início do Workflow.

Atividade: Verifica Tipo Contrato.

Descrição: Verifica se o contrato é à pagar ou à receber.

Instruções: Caso o workflow tenha sido gerado pelo TOTVS Obras e Projetos essa tarefa é feita automaticamente de acordo com o tipo de contrato. Esse dois fluxos foram elaborados assim para facilitar os clientes que desejam customizar o processo BPM fazendo com que, por exemplo, tenha mais algumas atividades de acordo com o tipo de contrato.

Atividade: Liberar Período de Contrato à Pagar.

Descrição: Análise para liberação do período de Contrato do tipo à pagar.Descrição: Análise

Instrução: Por meio dessa atividade você poderá aprovar, reprovar ou solicitar uma justificativa para contrato do tipo à pagar.

Atividade: Liberar Período de Contrato à Receber.

Descrição: Análise para liberação do período de Contrato do tipo à receber.

Instrução: Por meio dessa atividade você poderá aprovar, reprovar ou solicitar uma justificativa para contrato do tipo à receber.

Atividade: Solicitar justificativa.

...

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 processos
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
...
Image Removed
b) Defina os valores e execute o processo, conforme figura abaixo:

Image Removed
...
.
Image Added

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.
Image Added

Card
id 3
label Passo 3
Após abrir a tela preencha os dados da liberação e clique em "Executar".
Image Added

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
...
.

Image Added

Image Removed
...

Movimentando e Consultando Processo BPM pelo Fluig

a)

Deck of Cards

effectDuration	0.5
history	false
id	processosfluig
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 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 Removed

...

Image Added

Card

id	3
label	Passo 3

Será aberto o

...

formulário com

...

informações do

...

Contrato, Período e Medições, e as opções de “Solicitar Justificativa”, “Aprovar” e “Reprovar” o Workflow.

...

Abaixo o formulário com informações do Contrato, Período e Medição:
Image Added

Card

id	4
label	Passo 4

Para avançar o workflow clique no botão Enviar 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

Como Instalar

Fluig

Image Removed

d) Para Aprovar ou Reprovar 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

e) 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.

5. Como Instalar

5.1 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.c)

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

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.
Resouce	prj_cnt_liberar_pdo.processimage ServerBH.ws.cache	Arquivo de cache de acesso aos webservices do processo.

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.