Histórico da Página
- Visão Geral
- Incluindo as rotinas no menu
- Pré-requisitos
- Configuração
- Cadastros de Grupos de Tabelas
- Cadastros de Ponto de Integração
- Wizard de configuração dos serviços
- Cadastros de Grupos de Tabelas
- Integração Manual
- Integração de Grupos de Tabelas
- Integração de Parâmetros
- Integração de Tabelas da SX5
- Integração de Grupos de Tabelas
- Monitor de Integração
Índice maxLevel 1
01. VISÃO GERAL
Aviso | ||
---|---|---|
| ||
Esta solução esta em desenvolvimento e, por isso, ainda não esta disponível para uso! |
Visando melhorar a forma que é feita a integração dos dados entre a Retaguarda, Central PDV e 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, 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.
...
Existência das tabelas MHO, MHP, MHQ, MHR, MIP, MIN, MHP, MIQ e MIR.
...
Tabela | Nome | Compartilhamento |
---|---|---|
MHO | Assinantes | Compartilhada |
MHP | Assinantes x Processos | Compartilhada |
MHQ | Mensagens Publicadas | Compartilhada |
MHR | Mensagens Distribuição | Compartilhada |
MIR | Cadastro Grupo de Carga | Compartilhada |
MIN | Controle de Publicação | Compartilhada |
MIP | Detalhe da Distribuição | Exclusiva |
...
No módulo Controle de Lojas da Retaguarda, acesse o menu Atualizações → Integração TOTVS PDV → Grupo de Tabelas, ao acessar a tela pela primeira vez será apresentado a mensagem perguntando se deseja que sejam criados automaticamente os grupos de tabelas padrões, caso escolha por criar, serão criados automaticamente, alguns grupos com as tabelas desses grupos são as mínimas necessárias para a realização de vendas no PDV ou Central PDV.
...
IMPORTANTE!
Só serão gerados registros de Integração das tabelas Ativas no grupo, sendo assim os grupos desativados , e tabelas desativadas no grupo não terão os registros de integração gerados.
...
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
[OnStart] Jobs=RMIPUBLICA_1 RefreshRate=5 [RMIPUBLICA_1] Main=RmiPublica Environment=NOME DO AMBIENTE nParms=6 Parm1=CODIGO DA EMPRESA Parm2=CODIGOCPDIGO DA FILIAL Parm3=1 Parm4=10:00:00 Parm5=2 Parm6=CÓDIGO DOS GRUPOS |
O serviço JOB RMIPublica é responsável por ler as tabelas de dados dos grupos e publicar os registros em formato JSON. Essa publicação ocorre sempre que há uma alteração nos registros das tabelas. Os registros em formato JSON são então gravados na tabela MHQ.
IMPORTANTE!
O parâmetro nParm5 devera estar configurado com o valor 2
O parâmetro nParm6 devera ser informado o código dos grupo grupos separado por virgula, exemplo: 001,002. Se achar necessário, pode criar outra chave (RMIPUBLICA_2) e informar outros grupos, com isso o ambiente tera terá em execução 1 ou mais threads do RMIPublica executando por grupos específicossimultaneamente sem que aja concorrência.
RMIEnviaPdv
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.
...
Abra o Appserver.ini e configure o JOB conforme o exemplo abaixo:
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
[OnStart]
Jobs=RMIENVIAPDV_1
RefreshRate=5
[RMIENVIAPDV_1]
Main=RmiEnviaPdv
Environment=NOME DO AMBIENTE
nParms=4
Parm1=CODIGO DA EMPRESA
Parm2=CODIGO DA FILIAL
Parm3=10:00:00
Parm4=CÓDIGO DOS GRUPOS |
O serviço RMIEnviaPdv tem como objetivo ler os registros da tabela MHQ onde o campo MHQ_STATUS é igual a 1 e endereçar cada registro para os respectivos pontos de integração. O endereçamento é feito com base nas regras de compartilhamento definidas em cada tabela, exemplo, se um determinado produto é da filial 01 portanto somente os pontos de integração que pertencem a filial 01 é que irão receber esses registros.
O RMIEnviaPdv grava os registros na tabela MIP com o campo MIP_STATUS igual a 1 e posteriormente esses registros são enviados aos ambientes da Central de PDV e o TOTVS PDV.
Status que são gravados na tabela MIP:
Status | Descrição |
---|---|
1 | Aguardando para ser integrado |
6 | Registro enviado a Central de PDV ou TOTVS PDV |
2 | Integrado com sucesso |
3 | Erro na integração do registro |
07. CONFIGURAÇÃO DA CENTRAL DE PDV E DO TOTVS PDV
No AppServer.ini da Central de PDV e do TOTVS PDV devemos agora configurar o JOB RMIIntePdv, esse é o serviço responsável de fazer as buscas dos dados na Retaguarda para serem gravados na base local da Central de PDV e no TOTVS PDV.
Esse JOB apenas busca os registros cujo o campo MIP_STATUS na retaguarda seja igual a 1.
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
[OnStart]
Jobs=IntegracaoPdv_1
RefreshRate=5
[IntegracaoPdv_1]
Main=RmiIntePdv
Environment=NOME DO AMBIENTE
nParms=6
Parm1=CODIGO DA EMPRESA
Parm2=CODIGO DA FILIAL
Parm3=CODIGO DO PONTE DE INTEGRAÇÃO
Parm4=CODIGO DO GRUPO
Parm5=CONFIGURE 1 PARA ATIVAR O LOG OU 0 PARA DESATIVAR
Parm6=10:00:00 |
Observações:
- Parm3: Deve ser informado o código do ponto de integração que foi cadastrado para essa filial, cada estação devera ter o seu ponto de integração cadastrado não podendo ser o mesmo código para varias estações;
- Parm4: Devera ser informado um ou mais código de grupos separado por virgula. Para se ter uma melhor performance e exclusividade em determinado grupo, a recomendação é separar esse grupo em uma chave exclusiva do RmiIntePdv e informar essa nova chave no [OnStart];
- Parm6: Deve-se informar o tempo que a thread permanecera ativa na memoria do server, quando não informado esse parâmetro o tempo default é de apenas 5 minutos.
08
...
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.
...
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
...
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.
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.
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.
...
. 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.
...
...
IMPORTANTE!
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.
...
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.
...
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.
...
09. ATUALIZAÇÃO DE SENHAS
DT Função para atualização de senhas de usuário
IMPORTANTE!
Programar a rotina de senhas para ser executada no período em que não tenha nenhum usuário logado no ambiente Central de PDV ou TOTVS PDV.
10. MONITOR DE INTEGRAÇÃO
Monitor da Integração de Dados do TOTVS PDV