Integração Fluig X Microsiga Protheus PDF

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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Este Dataset poderá ser utilizado em qualquer customização do Fluig, como
por exemplo, em um Zoom de formulário.
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.
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
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
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.
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.
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.
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
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.
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.
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.
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.
É 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.

Integração Fluig X Microsiga Protheus PDF

Enviado por

Dados do documento

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

Integração Fluig X Microsiga Protheus PDF

Enviado por

Direitos autorais:

Formatos disponíveis

Integração Fluig

1.1. Objetivos do Treinamento

É possível consultar e alimentar informações no Fluig através de um sistema

Para realizar a integração entre Fluig e Linha do Produto Microsiga

Na Linha Microsiga Protheus existe um recurso para a configuração inicial

É importante lembrar que, caso um usuário cadastrado na Linha Microsiga

A seguir, veja o passo a passo para sincronizar usuários da Linha do Produto

Para sincronizar os usuários da Linha do Produto Microsiga Protheus com o

O assistente de configuração será aberto.

Nesta tela, preencha os parâmetros para comunicação com o servidor do

Informe o endereço dos WebServices, os dados para autenticação e a

Caso ocorra algum erro de comunicação com o Fluig, uma mensagem de

A seguir, são exibidos todos os usuários presentes nos grupos de usuários

Selecione os usuários desejados para sincronizar e clique em Avançar.

É possível migrar os grupos de usuários da Linha do Produto Microsiga

Caso necessário migrar os grupos de usuários, selecione Sim para a opção

Em seguida, clique em Avançar.

Caso desejado, é possível associar um Papel cadastrado no Fluig aos

Para isso, selecione um Papel e em seguida clique em Finalizar.

Após finalizar o processo na Linha Microsiga Protheus, acesse o cadastro de

Verifique que os usuários da Linha do Produto Microsiga Protheus serão

É possível realizar integrações entre a Linha do Produto Microsiga Protheus

A Linha do Produto Microsiga Protheus disponibiliza uma página web onde é

O cadastro dos serviços disponibilizados pela Linha Microsiga Protheus é

Os serviços da Linha do Produto Microsiga Protheus adicionados ao Fluig

Para facilitar o entendimento do uso dos serviços da Linha do Produto

Observe na imagem um exemplo de implementação de como utilizar um

Para mais detalhes de como criar Datasets customizados e utilizar serviços

Na imagem é apresentado o resultado da consulta do Dataset através do

Um processo integrado é um processo do Fluig que possui integrações com

Como exemplo, será apresentado um processo de solicitação de compras

1. Uma solicitação de compras é adicionada na Linha Microsiga Protheus.

Lembre-se que este exemplo apresenta um processo simplificado, que

A seguir, ao clicar nas setas acima ou na sequência de números abaixo, veja

Para criar um processo que possui integração entre a Linha do Produto

Modele o processo conforme visto na imagem e configure suas atividades:

• Para a atividade Início:

• Para a atividade Aprovar Solicitação:

• Possuir o mecanismo de atribuição Para um Grupo.

• E para a atividade Gerar Cotações:

Após o diagrama de processo ter sido modelado e configurado, é preciso

Veja a seguir como criar esses itens.

- Caso aprovado e movimentado para a atividade Gerar Cotações, é

- Caso reprovado e movimentado para a atividade Fim Rejeitado, é

No script do evento de processo beforeCancelProcess, é chamado o método

O método setpurchaserequestapproval, disponibilizado pelo serviço,

Após executar o método, é verificado o retorno e é apresentado ao usuário

O formulário utilizado pelo processo, possui campos somente leitura para

Após modelar o processo, implementar os eventos criados e criar o

Para finalizar o processo integrado ainda é necessário realizar essas

Veja a seguir como realizar as configurações.

Verifique se os parâmetros MV_ECMWS e MV_ECMEMP estão cadastrados

Para isto, acesse o ambiente Configurador da Linha do Produto Microsiga

Por último, compile na Linha Microsiga Protheus as User Functions

User Function é uma função que permite que os usuários realizem

Veja a seguir, os códigos das User Functions necessárias.

O Ponto de entrada MT110GRV, é executado após gravar um item da

Pontos de entradas são aberturas em processos operacionais dos programas

Nesse ponto de entrada é iniciada uma nova solicitação do processo

Esta User Function é utilizada no ponto de entrada MT110GRV, para gerar

Como demonstrado anteriormente no passo 2 e 3, existem funções

As funções podem ser utilizadas no desenvolvimento de uma User Function

Na tabela são apresentadas as principais funções disponíveis: