Í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

1.Descrição

O Fluig BPM é a oferta para controle de processos ideal para todas as empresas. O Workflow de liberação de medições em Contrato de projeto é uma solução segura e ágil, oportuna para o controle de aprovações de despesas e receitas de projetoum determinado contrato em projetos.

Através deste processo o usuário Este workflow realiza a aprovação aprovações de Medições e Liberações de períodos Períodos de contrato Contrato de um projeto Projeto do TOTVS Obras e Projetos. Com isso permite um melhor gerenciamento e controle dos gastos e/ou receitas de contratos dos projetos.

2.Segmento envolvido:

Construção e Projetos.

3. Áreas de negócios envolvidas:

...

4. Documentos de Instalação

Para realizar a instalação do Workflow é 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.

Uma vez instalado agora é hora de importar o Workflow para o TDS para manipularmos e posteriormente importá-lo para o servidor Fluig do cliente. Para importar o Workflow siga os passos explicados nesta página: http://tdn.totvs.com/pages/releaseview.action;jsessionid=D2A6F7626B6B8CB061A77A89F9693875?pageId=128681226#ExpediçãodeProcessosdeWorkflowpeloFluigStudio-ExpediçãodeprocessodeworkflowpelopluginFluignoTDS.

Caso deseje criar um novo Workflow a página seguinte detalha a criação e importação para o servidor Fluig do novo Workflow: http://tdn.totvs.com/pages/releaseview.action?pageId=73894420#GuiaRápidoFluig-Workflow.

O nome do projeto Fluig do Workflow de Medição/Liberação de Períodos de Contratos é "RM.Prj.Contrato.LiberarPDO".

Datasets:

dsPrjCntPdoFluig

dsPrjPdoFluig

prj_cnt_pdo

Workflow:

.resources

-prj_cnt_liberar_pdo.ecm30

-prj_cnt_liberar_pdo

-prj_cnt_liberar_pdo.processimage ServerBH.ws.cache

diagrams

prj_cnt_liberar_pdo.process

scripts

prj_cnt_liberar_pdo.afterTaskCreate prj_cnt_liberar_pdo.beforeStateEntry

5.Fluxo do Processo

Image Removed

6.Configuração para utilização do Workflow Fluig de Medição/Liberação de Períodos de Contratos

Vide um exemplo na figura abaixo:

Image Removed

6.2 Agora configurar nos parâmetros Gerais do TOTVS Obras e Projetos (Menu -> Construção de Projetos -> Gerais, aba Integração, box Workflow FLUIG) qual Workflow será utilizado para Medição/Liberação e qual será o seu Estado de aprovação.

Vide exemplo na figura abaixo:

Image Removed

6.3 Logo após é hora de escolher o projeto e configurar nos parâmetros de Projetos se o projeto em questão irá utilizar a integração com o Fluig. Para isso vá no Menu -> Construção e Prejetos -> Projetos. Na tela que irá se abrir vá no item Integração -> Integração CRM -> Integração FLUIG. Ao entrar escolhe quais tipos de contrato receberão a integração Fluig, a pagar, a receber ou ambos.

Veja um exemplo na figura abaixo:

Image Removed

7.Utilizando o Workflow no 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

Materiais e Obras e Projetos.

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.

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.

Descrição: Inserção da justificativa para liberação do período do Contrato.

Instrução: Por meio dessa atividade você insere o porque ou dados adicionais para liberar o período.

Atividade: Reprovar.

Descrição: Reprova a liberação do período.

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

Atividade: Aprovar.

Descrição: Aprova a liberação do período.

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

...

Image Removed

...

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

8.Visualização e aprovação/reprovação do Workflow no Fluig

...

Movimentando e Consultando Processo BPM pelo Fluig

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 Added

Image Removed

...

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

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: 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 Liberação de Períodos de Contratos é: 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. 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 do Contrato, Período e Medições para liberação do período.
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 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 BPM para Liberação de Período de Contrato.
Dataset	dsPrjCntPdoFluig.js	Obtém informações do contrato, período e medições através do Dataserver PrjFluigLiberarPdoData para exibição no formulário.
Dataset	dsPrjCntPdoTrfFluig.js	Obtém informações 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.

Envio do Processo BPM para o Fluig

Uma vez instalado TDS deve de importar o Processo BPM para o TDS para manipularmos e posteriormente importá-lo para o servidor Fluig do cliente. Para importar o Workflow siga os passos explicados nesta página: Importação e exportação de projeto no Fluig Studio .