Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Esta aba contém três parâmetros, sendo: um para definir o processo relativo ao workflow de Aprovação de Pedido de Material Extra, 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. Tanto os estados finais de aprovação total quanto o de aprovação item a item devem ser selecionados na respectiva lista.

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” foi adicionado um parâmetro para utilizar workflow Fluig para Aprovação de Pedido de Material Extra para o Projeto:

...

Além das visualizações o Fluig segue o fluxo de operação do workflow de aprovação de pedido de material extra, existindo dois estados finais Finalizado e Reprovadoos estados "Aprovar todos os itens", "Reprovar todos os itens" e "Aprovação com análise Item a Item".

Aprovação total do pedido

Como no TOP a aprovação total do pedido reflete a definição de 100% da quantidade aprovada dos itens do pedido. No caso do workflow de aprovação de pedido de material extra essa irá acontecer quando o usuário Fluig selecionar prosseguir o workflow para o estado final de "Aprovar ", todos os Itens" ou para o estado "Aprovação com análise Item a Item" com todos os itens da listagem do formulário com suas quantidades aprovadas em 100% da quantidade pedida, essa avaliação é feita no momento que o workflow estiver mudando para o estado aprovado.

Caso seja zerada a quantidade aprovada de todos os itens, ou seja, 0% da quantidade pedida, e o workflow prosseguir ao estado Aprovado, automaticamente o mesmo irá atribuir ao workflow o estado Reprovado, já que este é o real estado refletido pelas quantidades aprovadas dos itens. O usuário é informado de tal ação.

Reprovação total do pedido

.

Reprovação total do pedido

Semelhante à aprovação, a reprovação do pedido se comporta conforme as regras já existentes no TOP, sendo assim ele irá atribuir a todos os itens do pedido o percentual associado de 0% e o status de reprovado. No workflow de aprovação de pedido de material extra esse comportamento será representado pelo estado "Reprovar todos os Itens" que na prática irá realizar o mesmo procedimento, porém atribuindo o percentual da quantidade associada de 0% da quantidade pedida.

Caso seja zerada a quantidade aprovada de todos os itens, ou seja, 0% da quantidade pedida, e o workflow prosseguir ao estado  "Aprovação com análise Item a Item", automaticamente o mesmo estará Reprovado no TOP, uma vez que este é o real estado refletido pelas quantidades aprovadas dos itens. Semelhante a Aprovação, a Reprovação do pedido se comporta conforme as regras já existentes no TOP, sendo assim ele irá atribuir a todos os itens do pedido o percentual associado de 0% e o status de reprovado. No workflow de aprovação de pedido de material extra esse comportamento será representado pelo estado "Reprovar" que na prática irá realizar o mesmo procedimento que o estado  "Aprovar", porém atribuindo o percentual da quantidade associada de 0% da quantidade pedida.

Aprovação parcial do pedido e Aprovação parcial dos itens

A Aprovação aprovação parcial de um pedido é a situação em que nem todos os itens do mesmo são aprovados integralmente (100% da quantidade solicitada) ou então podendo ter alguns itens reprovados e outros aprovados (integral ou parcialmente). Resumidamente a aprovação parcial de um item é o processo já descrito, no qual o item pode não ter sua quantidade aprovada integralmente (menos de 100% da quantidade solicitada). No workflow de aprovação de pedido de material extra esse comportamento é representado pelo estado "AprovarAprovação com análise Item a Item" que na prática irá finalizar o pedido e irá encaminhar ao TOP os itens do pedido no estado que o aprovador os deixou. Para manter o comportamento já existente no TOP, ao visualizar o workflow de aprovação de pedido de material extra existe uma aba que irá exibir os dados dos itens, e nesta aba é possível atribuir a quantidade aprovada a um item. Existe também nesta a opção de aplicar um percentual de aprovação em sobre a quantidade pedida, bastando apenas informar esse percentual e selecionar quais itens deseja que seja aplicado o percentualpressionar 'Enter' ou o botão ao lado da caixa de texto.

Na prática a informação que irá dizer se um item e subsequentemente um pedido está aprovado é a quantidade aprovada dos itens. Se todos os itens estiverem com a quantidade aprovada no valor de 100% da quantidade solicitada, irá indicar que todos os itens estão com o estado aprovado e o pedido também, bem como o valor da quantidade aprovada em 0% da quantidade solicitada presente em todos os itens do pedido irá indicar que aqueles itens estão todos reprovados e por consequência o pedido. Qualquer percentual de quantidade aprovada em um ou mais itens fora dos descritos acima indicará que o pedido está aprovado parcialmente.

...

Continuando nesta linha de raciocínio a aprovação ou reprovação de um item será feita com a seleção do mesmo na caixa poderá ser feita através dos seguintes métodos:

  • Utilização dos botões de aprovação ou reprovação ao lado do seu nome.
  • Utilização da funcionalidade de aplicação de percentual, onde 100% é o mesmo que aprovar todos, 0% reprovar todos e qualquer número entre estes significa aprovação parcial.
  • Preenchimento da caixa de texto de quantidade aprovada, seguindo a mesma regra de percentual relativo à quantidade solicitada.

Nenhum outro campo a não ser a quantidade aprovada estará disponível para edição, conforme o passo-a-passo a seguir, ao selecionar a caixa a quantidade aprovada será registrada em 100% da quantidade pedida. O mesmo ocorrerá ao desmarcar a caixa, porém, esse processo irá reprovar o item atribuindo ao mesmo na quantidade aprovada 0% da quantidade pedida. A qualquer momento o usuário poderá inserir na caixa de texto da quantidade aprovada um valor indo de 0,00...1 a 99,99...9% da quantidade pedida, esse comportamento irá atribuir ao item o status de aprovado parcialmente.

Nenhum outro campo a não ser a quantidade aprovada estará disponível para edição. A qualquer momento o usuário poderá salvar o formulário, usando-se do botão presente no workflow para tal ação.

Regras de Integridade

Para o Workflow de aprovação de pedido material extra é necessário observar algumas regras e algumas validações. A principio um fato básico é a não existência de dois fluxos na aprovação do pedido, ou seja, a aprovação ser realizada via Fluig e via TOP, para não permitir tal situação alguns processos foram desabilitados ao se optar por utilizar a aprovação via Fluig. São eles:

  • Finalizar Aprovação de pedido de material extra;
  • Aprovar Pedido Extra;
  • Reprovar Pedido Extra;

Além dos processo desabilitados alguns processos sofreram alterações no seus fluxo normal de execução. O processo de "Retornar para criação" irá executar sua funcionalidade normalmente, mas como adicional ao seu fluxo de execução quando utilizada a aprovação via Fluig o processo irá cancelar qualquer workflow que esteja em aberto para aquele pedido. Assim não se corre o risco de abrir dois workflows para o mesmo pedido com informações diferentes. O processo de "Enviar pedido extra para aprovação" por outro lado sofreu mais alterações, ele é o responsável por elaborar o workflow e enviá-lo ao Fluig. Sua execução internamente no TOP continua inalterada, mas com o adicional de gerar o workflow para o Fluig.

Outra validação que é a não existência de dois workflows para um mesmo pedido de material ao mesmo tempo. Sendo que toda vez que de alguma forma for solicitado a elaboração de um novo workflow essa regra será validada.

salvar o formulário, usando-se do botão presente no workflow para tal ação.

Regras de Integridade

Para o Workflow de aprovação de pedido material extra é necessário observar algumas regras e algumas validações. A principio um fato básico é a não existência de dois fluxos na aprovação do pedido, ou seja, a aprovação ser realizada via Fluig e via TOP, para não permitir tal situação alguns processos foram desabilitados ao se optar por utilizar a aprovação via Fluig. São eles:

  • Finalizar Aprovação de pedido de material extra;
  • Aprovar Pedido Extra;
  • Reprovar Pedido Extra;

Além dos processo desabilitados alguns processos sofreram alterações no seus fluxo normal de execução. O processo de "Retornar para criação" irá executar sua funcionalidade normalmente, mas como adicional ao seu fluxo de execução quando utilizada a aprovação via Fluig o processo irá cancelar qualquer workflow que esteja em aberto para aquele pedido. Assim não se corre o risco de abrir dois workflows para o mesmo pedido com informações diferentes. O processo de "Enviar pedido extra para aprovação" por outro lado sofreu mais alterações, ele é o responsável por elaborar o workflow e enviá-lo ao Fluig. Sua execução internamente no TOP continua inalterada, mas com o adicional de gerar o workflow para o Fluig.

Outra validação que é a não existência de dois workflows para um mesmo pedido de material ao mesmo tempo. Sendo que toda vez que de alguma forma for solicitado a elaboração de um novo workflow essa regra será validada.

Ao optar por executar a aprovação de pedidos de material Ao optar por executar a aprovação de pedidos de material extra via Fluig, o processo de aprovação só será concluído quando não houver nenhum erro ou exceção. Ao chegar a qualquer estado final no workflow, o Fluig agrupa os dados e chama um processo no TOP passando como informação os dados colhidos da tela. Se por ventura durante a finalização da aprovação do pedido de material extra no TOP ocorrer erros ou exceções o procedimento será abortado. O TOP irá tentar buscar os dados da aprovação consultando o servidor Fluig. Nenhum novo workflow será gerado e o pedido já em estado final não poderá gerar novo workflow.

...

Materiais e Obras e Projetos.

Processo workflow

...


Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelProcesso Fluig

 

Image Removed

Card
id2
labelProcesso de Negócio

Image Removed

Atividades do Processo

 

Atividade: Início.

Descrição: Tarefa inicial do Workflow.

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

 

Atividade: Aprovar Pedido de Material Extra.

Descrição: Aprovar Pedido de Material Extra. 

Instrução: Verificar o pedido e itens do pedido de material extra para realizar a aprovação ou reprovação.

 

Atividade: Solicitar justificativa.


Image Added

Card
id2
labelProcesso 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: Aprovar Pedido de Material Extra.

Descrição: Aprovar Pedido de Material Extra. 

Instrução: Verificar o pedido e itens do pedido de material extra para realizar a aprovação ou reprovação.


Atividade: Solicitar justificativa.

Descrição: Inserção da justificativa para liberação do Pedido de Material Extra.

Instrução: Por meio dessa atividade você insere o porque ou dados adicionais para liberar o Pedido de Material Extra.


Atividade: Aprovar todos os Itens.

Descrição: Executa a finalização da aprovação do Pedido de Material Extra no RM.

Instrução: Este estado executa a integração com o RM para finalização da aprovação com análise item a item.


Atividade: Fluxo de Erro (Aprovar todos os Itens).

Descrição: Fluxo de erro do estado "Aprovar todos os Itens".

Instrução: Este fluxo é executado caso haja erro na integração com o RM para finalização da aprovação, retornando para o status "Aprovar Pedido de Material Extra".


Atividade: Aprovação com análise Item a Item.

Descrição: Executa a finalização da aprovação do Pedido de Material Extra no RM.

Instrução: Este estado executa a integração com o RM para finalização da aprovação com análise item a item.


Atividade: Fluxo de Erro (Finalizar).

Descrição: Fluxo de erro do estado "Aprovação com análise Item a Item".

Instrução: Este fluxo é executado caso haja erro na integração com o RM para finalização da aprovação, retornando para o status "Aprovar Pedido de Material Extra".


Atividade: Reprovar todos os Itens.

Descrição: Executa a reprovação do Pedido de Material Extra no RM.

Instrução: Este estado executa a integração com o RM para reprovação do pedido.


Atividade: Fluxo de Erro (Reprovar).

Descrição: Fluxo de erro do estado "Reprovar todos os Itens".

Instrução: Este fluxo é executado caso haja erro na integração com o RM para reprovação do pedido, retornando para o status "Aprovar Pedido de Material Extra".


Atividade: Aprovado (Final)

Descrição: Aprova a Descrição: Inserção da justificativa para liberação do Pedido de Material Extra.

Instrução:Por meio dessa atividade você insere o porque ou dados adicionais para liberar o Pedido de Material Extra.

 

 Aprovação do workflow


Atividade: Aprovado Item a Item (Final)Atividade: Reprovar.

Descrição: Reprova o Estado final do Pedido de Material Extra no fluxo de aprovação item a item.

Instrução: Reprovação e finalização Aprovação do workflow com análise item a item. 


Atividade:Aprovar. Reprovado (Final)

Descrição: Aprova Reprova a liberação do Pedido de Material Extra.

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

Como Utilizar

Iniciando Processo BPM pelo RM

...


Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelPasso 1
  • Após configurar e escolher um projeto acesse o Menu | Planejamento | Agrupador Básico | Geração de Pedido Extra.
  • Inclua um novo Pedido de Material Extra, conforme figura abaixo.

Card
id2
labelPasso 2
  • Após criar o pedido adicione os itens. Acesse o Anexo "Item de Pedido de Material Extra".

Card
id3
labelPasso 3
  •  Após criar o pedido e ter adicionado os itens chegou o momento de enviar o pedido para aprovação. Acesse o Processo "Enviar Pedido Extra para Aprovação".
  • Ao final do processo será exibido uma mensagem com os códigos dos workflows gerados para cada pedido, pois esse processe permite selecionar mais de um pedido.


 


Card
id4
labelPasso 4
  •  Após o workflow ser movimentado para algum estado final (Aprovado ou Reprovado) o pedido de material extra é automaticamente finalizado.
    • No exemplo abaixo foi realizado uma aprovação parcial dos itens. Um item foi aprovado, outro teve sua quantidade diminuída (aprovado parcialmente) e o outro foi reprovado.

...

Movimentando e Consultando Processo BPM pelo Fluig 


Deck of Cards
effectDuration0.5
historyfalse
idsamples
effectTypefade
Card
defaulttrue
id1
labelPasso 1
  • Faça login no Fluig e clique no link Tarefas a concluir, conforme figura abaixo: 


 


Card
id2
labelPasso 2
  • A página seguinte irá mostrar todas as suas tarefas à concluir. Encontre na tabela de tarefas o Workflow “Aprovação de Pedido de Material Extra” e dê um clique sobre ele, conforme figura abaixo:


 


Card
id3
labelPasso 3
  • Será aberto o formulário com informações do Projeto e as opções de “Solicitar Justificativa”, “Aprovar” e “Reprovar” o Workflow.

  • Abaixo o formulário com informações do Pedido de Material Extra.

Image Removed
  • Image Added

  • Abaixo o formulário com informações dos Itens do Pedido de Material Extra.
Image Removed

Image Added



Card
id4
labelPasso 4
  • É no formulário de Itens do Pedido de Material Extra que a aprovação é realizada.
    • No exemplo abaixo foi realizado uma aprovação parcial do pedido, pois o item 06.11 - Lavagem do Veículo teve a sua quantidade diminuída e por isso o Status Parcialmente. Já o item 12.02 - Tampas acrílicas 2/3 Brancas foi reprovado. E por fim apenas o item 18.01 - Luvas foi aprovado por completonem todos os itens foram completamente aprovados, tendo a seguinte aprovação:
      • O item "01.02 - CD Não Regravável 5 1/4" foi completamente aprovado (Quantidade pedida = Quantidade Aprovada).
      • O item "01.04 - CD Nashua" foi reprovado (Quantidade pedida < Quantidade Aprovada).
      • O item "23.17 - Comissão das Vendas/Aluguéis" foi reprovado (Quantidade pedida = 0).
    • Mais informações sobre como realizar as aprovações neste formulário, veja o capítulo Workflow para Aprovação de Pedido de Material Extra deste documento.

Image Removed

...

Image Added


Como Instalar

Fluig

Instalar o ambiente de Desenvolvimento Fluig 

...

Componentes dos Processos BPM

Processo BPM

 Pedido de Material Extra

Tipo Arquivo

Nome do Arquivo

Descrição

Formulário

 prj_aprovacao_pedido_material_extra.html

Formulário com informações importantes para aprovação do pedido de material extra.

Evento de FormuláriodisplayFields.jsEvento para carregar as informações do dataset para o fomulário.
Diagrama de Processoprj_aprovacao_pedido_material_extra.processDiagrama de processo BPM para Aprovação de Pedido de Material Extra.

Evento de Processo

prj_aprovacao_pedido_material_extra.afterStateEntry.js

Evento chamado após o envio do workflow para um estado final. Este evento faz uma chamada ao processo PrjFluigAprovarPedidoExtraProc para finalizar o pedido de material extra no TOP com as informações do fomulário Fluig.

JavaScriptprj_aprovacao_pedido_material_extra.jsArquivo responsável por manipular e validar o formulário de pedido e itens do pedido.

Dataset

dsDadosPedidoExtra.js

Obtém informações do Pedido de Material Extra na base do TOP.

Dataset

dsDadosItemPedioExtra.js

Obtém informações dos Itens do Pedido de Material Extra na base do

TOP.Consulta SQLPedidoExtra-WfFluig.TotvsSQLArquivo para ser importado no TOP contendo duas consultas SQL. Uma para buscar informações do Pedido de Material Extra e outra para buscar informações dos Itens do Pedido.

...

TOP.

Consulta SQLPedidoExtra-WfFluig.TotvsSQLArquivo para ser importado no TOP contendo duas consultas SQL. Uma para buscar informações do Pedido de Material Extra e outra para buscar informações dos Itens do Pedido.

Serviço SOAP

wsConsultaSQLServiço para executar consultas SQL no TCOP. Exemplo: https://servidor:8051/wsConsultaSQL/MEX?wsdl
Serviço SOAPwsProcessServiço para executar processos no TCOP. Exemplo: https://servidor:8051/wsProcess/MEX?wsdl
Serviço SOAPwsDataServerServiço para executar dataServer no TCOP. Exemplo: https://servidor:8051/wsDataServer/MEX?wsdl


Envio do Processo BPM para o Fluig

...

Acesse Menu | Projeto| Agrupador Parâmetros | Globais, aba Integração Fluig, informe os dados do endereço do servidor Fluig, usuário, senha e identificador da empresa.

 


Configurar nos parâmetros Gerais do TOTVS Obras e Projetos

Em Menu | Construção de Projetos | Agrupador Parâmetros | Gerais, aba Fluig, pasta Pedido Extra e escolha qual Processo BPM será utilizado para Aprovação de Pedido de Material Extra bem como os seus estados que serão considerados aprovados e os estados que serão considerados reprovados.

 


Escolher o projeto e configurar nos parâmetros de Projetos se o projeto em questão irá utilizar a integração com o Fluig

Acesse  o Menu -> Projeto | Agrupador Parâmetros | Construção e Projetos | Projetos. Na tela que irá se abrir vá no pasta Integração | Integração Fluig. Escolha se deseja utilizar workflows para Aprovação de Pedido de Material Extra.

Mobilidade

Formulário para Smartphone

Image Added

Formulário para Tablet

Image AddedImage AddedImage AddedImage Added

Considerações 

...

Para mais informações sobre a integração Fluig x RM consulte: Fluig Framework.