You are on page 1of 34

Integração Fluig

x
Linha do Produto Microsiga Protheus
Integração

Título do documento

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

1

Sumário
1.

Introdução ........................................................................................... 3

1.1.

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

1.2.

Aviso ..................................................................................................... 3

2.

Sincronização de Usuários ................................................................. 4

3.

Configuração e Utilização do Serviço 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 Execução ........................................................ 23

7.

Conclusão ......................................................................................... 34

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

2

1. Introdução
Olá!
Seja bem-vindo ao treinamento Integração Fluig x Linha do Produto
Microsiga Protheus do curso Integração do Fluig.

1.1. Objetivos do Treinamento
Ao término deste treinamento você terá conhecido mais sobre:





Sincronização de Usuários.
Configuração do Serviço Linha Microsiga Protheus no Fluig.
Utilização do Serviço Linha Microsiga Protheus no Fluig.
Processo Integrado Fluig.
Processo Integrado Linha Microsiga Protheus.
Processo Integrado Execução.

1.2. Aviso
O Fluig foi desenvolvido para integrar-se a diversos sistemas, permitindo
assim que os processos modelados possuam maior valor agregado.
É possível consultar e alimentar informações no Fluig através de um sistema
externo, bem como facilitar que outros sistemas conectem-se para consultar
informações ou para execução de operações transacionais.
Para realizar a integração entre Fluig e Linha do Produto Microsiga
Protheus é necessário que os usuários dos dois sistemas estejam
sincronizados, e a integração é realizada através da utilização de Web
Services disponibilizados pelos sistemas.

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

3

Braz Leme 1717.com | 0800 882 9191 | Av. acesse o ambiente Configurador da Linha do Produto Microsiga Protheus. Na Linha Microsiga Protheus existe um recurso para a configuração inicial dos parâmetros de integração e para a exportação dos usuários que estão cadastrados no ERP para o Fluig. É importante lembrar que. e no menu clique na opção: Ambiente -> Totvs Ecm -> Wizard do Wf. O assistente de configuração será aberto. Sincronização de Usuários Para o correto funcionamento das integrações entre o Fluig e a Linha do Produto Microsiga Protheus. fluig. A seguir. os usuários dos dois sistemas devem estar sincronizados. Casa Verde | 02511-000 | São Paulo . ele deve estar cadastrado no Fluig com o mesmo login e senha da Linha Microsiga Protheus.2. caso um usuário cadastrado na Linha Microsiga Protheus desejar executar um processo que se comunique com o Fluig. Passo 1 Para sincronizar os usuários da Linha do Produto Microsiga Protheus com o Fluig.Brasil 4 . veja o passo a passo para sincronizar usuários da Linha do Produto Microsiga Protheus no Fluig.

uma mensagem de erro será exibida e o assistente continuará na mesma tela. os dados para autenticação e a empresa do Fluig.Brasil 5 . Passo 2 Nesta tela. fluig. Casa Verde | 02511-000 | São Paulo . Braz Leme 1717.com | 0800 882 9191 | Av. Informe o endereço dos WebServices.Clique em Avançar para prosseguir com a configuração. preencha os parâmetros para comunicação com o servidor do Fluig. Clique em Avançar. Passo 3 Caso ocorra algum erro de comunicação com o Fluig.

Braz Leme 1717. fluig. Casa Verde | 02511-000 | São Paulo . é exibida uma tela onde é necessário selecionar os grupos de usuários da Linha do Produto Microsiga Protheus que serão transferidos para o Fluig.Neste caso.Brasil 6 . Passo 4 Caso a comunicação com o Fluig seja realizada com sucesso. revise os parâmetros informados e clique novamente em Avançar.com | 0800 882 9191 | Av.

Brasil 7 . fluig.com | 0800 882 9191 | Av. selecione Sim para a opção Migrar os grupos do Microsiga Protheus e selecione o grupo do Fluig para associar aos usuários que serão transferidos. são exibidos todos os usuários presentes nos grupos de usuários que foram selecionados anteriormente e que ainda não constam no Fluig. Selecione os usuários desejados para sincronizar e clique em Avançar. clique em Avançar. Caso necessário migrar os grupos de usuários. Passo 5 A seguir.Selecione os grupos de usuários desejados e clique em Avançar. Em seguida. Braz Leme 1717. Passo 6 É possível migrar os grupos de usuários da Linha do Produto Microsiga Protheus para o Fluig e também associar a um dos grupos já cadastrados no Fluig os usuários que serão cadastrados. Casa Verde | 02511-000 | São Paulo .

Passo 7 Caso desejado. selecione um Papel e em seguida clique em Finalizar. é possível associar um Papel cadastrado no Fluig aos usuários da Linha do Produto Microsiga Protheus que serão transferidos para o Fluig. fluig. Braz Leme 1717. Para isso.com | 0800 882 9191 | Av.Brasil 8 . Casa Verde | 02511-000 | São Paulo .

Braz Leme 1717. Casa Verde | 02511-000 | São Paulo .Brasil 9 . acesse o cadastro de Usuários do Fluig.Passo 8 Após finalizar o processo na Linha Microsiga Protheus. fluig. Verifique que os usuários da Linha do Produto Microsiga Protheus serão exibidos.com | 0800 882 9191 | Av.

Casa Verde | 02511-000 | São Paulo . O cadastro dos serviços disponibilizados pela Linha Microsiga Protheus é realizado no Studio. veja o passo a passo para configurar e utilizar o Serviço Linha Microsiga Protheus no Fluig. fluig. Configuração É possível realizar integrações entre a Linha do Produto Microsiga Protheus e o Fluig utilizando WebServices disponibilizados pela Linha Microsiga Protheus.Brasil 10 . através da visão Visualização de Serviços. A Linha do Produto Microsiga Protheus disponibiliza uma página web onde é possível consultar todos os WebServices disponíveis. além de obter seus endereços para cadastro no Fluig.3. Configuração e Utilização do Serviço Linha do Produto Microsiga Protheus no Fluig A seguir.com | 0800 882 9191 | Av. Braz Leme 1717.

fluig. Utilização Os serviços da Linha do Produto Microsiga Protheus adicionados ao Fluig podem ser instanciados e utilizados em qualquer ponto onde o Fluig permite customização.Para mais detalhes de como cadastrar serviços no Fluig. como em scripts para eventos globais. verifique o treinamento Studio IV. Casa Verde | 02511-000 | São Paulo . eventos de formulário ou datasets. eventos de processos.com | 0800 882 9191 | Av.Brasil 11 . Braz Leme 1717.

O procedimento para utilização dos serviços é sempre o mesmo. Casa Verde | 02511-000 | São Paulo .Brasil 12 . Para mais detalhes de como criar Datasets customizados e utilizar serviços no Fluig. Para facilitar o entendimento do uso dos serviços da Linha do Produto Microsiga Protheus no Fluig. Na imagem é apresentado o resultado da consulta do Dataset através do Studio.com | 0800 882 9191 | Av. veja a seguir o exemplo de utilização via Dataset. Braz Leme 1717. assista ao treinamento Studio IV. independente em qual ponto está sendo utilizado. Observe na imagem um exemplo de implementação de como utilizar um serviço da Linha do Produto Microsiga Protheus na criação de um Dataset. fluig.

fluig. como por exemplo.com | 0800 882 9191 | Av. Braz Leme 1717. em um Zoom de formulário.Brasil 13 .Este Dataset poderá ser utilizado em qualquer customização do Fluig. Casa Verde | 02511-000 | São Paulo .

Brasil 14 . Processo Integrado . 3.com | 0800 882 9191 | Av.4. fluig. Como exemplo. ao clicar nas setas acima ou na sequência de números abaixo. o processo irá utilizar e fornecer informações para os outros sistemas. ou seja. altera o status de aprovação da solicitação de compras na Linha do Produto Microsiga Protheus. será apresentado um processo de solicitação de compras onde: 1. Braz Leme 1717. Casa Verde | 02511-000 | São Paulo . O processo de aprovação da solicitação é iniciado no Fluig. Após a decisão tomada no processo. veja o passo a passo para criar um processo com integração entre a Linha do Produto Microsiga Protheus e o Fluig. e em seguida. que possui como objetivo principal demonstrar como realizar uma integração entre o Fluig e a Linha Microsiga Protheus. Uma solicitação de compras é adicionada na Linha Microsiga Protheus. 2. Um processo integrado é um processo do Fluig que possui integrações com outros sistemas. primeiramente é necessário realizar a modelagem do processo. A seguir. configurar as atividades do processo. Lembre-se que este exemplo apresenta um processo simplificado.Fluig Após realizar a sincronização de usuários e a configuração do serviço da Linha do Produto Microsiga Protheus no Fluig é possível criar um processo integrado. Passo 1 Para criar um processo que possui integração entre a Linha do Produto Microsiga Protheus e o Fluig.

Casa Verde | 02511-000 | São Paulo .com | 0800 882 9191 | Av. Passo 2 fluig. Veja a seguir como criar esses itens. é preciso criar o formulário e os scripts dos eventos do processo. • Estar selecionado a opção Quando houver mais de uma opção no campo Seleciona Colaboradores.Estar selecionado a opção Quando houver mais de uma opção no campo Seleciona Colaboradores. demonstrando suas atividades e fluxos. Braz Leme 1717. Modele o processo conforme visto na imagem e configure suas atividades: • Para a atividade Início: . • E para a atividade Gerar Cotações: .Brasil 15 . • Possuir o mecanismo de atribuição Para um Grupo. Após o diagrama de processo ter sido modelado e configurado.A imagem apresenta o diagrama do processo integrado MATA110.Possuir o mecanismo de atribuição Para um Papel. .Não possuir mecanismo de atribuição definido • Para a atividade Aprovar Solicitação: -Possuir dois fluxos de saída: Aprovar: Fluxo para a atividade Gerar Cotações. Reprovar: Fluxo para a atividade Fim Rejeitado.

Passo 3 fluig. No script do evento de processo beforeCancelProcess. Casa Verde | 02511-000 | São Paulo . .No script do evento de processo beforeStateEntry é verificado para qual atividade o processo foi movimentado e: . é chamado o método setApprovalStatus para alterar o status de aprovação do item da solicitação de compras na Linha do Produto Microsiga Protheus para rejeitado (R).com | 0800 882 9191 | Av.Brasil 16 . Braz Leme 1717.Caso reprovado e movimentado para a atividade Fim Rejeitado. é chamado o método setApprovalStatus para alterar o status de aprovação do item da solicitação de compras na Linha do Produto Microsiga Protheus para liberado (L). é chamado o método setApprovalStatus para alterar o status de aprovação do item da solicitação de compras na Linha do Produto Microsiga Protheus para rejeitado (R).Caso aprovado e movimentado para a atividade Gerar Cotações.

o número do item da solicitação. fluig. Passo 4 O formulário utilizado pelo processo. passados pela Linha do Produto Microsiga Protheus na inicialização da solicitação do processo. Braz Leme 1717. possui campos somente leitura para apresentar dados. o código do usuário aprovador e o status de aprovação. permite alterar o status de aprovação de um item de solicitação de compras da Linha Microsiga Protheus e também receber como parâmetro o número da solicitação.No script do evento de processo setApprovalStatus é realizada a integração com a Linha do Produto Microsiga Protheus utilizando o serviço cadastrado no Fluig.com | 0800 882 9191 | Av. Após executar o método.Brasil 17 . Casa Verde | 02511-000 | São Paulo . O método setpurchaserequestapproval. disponibilizado pelo serviço. do item da solicitação de compras. é verificado o retorno e é apresentado ao usuário caso tenha ocorrido algum erro na Linha do Produto Microsiga Protheus.

exporte o processo para o Fluig. Para finalizar o processo integrado ainda é necessário realizar essas configurações na Linha do Produto Microsiga Protheus. Veja a seguir como realizar as configurações. finalizando assim a configuração do processo integrado no Fluig.Brasil 18 .Passo 5 Após modelar o processo.com | 0800 882 9191 | Av. Braz Leme 1717. implementar os eventos criados e criar o formulário. Casa Verde | 02511-000 | São Paulo . fluig.

Linha do Produto Microsiga Protheus A seguir. no menu clique na opção: Ambiente -> Cadastros -> Parâmetros. e em seguida procure os parâmetros citados.com | 0800 882 9191 | Av. acesse o ambiente Configurador da Linha do Produto Microsiga Protheus. Veja a seguir.5. os códigos das User Functions necessárias. Passo 1 Verifique se os parâmetros MV_ECMWS e MV_ECMEMP estão cadastrados com os valores corretos. Processo Integrado . User Function é uma função que permite que os usuários realizem customizações para adequar a Linha Microsiga Protheus às suas necessidades. Casa Verde | 02511-000 | São Paulo . veja o passo a passo para realizar as configurações necessárias na Linha do Produto Microsiga Protheus.Brasil 19 . fluig. Para isto. Braz Leme 1717. Por último. compile na Linha Microsiga Protheus as User Functions necessárias para o correto funcionamento do processo integrado.

Braz Leme 1717.com | 0800 882 9191 | Av. Pontos de entradas são aberturas em processos operacionais dos programas da Linha do Produto Microsiga Protheus.Brasil 20 . é executado após gravar um item da solicitação de compras.Passo 2 O Ponto de entrada MT110GRV. para cada item da solicitação de compras. possibilitando assim que o processo possa ser modificado. Passo 3 fluig. Nesse ponto de entrada é iniciada uma nova solicitação do processo MATA110 no Fluig com os dados do item. Casa Verde | 02511-000 | São Paulo .

Braz Leme 1717.Brasil 21 . As funções podem ser utilizadas no desenvolvimento de uma User Function da Linha Microsiga Protheus. Na tabela são apresentadas as principais funções disponíveis: BIStartTask: Inicializa uma nova solicitação de processo no Fluig. para gerar o XML utilizado como parâmetro na função BIStartTask. Casa Verde | 02511-000 | São Paulo . fluig. Esta User Function é utilizada no ponto de entrada MT110GRV.A User Function gera um XML a partir de um registro de solicitação de compras (SC1). por exemplo.com | 0800 882 9191 | Av. existem funções específicas que podem ser utilizadas para realizar a integração com o Fluig. como em um ponto de entrada. Passo 4 Como demonstrado anteriormente no passo 2 e 3.

BIUpdateTask: Movimenta ou Salva uma solicitação de processo existente no Fluig. BIPrt2Ecm: Converte o código de um processo da Linha Microsiga Protheus para o código de uma solicitação do Fluig.Brasil 22 .com | 0800 882 9191 | Av. BIGetCardData: Recupera os dados do formulário de uma solicitação de processo existente no Fluig. fluig. BIPrtEcm: Permite gravar um registro na tabela de equivalências da Linha Microsiga Protheus x Fluig (WFE). Para conhecer todas as funções disponíveis na Linha do Produto Microsiga Protheus para integração com o Fluig. consulte o Help Online da Linha Microsiga Protheus. BIEcm2Prt: Converte o código de uma solicitação do Fluig para o código de um processo da Linha Microsiga Protheus. Braz Leme 1717. Casa Verde | 02511-000 | São Paulo . e obter mais informações sobre a utilização e parâmetros delas. seção Integrações.

é necessário realizar todos os procedimentos exibidos anteriormente. Braz Leme 1717. como a sincronização de usuários. fluig. Casa Verde | 02511-000 | São Paulo . A tela de Inclusão de uma nova solicitação de Compras é exibida. em seguida a rotina Solicitação de Compras e clique na opção Incluir. o processo estará disponível para utilização. Para iniciar a execução do processo integrado. acesse o ambiente Compras da Linha Microsiga Protheus. Lembre-se: Para o correto funcionamento do processo integrado.6.Brasil 23 .com | 0800 882 9191 | Av. Processo Integrado Execução Após finalizar todas as configurações do processo integrado. tanto no Fluig como na Linha do Produto Microsiga Protheus. configuração da Linha do Produto Microsiga Protheus e a configuração do Fluig.

dois itens foram incluídos. Após confirmada a inclusão da solicitação de compras. fluig. Braz Leme 1717. após finalizar. Note que para esta solicitação de compras. uma mensagem é exibida informando que uma nova solicitação de processo foi criada no Fluig. clique no botão Confirmar.com | 0800 882 9191 | Av.Brasil 24 . Casa Verde | 02511-000 | São Paulo .Informe os dados e os itens da solicitação e.

Casa Verde | 02511-000 | São Paulo . as quais foram criadas anteriormente pela Linha do Produto Microsiga Protheus. fluig. Acesse a Central de Tarefas do Fluig. encontram-se bloqueados e são representados pelo semáforo cinza nesta tela. Os itens incluídos da solicitação de compras de número 000025. Braz Leme 1717.com | 0800 882 9191 | Av.É criada uma solicitação de processo no Fluig para cada item adicionado na solicitação de compras.Solicitação de Compras. e verifique que existem duas novas solicitações do processo MATA110 .Brasil 25 .

Ao abrir a tela de Detalhes da Solicitação. Acesse a aba Histórico.Estas solicitações encontram-se na atividade Aprovar Solicitação. e somente os usuários que pertencem ao grupo poderão visualizar e assumir estas tarefas. acesse a aba Detalhes do Processo para verificar os detalhes da solicitação. fluig. Note que o solicitante é o usuário que incluiu a solicitação de compras na Linha Microsiga Protheus. Casa Verde | 02511-000 | São Paulo . Braz Leme 1717. Clique na primeira solicitação. em pool para o grupo Aprovadores de Compras.Brasil 26 .com | 0800 882 9191 | Av.

Acesse a aba Processo. Acesse a aba Formulário.com | 0800 882 9191 | Av.Brasil 27 . Casa Verde | 02511-000 | São Paulo . O formulário da solicitação apresenta os dados do item 0001 da solicitação de compras incluída na Linha Microsiga Protheus. informando que a solicitação foi gerada através da Linha do Produto Microsiga Protheus.Início.Observe o comentário do movimento 1 . Braz Leme 1717. fluig.

Após visualizado os detalhes da solicitação. Braz Leme 1717.Observe que o processo encontra-se na atividade Aprovar Solicitação. envie o processo para a atividade Aprovar.Brasil 28 . assuma a tarefa através do botão Assumir Tarefa presente na aba Detalhes do Processo. aprovando o item em questão. Para a Solicitação de Processo do item 0001. fluig. Casa Verde | 02511-000 | São Paulo . conforme exibido no passo 7.com | 0800 882 9191 | Av.

Observe que agora o item 0001 da solicitação de compras de número 000025 encontra-se liberado e é representado pelo semáforo verde. Verifique que o usuário que executou a tarefa no Fluig é o usuário aprovador do item da solicitação de compras em questão.Brasil 29 . Casa Verde | 02511-000 | São Paulo .com | 0800 882 9191 | Av. Braz Leme 1717.Acesse a rotina Solicitação de Compras da Linha do Produto Microsiga Protheus novamente. fluig.

Braz Leme 1717. Verifique que o processo encontra-se na atividade Gerar Cotações. Ao abrir a tela de Detalhes da Solicitação. acesse a aba Processo.Consulte as solicitações do processo MATA110 . Casa Verde | 02511-000 | São Paulo . clique para visualizar.com | 0800 882 9191 | Av. fluig. A solicitação de processo movimentada anteriormente encontra-se na aba processos em aberto.Brasil 30 .Solicitações de Compras.

Acesse a Central de Tarefas do Fluig novamente e clique na outra solicitação gerada através da Linha do Produto Microsiga Protheus. Em seguida. para isto acesse a aba Detalhes do Processo e clique na opção Assumir Tarefa.Brasil 31 . Braz Leme 1717.com | 0800 882 9191 | Av. rejeitando o item em questão. fluig. conforme exibido no passo 7. envie a solicitação de processo do item 0002 para a atividade Reprovar. Casa Verde | 02511-000 | São Paulo . Assuma a tarefa.

Acesse a rotina Solicitação de Compras da Linha Microsiga Protheus novamente. fluig. Observe que agora o item 0002 da solicitação de compras de número 000025 encontra-se rejeitado e é representado pelo semáforo laranja. Casa Verde | 02511-000 | São Paulo . Braz Leme 1717. Verifique que o usuário que executou a tarefa no Fluig é o usuário aprovador do item da Solicitação de Compras.Brasil 32 .com | 0800 882 9191 | Av.

A segunda solicitação encontra-se na aba processos finalizados.com | 0800 882 9191 | Av.Brasil 33 .Consulte as solicitações do processo MATA110 .Solicitações de Compras novamente. Braz Leme 1717. Ao abrir a tela de Detalhes da Solicitação. fluig. acesse a aba Processo e observe que esta solicitação encontra-se em Fim Rejeitada. clique para abrir. Casa Verde | 02511-000 | São Paulo .

Brasil 34 . você terminou o treinamento Integração Fluig x Linha do Produto Microsiga Protheus do curso Integração do Fluig. Utilização do Serviço Linha do Produto Microsiga Protheus no Fluig. Casa Verde | 02511-000 | São Paulo . Processo Integrado Fluig. Braz Leme 1717. Processo Integrado Execução. Configuração do Serviço Linha do Produto Microsiga Protheus no Fluig.7.com | 0800 882 9191 | Av. Processo Integrado Linha do Produto Microsiga Protheus. Conclusão Assim. fluig. Neste treinamento você conheceu mais sobre: • • • • • • Sincronização de Usuários.