Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

CONTEÚDO

  1. Visão Geral
  2. Incluindo as rotinas no menu
  3. Pré-requisitos
  4. Configuração
    1. Cadastros de Grupos de Tabelas
    2. Cadastros de Ponto de Integração
  5. Tela XXX
    1. Principais Campos e Parâmetros
    1. Wizard de configuração dos serviços
  6. Integração Manual
    1. Integração de Grupos de Tabelas
    2. Integração de Parâmetros
    3. Integração de Tabelas da SX5
  7. Monitor de IntegraçãoTabelas utilizadas


01. VISÃO GERAL

Visando melhorar a forma que é feita a integração dos dados entra a Retaguarda e Central PDV ou PDV, disponibilizamos a Integração TOTVS PDV.
A Integração TOTVS PDV é uma solução de integração de dados robusta e flexível projetada para facilitar a transferência eficiente de dados entre os ambientes Retaguarda e Central PDV e/ou PDV. Com sua arquitetura baseada em API REST, a Integração TOTVS PDV simplifica o processo permitindo que os ambientes Central PDV e PDV estejam atualizados conforme os dados da Retaguarda de maneira rápida e segura.  

Recursos Principais:

  1. Configuração simples e rápida: Configuração feita utilizando Wizard, com poucos cliques os serviços já estão configurados.

  2. Transferência dos dados utilizando API RESTful: Proporcionando uma conexão rápida, segura e confiável.

  3. Múltiplas threads para a baixa dos dados: Oferece a opção de configuração de várias threads, possibilitando baixar os dados de integração de mais de uma tabela de forma paralela.

  4. Monitoramento: Disponibiliza um monitor oferecendo diversos tipos de visões de monitoramento, possibilitando verificar o status de cada registro de integração, separados por ambiente.

  5. Escalabilidade e Desempenho: Arquitetura garante que a integração PDV possa lidar com grandes volumes de dados e se adaptar às necessidades do seu negócio à medida que ele cresce.

02. INCLUINDO AS ROTINAS NO MENU

Acesse o módulo Configurador, Ambiente → Cadastros → Menus, selecione o menu Controle de Lojas.

Inclua as rotinas conforme a lista abaixo:

Inclua o grupo Integração TOTVS PDV no menu Atualizações, e neste grupo, inclua as rotinas Grupos de tabelas e Ponto de Integração, e no Sub Grupo chamado Wizards inclua as rotinas Integração Manual e Configuração.

RotinaNome do fonte
Grupos de TabelasRMICADGRP
Ponto de IntegraçãoRMICADPTCG
Integração ManualRMIINTMANUALPDV
ConfiguraçãoPSHWIZCFG


Image Added


Card documentos
InformacaoIncluir as rotinas da Integração TOTVS PDV nos menus do SigaLoja da Retaguarda e Central PDV, e no menu SigaFrt do TOTVS PDV. No menu do TOTVS PDV (SigaFrt), devera ser incluído apenas a rotina PSHWIZCFG.
TituloIMPORTANTE!


03. PRÉ REQUISITOS

Para o funcionamento da Integração TOTVS PDV é necessário que as tabelas citadas a baixo abaixo estejam neste nesta configuração:

Existência das tabelas MHO, MHP, MHQ, MHR, MIP, MIN, MHP, MIQ e MIR.

Compartilhamento:


Tabela 
TabelaNomeCompartilhamento
MHOAssinantesCompartilhada
MHPAssinantes x ProcessosCompartilhada
MHQMensagens PublicadasCompartilhada
MHRMensagens DistribuiçãoCompartilhada
MIRCadastro Grupo de CargaCompartilhadaMIPExclusiva
MINExclusiva ***
MIRCompartilhada

...

Controle de PublicaçãoCompartilhada
MIPDetalhe da DistribuiçãoExclusiva



É necessário que o serviço Rest esteja ativo no server da Retaguarda que irá gerar as integrações.

Exemplo de configuração do REST

04. CONFIGURAÇÃO

a. Cadastro Grupo de Tabelas

No cadastro de Grupo de Tabelas é possível informar as tabelas que deseja gerar a integração dos dados, separando esses essas tabelas em grupos da forma que desejar.

No menu do módulo Controle de Lojas da Retaguarda, acesse o menu Atualizações → SmartHub → Integração PSV →  Integração TOTVS PDV → Grupo de Tabelas, ao acessar a tela os grupos de tabelas padrões serão criados automaticamente, as tabelas desses grupos s~~ao são as mínimas necessárias para a realização de vendas no PDV ou Central PDV.


Caso necessite, é possível alterar ou excluir os grupos padrões e criar novos grupos com as tabelas de sua preferência.

Esta tela oferece também a opção de Ativar ou Desativar o grupo, com isso, se por alguma razão haja a necessidade de cessar a geração de integração de algum grupo, é possível desativá-lo.

Image Added


Devido ao relacionamento de tabelas, não é possível deletar a tabela do grupo, mas sim desvincular a tabela desejada do grupo, para isso apague o conteúdo do campo Código Grupo na linha da tabela que necessita retirar do grupo, desativar a tabela, com isso esta tabela não fará mais parte deste grupo, e não será mais gerada Integração dos registros desta tabela, porém é possível incluir esta mesma tabela em outro grupo de sua preferência, com isso a integração voltará a ser gerada.

Image Removed

é mais gerado a integração desta tabela, e permite que esta tabela seja inclusa em outro grupo. 

Não é possível uma mesma tabela estar como ativa em mais de um grupo.

Image Added



Card documentos
InformacaoSó serão gerados
Atenção: Só será gerada
registros de Integração das tabelas
vinculadas a algum
Ativas no grupo,
tabelas não cadastradas em grupo ou desvinculadas de algum
sendo assim os grupos desativados, tabelas desativadas no grupo não terão os registros de integração gerados.
TituloIMPORTANTE!

b. Cadastro de Ponto de Integração

Ponto de Integração é qualquer outro ambiente que receberá a integração gerada pela Retaguarda, podendo ser uma Central PDV ou o próprio TOTVS PDV.

No menu do módulo Controle de Lojas da Retaguarda, acesse o menu Atualizações → SmartHub → Integração PSV TOTVS PDV → Ponto de Integração.

Também é possível desativar o Ponto de Integração, com isso, não serão mais gerados registros de Integração para este Ponto de Integração.


Card documentos
InformacaoSó serão gerados
Importante: Só será gerado
registros de Integração para os Pontos de Integração Ativos.
TituloIMPORTANTE!


c. Wizard de configuração dos

...

serviços

Este Wizard auxilia na configuração dos serviços necessários para a geração dos registros de Integração, ele é usado para configurar os serviços da Retaguarda, Central PDV e PDV.

...

No menu do módulo Controle de Lojas da Retaguarda, acesse o menu Atualizações → SmartHub Integração TOTVS PDV → Wizards → Configuração e selecione e opção Protheus Integração TOTVS PDV.


Nesta etapa, é possível escolher em qual ambiente deseja fazer a configuração. , nela temos Temos as opções de abaixo:

  • Retaguarda: Ambiente retaguarda, nesta opção serão configurados os serviços RMIPublica, RMIDistrib e RMIEnvia para a geração dos registros de integração.
  • Central PDV como Geradora de dados: Ambiente Central PDV, mas como geradora de dados, ou seja, a serão configurados também os serviços RMIPublica, RMIDistrib e RMIEnvia, para geração de dados de Integração para o PDV.
  • Central PDV como Receptora de dados: Ambiente Central PDV, como receptora de dados, nesta opção será configurado o serviço RMIIntePDV, este serviço irá fazer a comunicação via API com a Retaguarda para receber os dados de integração destinados a este Ponto de Integração, neste caso, a Central PDV.
  • TOTVS PDV: Ambiente PDV, nesta opção será configurado o serviço RMIIntePDV, este serviço irá fazer a comunicação via API com a Retaguarda para receber os dados de integração destinados a este Ponto de Integração, neste caso, o TOTVS PDV.


Configuração da Retaguarda:

Para configurar os serviços da Retaguarda, acesse a rotina pelo ambiente Retaguarda, selecione o Ambiente Retaguarda e clique em Avançar. Na tela seguinte, confirme os dados do ambiente e clique em Concluir.

Image Added


Configuração de Central PDV como Geradora de dados:

Semelhante a configuração do ambiente Retaguarda, para configurar os serviços da Central PDV como Geradora de dados, acesse a rotina pelo ambiente da Central PDV, selecione o Ambiente e clique em Avançar. Na tela seguinte, confirme os dados e clique em Concluir.

Image Added


Configuração Central PDV como Receptora de dados:

Este tipo de configuração é para quando a Central PDV for receber os dados de Integração da Retaguarda, para isto, será configurado o serviço RMIIntePDV.

Acesse a rotina pelo ambiente da Central PDV, selecione o Ambiente e clique em avançar, na tela seguinte, no lado esquerdo estão as informações do ambiente, e no lado direito estão os campos para inclusão das informações necessárias para a configuração do serviço contendo os campos:

CampoDescritivo
Código do Ponto de IntegraçãoInformar o código do Ponto de Integração cadastrado na Retaguarda que corresponde a esta Central PDV.
Usuário para acesso a API Rest

Informe um usuário do sistema que será utilizado para autenticação da API para a busca dos dados de Integração.

Por questão de segurança, aconselhamos a configurar este usuário sem acesso a nenhuma Filial e a nenhum módulo.

SenhaInformar a senha deste usuário.
EndPoint do serviço Rest

Informe o Endpoint do serviço REST ativo no server.

O EndPoint é formado pelo IP do server, porta configurada na chave HTTPREST e URL da chave HTTPURI do arquivo appserver.ini

Exemplo: 127.0.0.1:8080/REST

Grupos de Tabelas

Para informar os grupos de tabelas, acione o botão "Selecionar Grupos" e selecione os grupos desejados.

Obs: É possível criar mais de uma configuração, informando grupos de Tabelas diferentes em cada um dos serviços.

Image Added


Image Added

Configuração TOTVS PDV:

Configuração necessária para que o TOTVS PDV receba os registros de integração da Retaguarda ou da Central PDV

...

, para isto, será configurado o serviço RMIIntePDV, da mesma forma da Central PDV como Receptora de dados, é necessário informar os campo do lado direito da tela.

Acesse a rotina pelo ambiente do PDV.

Image Added

Image Added


Configurando mais de uma thread para o serviço RMIIntePDV

É possível configurar mais de uma thread do serviço RMIIntePDV, tanto na Central PDV como no TOTVS PDV, sendo que, em cada thread serão configurados grupos de tabelas diferentes, com isso, caso o usuário possua um ou mais grupos de tabelas que necessite que a busca por dados de integração seja feita em um menor tempo, é possível configurar um serviço do RMIIntePDV somente deste grupo de tabelas, com isso, por exemplo, caso o usuário configure o Grupo de Tabelas PRODUTOS em uma thread separada, quando os serviços forem inicializados, irá ser ativado uma thread buscando somente as integrações deste grupo e uma outra thread buscando as integrações dos demais grupos, desta forma, o grupo PRODUTOS não precisará respeitar a fila dos demais grupos.

Image Added



05. INTEGRAÇÃO MANUAL

No Wizard de Integração Manual é possível gerar Integrações de Grupos de Tabelas, Parâmetros e Tabelas da SX5.

Pela Retaguarda, módulo do Controle de Lojas acesse, Atualizações → Integração TOTVS PDV → Wizards → Integração Manual

a. Integração de Grupos de Tabelas

A Integração de Grupos de Tabelas gera os registros de integração das tabelas dos grupos selecionados, nela é possível selecionar a Filial o Ponto de Integração e os Grupos de Tabelas que deseja gerar os dados.

Para a geração, selecione a opção Grupos de Tabelas e avance. Na próxima tela, selecione as filiais, e na tela seguinte selecione os Pontos de Integração e os Grupos de Tabelas que deseja gerar a integração.

Image Added


Card documentos
Informacao A geração de Integração de Grupos de Tabelas irá gerar a integração de todos os dados das tabelas dos grupos, se assemelhando a carga completa da antiga rotina de Carga.
TituloIMPORTANTE!


b. Integração de Parâmetros

A Integração de Parâmetros serve para gerar a integração do conteúdo dos parâmetros informados da Retaguarda para os Pontos de Integração da Filial selecionada.

Selecione a opção Parâmetros e avance. Na próxima tela, selecione as filiais, e na tela seguinte informe os parâmetros que deseja gerar a integração.

Image Added

c. Integração de Tabelas da SX5

A Integração de Tabelas da SX5 serve para gerar a integração do conteúdo das tabelas da SX5 selecionadas do ambiente Retaguarda para os Pontos de Integração da Filial selecionada.

Selecione a opção Tabelas SX5 e avance. Na próxima tela, selecione as filiais, e na tela seguinte selecione as tabelas que deseja gerar a integração.

Image Added


06. MONITOR DE INTEGRAÇÂO

04. TELA XXXXX

Principais Campos e Parâmetros

...

Card documentos
InformacaoUse esse box para destacar informações relevantes e/ou de destaque.
TituloIMPORTANTE!

...