You are on page 1of 34

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

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

12

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


por exemplo, em um Zoom de formulrio.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

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.

fluig.com | 0800 882 9191 | Av. Braz Leme 1717, Casa Verde | 02511-000 | So Paulo - Brasil

34