INTEGRACAO+FLUIG+PROTHEUS

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

2. Sincronização de Usuários Para o correto funcionamento das integrações entre o Fluig e a Linha do Produto Microsiga Protheus, os usuários dos dois sistemas devem estar sincronizados. 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, caso um usuário 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 usuários da Linha do Produto Microsiga Protheus no Fluig,

Passo 1 Para sincronizar os usuários da Linha do Produto Microsiga Protheus com o Fluig, acesse o ambiente Configurador da Linha do Produto Microsiga Protheus, e no menu clique na opção: Ambiente -> Totvs Ecm -> Wizard do Wf. O assistente de configuração será aberto.

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

4

Clique em Avançar para prosseguir com a configuração.

Passo 2

Nesta tela, preencha os parâmetros para comunicação com o servidor do Fluig. Informe o endereço dos WebServices, os dados para autenticação e a empresa do Fluig. Clique em Avançar.

Passo 3 Caso ocorra algum erro de comunicação 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 | São Paulo - Brasil

5

Neste caso, revise os parâmetros informados e clique novamente em Avançar.

Passo 4 Caso a comunicação com o Fluig seja realizada com sucesso, é 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.

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

6

Selecione os grupos de usuários desejados e clique em Avançar.

Passo 5 A seguir, 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.

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. Caso necessário migrar os grupos de usuários, 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. Em seguida, clique em Avançar.

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

7

Passo 7 Caso desejado, é possível associar um Papel cadastrado no Fluig aos usuários da Linha do Produto Microsiga Protheus que serão 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 | São Paulo - Brasil

8

Passo 8 Após finalizar o processo na Linha Microsiga Protheus, acesse o cadastro de Usuários do Fluig. Verifique que os usuários da Linha do Produto Microsiga Protheus serão exibidos.

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

9

3. Configuração e Utilização do Serviço Linha do Produto Microsiga Protheus no Fluig A seguir, veja o passo a passo para configurar e utilizar o Serviço Linha Microsiga Protheus no 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. 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.

O cadastro dos serviços disponibilizados pela Linha Microsiga Protheus é realizado no Studio, através da visão Visualização de Serviços.

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

10

Para mais detalhes de como cadastrar serviços no Fluig, verifique o treinamento Studio IV.

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, como em scripts para eventos globais, eventos de processos, eventos de formulário ou datasets.

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

11

O procedimento para utilização dos serviços é sempre o mesmo, independente em qual ponto está sendo utilizado. Para facilitar o entendimento do uso dos serviços da Linha do Produto Microsiga Protheus no Fluig, veja a seguir o exemplo de utilização via Dataset.

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. Para mais detalhes de como criar Datasets customizados e utilizar serviços no Fluig, assista ao treinamento Studio IV. Na imagem é apresentado o resultado da consulta do Dataset através do Studio.

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

12

Este Dataset poderá ser utilizado em qualquer customização do Fluig, como por exemplo, em um Zoom de formulário.

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

13

4. Processo Integrado - 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. Um processo integrado é um processo do Fluig que possui integrações com outros sistemas, ou seja, o processo irá utilizar e fornecer informações para os outros sistemas. Como exemplo, será apresentado um processo de solicitação de compras onde: 1. Uma solicitação de compras é adicionada na Linha Microsiga Protheus. 2. O processo de aprovação da solicitação é iniciado no Fluig. 3. Após a decisão tomada no processo, altera o status de aprovação da solicitação 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 integração entre o Fluig e a Linha Microsiga Protheus. A seguir, ao clicar nas setas acima ou na sequência de números abaixo, veja o passo a passo para criar um processo com integração entre a Linha do Produto Microsiga Protheus e o Fluig,

Passo 1 Para criar um processo que possui integração entre a Linha do Produto Microsiga Protheus e o Fluig, primeiramente é necessário 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 | São 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 Início: - 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. • Possuir o mecanismo de atribuição Para um Grupo. • Estar selecionado a opção Quando houver mais de uma opção no campo Seleciona Colaboradores. • E para a atividade Gerar Cotações: - Possuir o mecanismo de atribuição Para um Papel. - Estar selecionado a opção Quando houver mais de uma opção no campo Seleciona Colaboradores. Após o diagrama de processo ter sido modelado e configurado, é preciso criar o formulário 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 | São 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 Cotações, é 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). - 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 rejeitado (R). No script do evento de processo beforeCancelProcess, é 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).

Passo 3

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

16

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. O método setpurchaserequestapproval, disponibilizado pelo serviç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, o número do item da solicitação, o código do usuário aprovador e o status de aprovação. Após executar o método, é verificado o retorno e é apresentado ao usuário caso tenha ocorrido algum erro na Linha do Produto Microsiga Protheus.

Passo 4 O formulário utilizado pelo processo, possui campos somente leitura para apresentar dados, do item da solicitação de compras, passados pela Linha do Produto Microsiga Protheus na inicialização da solicitação do processo.

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

17

Passo 5

Após modelar o processo, implementar os eventos criados e criar o formulário, exporte o processo para o Fluig, finalizando assim a configuração do processo integrado no 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.

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

18

5. Processo Integrado - Linha do Produto Microsiga Protheus A seguir, veja o passo a passo para realizar as configurações necessárias na Linha do Produto Microsiga Protheus.

Passo 1 Verifique se os parâmetros MV_ECMWS e MV_ECMEMP estão cadastrados com os valores corretos. Para isto, acesse o ambiente Configurador da Linha do Produto Microsiga Protheus, no menu clique na opção: Ambiente -> Cadastros -> Parâmetros, e em seguida procure os parâmetros citados.

Por último, compile na Linha Microsiga Protheus as User Functions necessárias para o correto funcionamento do 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. Veja a seguir, os códigos das User Functions necessárias.

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

19

Passo 2

O Ponto de entrada MT110GRV, é executado após gravar um item da solicitação de compras. Pontos de entradas são 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 solicitação do processo MATA110 no Fluig com os dados do item, para cada item da solicitação de compras.

Passo 3

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

20

A User Function gera um XML a partir de um registro de solicitação de compras (SC1). Esta User Function é utilizada no ponto de entrada MT110GRV, para gerar o XML utilizado como parâmetro na função BIStartTask.

Passo 4 Como demonstrado anteriormente no passo 2 e 3, existem funções específicas que podem ser utilizadas para realizar a integração com o Fluig. As funções podem ser utilizadas no desenvolvimento de uma User Function da Linha Microsiga Protheus, como em um ponto de entrada, por exemplo.

Na tabela são apresentadas as principais funções disponíveis: BIStartTask: Inicializa uma nova solicitação de processo no Fluig.

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

21

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

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

22

6. Processo Integrado Execução

Após finalizar todas as configurações do processo integrado, tanto no Fluig como na Linha do Produto Microsiga Protheus, o processo estará disponível para utilização. Lembre-se: Para o correto funcionamento do processo integrado, é necessário realizar todos os procedimentos exibidos anteriormente, como a sincronização de usuários, configuração da Linha do Produto Microsiga Protheus e a configuração do Fluig. Para iniciar a execução do processo integrado, acesse o ambiente Compras da Linha Microsiga Protheus, em seguida a rotina Solicitação de Compras e clique na opção Incluir.

A tela de Inclusão de uma nova solicitação de Compras é exibida.

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

23

Informe os dados e os itens da solicitação e, após finalizar, clique no botão Confirmar. Note que para esta solicitação de compras, dois itens foram incluídos. Após confirmada a inclusão da solicitação de compras, uma mensagem é exibida informando que uma nova solicitação de processo foi criada no Fluig.

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

24

É criada uma solicitação de processo no Fluig para cada item adicionado na solicitação de compras. Os itens incluídos da solicitação de compras de número 000025, encontram-se bloqueados e são representados pelo semáforo cinza nesta tela.

Acesse a Central de Tarefas do Fluig, e verifique que existem duas novas solicitações do processo MATA110 - Solicitação 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 | São Paulo - Brasil

25

Estas solicitações encontram-se na atividade Aprovar Solicitação, em pool para o grupo Aprovadores de Compras, e somente os usuários que pertencem ao grupo poderão visualizar e assumir estas tarefas. Clique na primeira solicitação. Ao abrir a tela de Detalhes da Solicitação, acesse a aba Detalhes do Processo para verificar os detalhes da solicitação.

Note que o solicitante é o usuário que incluiu a solicitação de compras na Linha Microsiga Protheus. Acesse a aba Histórico.

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

26

Observe o comentário do movimento 1 - Início, informando que a solicitação foi gerada através da Linha do Produto Microsiga Protheus. Acesse a aba Formulário.

O formulário da solicitação apresenta os dados do item 0001 da solicitação de compras incluída na Linha Microsiga Protheus. Acesse a aba Processo.

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

27

Observe que o processo encontra-se na atividade Aprovar Solicitação. Após visualizado os detalhes da solicitação, assuma a tarefa através do botão Assumir Tarefa presente na aba Detalhes do Processo, conforme exibido no passo 7. Para a Solicitação de Processo do item 0001, envie o processo para a atividade Aprovar, aprovando o item em questão.

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

28

Acesse a rotina Solicitação de Compras da Linha do Produto Microsiga Protheus novamente.

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.

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

29

Consulte as solicitações do processo MATA110 - Solicitações de Compras. A solicitação de processo movimentada anteriormente encontra-se na aba processos em aberto, clique para visualizar.

Ao abrir a tela de Detalhes da Solicitação, acesse a aba Processo.

Verifique que o processo encontra-se na atividade Gerar Cotações.

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

30

Acesse a Central de Tarefas do Fluig novamente e clique na outra solicitação gerada através da Linha do Produto Microsiga Protheus.

Assuma a tarefa, para isto acesse a aba Detalhes do Processo e clique na opção Assumir Tarefa, conforme exibido no passo 7. Em seguida, envie a solicitação de processo do item 0002 para a atividade Reprovar, rejeitando o item em questão.

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

31

Acesse a rotina Solicitação de Compras da Linha Microsiga Protheus novamente.

Observe que agora o item 0002 da solicitação de compras de número 000025 encontra-se rejeitado e é representado pelo semáforo laranja. Verifique que o usuário que executou a tarefa no Fluig é o usuário aprovador do item da Solicitação de Compras.

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

32

Consulte as solicitações do processo MATA110 - Solicitações de Compras novamente. A segunda solicitação encontra-se na aba processos finalizados, clique para abrir.

Ao abrir a tela de Detalhes da Solicitação, acesse a aba Processo e observe que esta solicitação encontra-se em Fim Rejeitada.

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

33

7. Conclusão Assim, você terminou o treinamento Integração Fluig x Linha do Produto Microsiga Protheus do curso Integração do Fluig. Neste treinamento você conheceu mais sobre: • • • • • •

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

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

34