Integracao Fluig Protheus

Integrao Fluig
x
Linha do Produto Microsiga Protheus
Integrao
Ttulo do documento
fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil
Sumrio
1.
Introduo ........................................................................................... 3
1.1.
Objetivos do Treinamento .................................................................. 3
1.2.
Aviso ..................................................................................................... 3
2.
Sincronizao de Usurios ................................................................. 4
3.
Configurao e Utilizao do Servio Linha do Produto Microsiga

Protheus no Fluig ............................................................................... 10
4.
Processo Integrado - Fluig ............................................................... 14
5.
Processo Integrado - Linha do Produto Microsiga Protheus......... 19
6.
Processo Integrado Execuo ........................................................ 23
7.
Concluso ......................................................................................... 34
1. Introduo
Ol!
Seja bem-vindo ao treinamento Integrao Fluig x Linha do Produto
Microsiga Protheus do curso Integrao do Fluig.
1.1. Objetivos do Treinamento

Ao trmino deste treinamento voc ter conhecido mais sobre:
Sincronizao de Usurios.
Configurao do Servio Linha Microsiga Protheus no Fluig.
Utilizao do Servio Linha Microsiga Protheus no Fluig.
Processo Integrado Fluig.
Processo Integrado Linha Microsiga Protheus.
Processo Integrado Execuo.
1.2. Aviso
O Fluig foi desenvolvido para integrar-se a diversos sistemas, permitindo
assim que os processos modelados possuam maior valor agregado.
possvel consultar e alimentar informaes no Fluig atravs de um sistema
externo, bem como facilitar que outros sistemas conectem-se para consultar
informaes ou para execuo de operaes transacionais.
Para realizar a integrao entre Fluig e Linha do Produto Microsiga
Protheus necessrio que os usurios dos dois sistemas estejam
sincronizados, e a integrao realizada atravs da utilizao de Web
Services disponibilizados pelos sistemas.
2. Sincronizao de Usurios
Para o correto funcionamento das integraes entre o Fluig e a Linha do
Produto Microsiga Protheus, os usurios dos dois sistemas devem estar
sincronizados.
Na Linha Microsiga Protheus existe um recurso para a configurao inicial
dos parmetros de integrao e para a exportao dos usurios que esto
cadastrados no ERP para o Fluig.
importante lembrar que, caso um usurio cadastrado na Linha Microsiga
Protheus desejar executar um processo que se comunique com o Fluig, ele
deve estar cadastrado no Fluig com o mesmo login e senha da Linha
Microsiga Protheus.
A seguir, veja o passo a passo para sincronizar usurios da Linha do Produto
Microsiga Protheus no Fluig,
Passo 1
Para sincronizar os usurios da Linha do Produto Microsiga Protheus com o
Fluig, acesse o ambiente Configurador da Linha do Produto Microsiga
Protheus, e no menu clique na opo: Ambiente -> Totvs Ecm -> Wizard
do Wf.
O assistente de configurao ser aberto.
Clique em Avanar para prosseguir com a configurao.
Passo 2
Nesta tela, preencha os parmetros para comunicao com o servidor do

Fluig.
Informe o endereo dos WebServices, os dados para autenticao e a
empresa do Fluig.
Clique em Avanar.
Passo 3
Caso ocorra algum erro de comunicao com o Fluig, uma mensagem de
erro ser exibida e o assistente continuar na mesma tela.
Neste caso, revise os parmetros informados e clique novamente em

Avanar.
Passo 4
Caso a comunicao com o Fluig seja realizada com sucesso, exibida uma
tela onde necessrio selecionar os grupos de usurios da Linha do Produto
Microsiga Protheus que sero transferidos para o Fluig.
Selecione os grupos de usurios desejados e clique em Avanar.
Passo 5
A seguir, so exibidos todos os usurios presentes nos grupos de usurios
que foram selecionados anteriormente e que ainda no constam no Fluig.
Selecione os usurios desejados para sincronizar e clique em Avanar.
Passo 6
possvel migrar os grupos de usurios da Linha do Produto Microsiga
Protheus para o Fluig e tambm associar a um dos grupos j cadastrados no
Fluig os usurios que sero cadastrados.
Caso necessrio migrar os grupos de usurios, selecione Sim para a opo
Migrar os grupos do Microsiga Protheus e selecione o grupo do Fluig para
associar aos usurios que sero transferidos.
Em seguida, clique em Avanar.
Passo 7
Caso desejado, possvel associar um Papel cadastrado no Fluig aos
usurios da Linha do Produto Microsiga Protheus que sero transferidos
para o Fluig.
Para isso, selecione um Papel e em seguida clique em Finalizar.
Passo 8
Aps finalizar o processo na Linha Microsiga Protheus, acesse o cadastro de
Usurios do Fluig.
Verifique que os usurios da Linha do Produto Microsiga Protheus sero
exibidos.
3. Configurao e Utilizao do Servio Linha do

Produto Microsiga Protheus no Fluig
A seguir, veja o passo a passo para configurar e utilizar o Servio Linha
Microsiga Protheus no Fluig.
Configurao
possvel realizar integraes entre a Linha do Produto Microsiga Protheus
e o Fluig utilizando WebServices disponibilizados pela Linha Microsiga
Protheus.
A Linha do Produto Microsiga Protheus disponibiliza uma pgina web onde
possvel consultar todos os WebServices disponveis, alm de obter seus
endereos para cadastro no Fluig.
O cadastro dos servios disponibilizados pela Linha Microsiga Protheus

realizado no Studio, atravs da viso Visualizao de Servios.
10
Para mais detalhes de como cadastrar servios no Fluig, verifique o

treinamento Studio IV.
Utilizao
Os servios da Linha do Produto Microsiga Protheus adicionados ao Fluig
podem ser instanciados e utilizados em qualquer ponto onde o Fluig permite
customizao, como em scripts para eventos globais, eventos de processos,
eventos de formulrio ou datasets.
11
O procedimento para utilizao dos servios sempre o mesmo,

independente em qual ponto est sendo utilizado.
Para facilitar o entendimento do uso dos servios da Linha do Produto
Microsiga Protheus no Fluig, veja a seguir o exemplo de utilizao via
Dataset.
Observe na imagem um exemplo de implementao de como utilizar um

servio da Linha do Produto Microsiga Protheus na criao de um Dataset.
Para mais detalhes de como criar Datasets customizados e utilizar servios
no Fluig, assista ao treinamento Studio IV.
Na imagem apresentado o resultado da consulta do Dataset atravs do
Studio.
12
Este Dataset poder ser utilizado em qualquer customizao do Fluig, como

por exemplo, em um Zoom de formulrio.
13
4. Processo Integrado - Fluig

Aps realizar a sincronizao de usurios e a configurao do servio da
Linha do Produto Microsiga Protheus no Fluig possvel criar um processo
integrado.
Um processo integrado um processo do Fluig que possui integraes com
outros sistemas, ou seja, o processo ir utilizar e fornecer informaes para
os outros sistemas.
Como exemplo, ser apresentado um processo de solicitao de compras
onde:
1. Uma solicitao de compras adicionada na Linha Microsiga Protheus.
2. O processo de aprovao da solicitao iniciado no Fluig.
3. Aps a deciso tomada no processo, altera o status de aprovao da
solicitao de compras na Linha do Produto Microsiga Protheus.
Lembre-se que este exemplo apresenta um processo simplificado, que
possui como objetivo principal demonstrar como realizar uma integrao
entre o Fluig e a Linha Microsiga Protheus.
A seguir, ao clicar nas setas acima ou na sequncia de nmeros abaixo, veja
o passo a passo para criar um processo com integrao entre a Linha do
Produto Microsiga Protheus e o Fluig,
Passo 1
Para criar um processo que possui integrao entre a Linha do Produto
Microsiga Protheus e o Fluig, primeiramente necessrio realizar a
modelagem do processo, e em seguida, configurar as atividades do processo.
14
A imagem apresenta o diagrama do processo integrado MATA110,

demonstrando suas atividades e fluxos.
Modele o processo conforme visto na imagem e configure suas atividades:
Para a atividade Incio:
- No possuir mecanismo de atribuio definido
Para a atividade Aprovar Solicitao:
-Possuir dois fluxos de sada:
Aprovar: Fluxo para a atividade Gerar Cotaes.
Reprovar: Fluxo para a atividade Fim Rejeitado.
Possuir o mecanismo de atribuio Para um Grupo.
Estar selecionado a opo Quando houver mais de uma opo no
campo Seleciona Colaboradores.
E para a atividade Gerar Cotaes:
- Possuir o mecanismo de atribuio Para um Papel.
- Estar selecionado a opo Quando houver mais de uma opo no
campo Seleciona Colaboradores.
Aps o diagrama de processo ter sido modelado e configurado, preciso
criar o formulrio e os scripts dos eventos do processo.
Veja a seguir como criar esses itens.
Passo 2
15
No script do evento de processo beforeStateEntry verificado para qual

atividade o processo foi movimentado e:
- Caso aprovado e movimentado para a atividade Gerar Cotaes,
chamado o mtodo setApprovalStatus para alterar o status de aprovao
do item da solicitao de compras na Linha do Produto Microsiga Protheus
para liberado (L).
- Caso reprovado e movimentado para a atividade Fim Rejeitado,
chamado o mtodo setApprovalStatus para alterar o status de aprovao
do item da solicitao de compras na Linha do Produto Microsiga Protheus
para rejeitado (R).
No script do evento de processo beforeCancelProcess, chamado o mtodo
setApprovalStatus para alterar o status de aprovao do item da
solicitao de compras na Linha do Produto Microsiga Protheus para
rejeitado (R).
Passo 3
16
No script do evento de processo setApprovalStatus realizada a integrao

com a Linha do Produto Microsiga Protheus utilizando o servio cadastrado
no Fluig.
O mtodo setpurchaserequestapproval, disponibilizado pelo servio,
permite alterar o status de aprovao de um item de solicitao de compras
da Linha Microsiga Protheus e tambm receber como parmetro o nmero
da solicitao, o nmero do item da solicitao, o cdigo do usurio
aprovador e o status de aprovao.
Aps executar o mtodo, verificado o retorno e apresentado ao usurio
caso tenha ocorrido algum erro na Linha do Produto Microsiga Protheus.
Passo 4
O formulrio utilizado pelo processo, possui campos somente leitura para
apresentar dados, do item da solicitao de compras, passados pela Linha
do Produto Microsiga Protheus na inicializao da solicitao do processo.
17
Passo 5
Aps modelar o processo, implementar os eventos criados e criar o

formulrio, exporte o processo para o Fluig, finalizando assim a
configurao do processo integrado no Fluig.
Para finalizar o processo integrado ainda necessrio realizar essas
configuraes na Linha do Produto Microsiga Protheus.
Veja a seguir como realizar as configuraes.
18
5. Processo Integrado - Linha do Produto Microsiga

Protheus
A seguir, veja o passo a passo para realizar as configuraes necessrias na
Linha do Produto Microsiga Protheus.
Passo 1
Verifique se os parmetros MV_ECMWS e MV_ECMEMP esto cadastrados
com os valores corretos.
Para isto, acesse o ambiente Configurador da Linha do Produto Microsiga
Protheus, no menu clique na opo: Ambiente -> Cadastros -> Parmetros,
e em seguida procure os parmetros citados.
Por ltimo, compile na Linha Microsiga Protheus as User Functions

necessrias para o correto funcionamento do processo integrado.
User Function uma funo que permite que os usurios realizem
customizaes para adequar a Linha Microsiga Protheus s suas
necessidades.
Veja a seguir, os cdigos das User Functions necessrias.
19
Passo 2
O Ponto de entrada MT110GRV, executado aps gravar um item da

solicitao de compras.
Pontos de entradas so aberturas em processos operacionais dos programas
da Linha do Produto Microsiga Protheus, possibilitando assim que o
processo possa ser modificado.
Nesse ponto de entrada iniciada uma nova solicitao do processo
MATA110 no Fluig com os dados do item, para cada item da solicitao de
compras.
Passo 3
20
A User Function gera um XML a partir de um registro de solicitao de

compras (SC1).
Esta User Function utilizada no ponto de entrada MT110GRV, para gerar
o XML utilizado como parmetro na funo BIStartTask.
Passo 4
Como demonstrado anteriormente no passo 2 e 3, existem funes
especficas que podem ser utilizadas para realizar a integrao com o Fluig.
As funes podem ser utilizadas no desenvolvimento de uma User Function
da Linha Microsiga Protheus, como em um ponto de entrada, por exemplo.
Na tabela so apresentadas as principais funes disponveis:

BIStartTask: Inicializa uma nova solicitao de processo no Fluig.
21
BIUpdateTask: Movimenta ou Salva uma solicitao de processo existente

no Fluig.
BIGetCardData: Recupera os dados do formulrio de uma solicitao de
processo existente no Fluig.
BIPrtEcm: Permite gravar um registro na tabela de equivalncias da Linha
Microsiga Protheus x Fluig (WFE).
BIEcm2Prt: Converte o cdigo de uma solicitao do Fluig para o cdigo de
um processo da Linha Microsiga Protheus.
BIPrt2Ecm: Converte o cdigo de um processo da Linha Microsiga Protheus
para o cdigo de uma solicitao do Fluig.
Para conhecer todas as funes disponveis na Linha do Produto Microsiga
Protheus para integrao com o Fluig, e obter mais informaes sobre a
utilizao e parmetros delas, consulte o Help Online da Linha Microsiga
Protheus, seo Integraes.
22
6. Processo Integrado Execuo
Aps finalizar todas as configuraes do processo integrado, tanto no Fluig

como na Linha do Produto Microsiga Protheus, o processo estar disponvel
para utilizao.
Lembre-se: Para o correto funcionamento do processo integrado,
necessrio realizar todos os procedimentos exibidos anteriormente, como a
sincronizao de usurios, configurao da Linha do Produto Microsiga
Protheus e a configurao do Fluig.
Para iniciar a execuo do processo integrado, acesse o ambiente Compras
da Linha Microsiga Protheus, em seguida a rotina Solicitao de Compras e
clique na opo Incluir.
A tela de Incluso de uma nova solicitao de Compras exibida.
23
Informe os dados e os itens da solicitao e, aps finalizar, clique no boto

Confirmar.
Note que para esta solicitao de compras, dois itens foram includos.
Aps confirmada a incluso da solicitao de compras, uma mensagem
exibida informando que uma nova solicitao de processo foi criada no
Fluig.
24
criada uma solicitao de processo no Fluig para cada item adicionado na

solicitao de compras.
Os itens includos da solicitao de compras de nmero 000025,
encontram-se bloqueados e so representados pelo semforo cinza nesta
tela.
Acesse a Central de Tarefas do Fluig, e verifique que existem duas novas

solicitaes do processo MATA110 - Solicitao de Compras, as quais foram
criadas anteriormente pela Linha do Produto Microsiga Protheus.
25
Estas solicitaes encontram-se na atividade Aprovar Solicitao, em pool

para o grupo Aprovadores de Compras, e somente os usurios que
pertencem ao grupo podero visualizar e assumir estas tarefas.
Clique na primeira solicitao.
Ao abrir a tela de Detalhes da Solicitao, acesse a aba Detalhes do
Processo para verificar os detalhes da solicitao.
Note que o solicitante o usurio que incluiu a solicitao de compras na

Linha Microsiga Protheus.
Acesse a aba Histrico.
26
Observe o comentrio do movimento 1 - Incio, informando que a solicitao

foi gerada atravs da Linha do Produto Microsiga Protheus.
Acesse a aba Formulrio.
O formulrio da solicitao apresenta os dados do item 0001 da solicitao

de compras includa na Linha Microsiga Protheus.
Acesse a aba Processo.
27
Observe que o processo encontra-se na atividade Aprovar Solicitao.

Aps visualizado os detalhes da solicitao, assuma a tarefa atravs do
boto Assumir Tarefa presente na aba Detalhes do Processo, conforme
exibido no passo 7.
Para a Solicitao de Processo do item 0001, envie o processo para a
atividade Aprovar, aprovando o item em questo.
28
Acesse a rotina Solicitao de Compras da Linha do Produto Microsiga

Protheus novamente.
Observe que agora o item 0001 da solicitao de compras de nmero

000025 encontra-se liberado e representado pelo semforo verde.
Verifique que o usurio que executou a tarefa no Fluig o usurio
aprovador do item da solicitao de compras em questo.
29
Consulte as solicitaes do processo MATA110 - Solicitaes de Compras.

A solicitao de processo movimentada anteriormente encontra-se na aba
processos em aberto, clique para visualizar.
Ao abrir a tela de Detalhes da Solicitao, acesse a aba Processo.
Verifique que o processo encontra-se na atividade Gerar Cotaes.
30
Acesse a Central de Tarefas do Fluig novamente e clique na outra

solicitao gerada atravs da Linha do Produto Microsiga Protheus.
Assuma a tarefa, para isto acesse a aba Detalhes do Processo e clique na

opo Assumir Tarefa, conforme exibido no passo 7.
Em seguida, envie a solicitao de processo do item 0002 para a atividade
Reprovar, rejeitando o item em questo.
31
Acesse a rotina Solicitao de Compras da Linha Microsiga Protheus

novamente.
Observe que agora o item 0002 da solicitao de compras de nmero

000025 encontra-se rejeitado e representado pelo semforo laranja.
Verifique que o usurio que executou a tarefa no Fluig o usurio
aprovador do item da Solicitao de Compras.
32
Consulte as solicitaes do processo MATA110 - Solicitaes de Compras

novamente.
A segunda solicitao encontra-se na aba processos finalizados, clique para
abrir.
Ao abrir a tela de Detalhes da Solicitao, acesse a aba Processo e observe

que esta solicitao encontra-se em Fim Rejeitada.
33
7. Concluso
Assim, voc terminou o treinamento Integrao Fluig x Linha do Produto
Microsiga Protheus do curso Integrao do Fluig.
Neste treinamento voc conheceu mais sobre:
Sincronizao de Usurios.
Configurao do Servio Linha do Produto Microsiga Protheus no Fluig.
Utilizao do Servio Linha do Produto Microsiga Protheus no Fluig.
Processo Integrado Fluig.
Processo Integrado Linha do Produto Microsiga Protheus.
Processo Integrado Execuo.
34

Integracao Fluig Protheus

Enviado por

Direitos autorais:

Formatos disponíveis

Integracao Fluig Protheus

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Integracao Fluig Protheus

Enviado por

Direitos autorais:

Formatos disponíveis

Integrao Fluig

Objetivos do Treinamento .................................................................. 3

Sincronizao de Usurios ................................................................. 4

Configurao e Utilizao do Servio Linha do Produto Microsiga

Processo Integrado - Fluig ............................................................... 14

Processo Integrado - Linha do Produto Microsiga Protheus......... 19

Processo Integrado Execuo ........................................................ 23

1.1. Objetivos do Treinamento

Clique em Avanar para prosseguir com a configurao.

Nesta tela, preencha os parmetros para comunicao com o servidor do

Neste caso, revise os parmetros informados e clique novamente em

Selecione os grupos de usurios desejados e clique em Avanar.

Selecione os usurios desejados para sincronizar e clique em Avanar.

3. Configurao e Utilizao do Servio Linha do

O cadastro dos servios disponibilizados pela Linha Microsiga Protheus

Para mais detalhes de como cadastrar servios no Fluig, verifique o

O procedimento para utilizao dos servios sempre o mesmo,

Observe na imagem um exemplo de implementao de como utilizar um

Este Dataset poder ser utilizado em qualquer customizao do Fluig, como

4. Processo Integrado - Fluig

A imagem apresenta o diagrama do processo integrado MATA110,

No script do evento de processo beforeStateEntry verificado para qual

No script do evento de processo setApprovalStatus realizada a integrao

Aps modelar o processo, implementar os eventos criados e criar o

5. Processo Integrado - Linha do Produto Microsiga

Por ltimo, compile na Linha Microsiga Protheus as User Functions

O Ponto de entrada MT110GRV, executado aps gravar um item da

A User Function gera um XML a partir de um registro de solicitao de

Na tabela so apresentadas as principais funes disponveis:

BIUpdateTask: Movimenta ou Salva uma solicitao de processo existente

6. Processo Integrado Execuo

Aps finalizar todas as configuraes do processo integrado, tanto no Fluig

A tela de Incluso de uma nova solicitao de Compras exibida.

Informe os dados e os itens da solicitao e, aps finalizar, clique no boto

criada uma solicitao de processo no Fluig para cada item adicionado na

Acesse a Central de Tarefas do Fluig, e verifique que existem duas novas

Estas solicitaes encontram-se na atividade Aprovar Solicitao, em pool

Note que o solicitante o usurio que incluiu a solicitao de compras na

Observe o comentrio do movimento 1 - Incio, informando que a solicitao

O formulrio da solicitao apresenta os dados do item 0001 da solicitao

Observe que o processo encontra-se na atividade Aprovar Solicitao.

Acesse a rotina Solicitao de Compras da Linha do Produto Microsiga

Observe que agora o item 0001 da solicitao de compras de nmero

Consulte as solicitaes do processo MATA110 - Solicitaes de Compras.

Ao abrir a tela de Detalhes da Solicitao, acesse a aba Processo.

Verifique que o processo encontra-se na atividade Gerar Cotaes.

Acesse a Central de Tarefas do Fluig novamente e clique na outra

Assuma a tarefa, para isto acesse a aba Detalhes do Processo e clique na

Acesse a rotina Solicitao de Compras da Linha Microsiga Protheus

Observe que agora o item 0002 da solicitao de compras de nmero

Consulte as solicitaes do processo MATA110 - Solicitaes de Compras

Ao abrir a tela de Detalhes da Solicitao, acesse a aba Processo e observe

Você também pode gostar