Dica!
Nesta etapa, ao clicar em avançar serão criados os serviços necessários para o funcionamento da integração do Protheus SmartHub, eles são responsáveis por publicar, distribuir e enviar os dados de origem do Protheus para o PDV Omni.
Os campos na tela já vem pré-preenchidos com os dados do servidor Protheus que você está conectado. Porém, caso seja necessário realizar a instalação destes serviços em um servidor remoto (em casos de balanceamento de carga, por exemplo), você pode editar as informações de Empresa e Filial de execução , IP , Porta e Ambiente do serviço.
Importante
Consulte o Administrador do servidor Protheus da sua organização caso deseje alterar os campos em tela.
Aviso
Não será gravado o serviço LJGRVBATCH nesta execução, pois o mesmo não é exclusivo da integração do Protheus SmartHub. Recomenda-se que se caso não haja o job cadastrado, seja realizado sua configuração manualmente.
Como demostrado abaixo, ao clicar em avançar, os Jobs de integração são criados no arquivo .ini do Appserver informado.
A seguir está o detalhamento dos serviços que são criados automaticamente do Wizard :
Serviços SmartHub :
Dica!
Para o funcionamento correto do RMI é imprescindível realizar a Criação/Configuração dos serviços listados abaixo:
Importante!
- Para o correto funcionamento da integração como Pré requisito é necessário obter a Licença do Módulo 12 (Controle de Lojas).
Os serviços RMIENVIA e RMIBUSCA consomem licença do Módulo 12 (Controle de Lojas) por thread. - A chave CanRunJobs no appserver.ini, não deve está configurada. Porque, caso esteja pode forçar a não execução dos jobs.
Para maiores detalhes, acesse: CanRunJobs
RMIPUBLICA
Dica!
Este serviço é responsável por gravar as Mensagens Publicadas. Este serviço é responsável pela geração e publicação das mensagens dos processos cadastrados.
Neste serviço serão utilizadas as seguintes tabelas:
- MHN - Processos
- MHS - Tabelas Secundarias
- MHP - Assinantes x Processos
- MHQ - Mensagens Publicadas
- No arquvio AppServer.ini informe as TAG's a baixo:
Parâmetro | Descrição | Obrigatório | Default |
---|---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x | |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x | |
nParms | Número de parâmetros necessários | x | |
nParm1 | Código da empresa para inicializar o serviço | x | |
nParm2 | Código da Filial para inicializar o serviço | x | |
nParm3 | Define o controle de publicação 0 = MSEXP, 1 = S_T_A_M_P | x | 1 |
nParm4 | Define o tempo que o serviço ficará on-line até ser encerrado | 00:05:00 | |
nParm5 | Tipo do Filtro: 1=Processo e 2=Grupo | 1 | |
nParm6 | Filtro que será aplicado, dependendo do pârametro nParm5 |
Exemplo:
[RMIPUBLICA] Main=RmiPublica Environment=SEU_AMBIENTE nParms=6 Parm1=CODIGO_EMPRESA Parm2=CODIGO_FILIAL Parm3=1 Parm4=00:05:00 Parm5=1 Parm6=PRODUTO,CLIENTE
- No exemplo acima, o serviço de Publicação terá o tipo do filtro por Processo e serão processados, PRODUTO e CLIENTE.
RMIDISTRIB
Dica!
Este serviço é responsável pela distribuição das mensagens publicadas para os Assinantes, de acordo com o cadastro de Assinantes x Processos.
Neste serviço serão utilizadas as seguintes tabelas:
- MHP - Assinantes x Processos
- MHQ - Mensagens Publicadas
- MHR - Mensagens Distribuídas
- No arquvio AppServer.ini informe as TAG's a baixo:
Parâmetro | Descrição | Obrigatório | Default |
---|---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x | |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x | |
nParms | Número de parâmetros necessários | x | |
nParm1 | Código da empresa para inicializar o serviço | x | |
nParm2 | Código da Filial para inicializar o serviço | x | |
nParm3 | Define o tempo que o serviço ficará on-line até ser encerrado | 00:05:00 | |
nParm4 | Tipo do Filtro: 1=Processo e 2=Grupo | 1 | |
nParm5 | Filtro que será aplicado, dependendo do pârametro nParm4 |
Exemplo:
[RMIDISTRIB] Main=RmiDistrib Environment=SEU_AMBIENTE nParms=5 Parm1=CODIGO_EMPRESA Parm2=CODIGO_FILIAL Parm3=00:05:00 Parm4=2 Parm5=001,002
- Neste exemplo, o serviço de Distribuição terá o tipo do filtro por Grupo e serão processados os grupos, 001 e 002.
RMIENVIA
Dica!
Este serviço é responsável por enviar as mensagens distribuídas aos seus assinantes, caso o processo vinculado ao assinante esteja com o campo Tipo Processo igual a: Envio.
Neste serviço serão utilizadas as seguintes tabelas:
- MHP - Assinantes x Processos
- MHQ - Mensagens Publicadas
- MHR - Mensagens Distribuídas
- No arquvio AppServer.ini informe as TAG's à baixo:
Parâmetro | Descrição | Obrigatório | Default |
---|---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x | |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x | |
nParms | Número de parâmetros necessários | x | |
nParm1 | Código da empresa para inicializar o serviço | x | |
nParm2 | Código da Filial para inicializar o serviço | x | |
nParm3 | Define o tempo que o serviço ficará on-line até ser encerrado | 00:05:00 | |
nParm4 | Tipo do Filtro: 1=Processo e 2=Grupo | 1 | |
nParm5 | Filtro que será aplicado, dependendo do pârametro nParm4 |
Exemplo:
[RMIENVIA] Main=RmiEnvia Environment=SEU_AMBIENTE nParms=5 Parm1=CODIGO_EMPRESA Parm2=CODIGO_FILIAL Parm3=00:05:00 Parm4= Parm5=
- Neste exemplo, como não foram informados os parâmetros 4 e 5 o processamento será feito, como base no default de cada parâmetro.
Serão executados todos os processos ativos para envio, na tabela de Assinante x Processos (MHP).
RMIBUSCA
Dica!
Este serviço é responsável por realizar a conexão e obter as informações referente ao processo vinculado no assinante, caso o processo vinculado ao assinante esteja com o campo Tipo Processo igual a: Busca.
Neste serviço serão utilizadas as seguintes tabelas:
- MHP - Assinantes x Processos
- MHQ - Mensagens Publicadas
- No arquvio AppServer.ini informe as TAG's a baixo:
Parâmetro | Descrição | Obrigatório |
---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x |
nParms | Número de parâmetros necessários | x |
nParm1 | Código da empresa para inicializar o serviço | x |
nParm2 | Código da Filial para inicializar o serviço | x |
Exemplo:
[RMIBUSCA] Main=RmiBusca Environment=SEU_AMBIENTE nParms=2 Parm1=CODIGO_EMPRESA Parm2=CODIGO_FILIAL
RMICONTROL
Dica!
Este serviço é exclusivo para realizar as validações das vendas integradas ao Protheus.
Neste serviço serão utilizadas as seguintes tabelas:
- MHQ - Mensagens Publicadas
- SL1 - Orçamento
- SL2 - Itens do Orçamento
- SL4 - Condição negociada
- No arquvio AppServer.ini informe as TAG's a baixo:
Parâmetro | Descrição | Obrigatório |
---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x |
nParms | Número de parâmetros necessários | x |
nParm1 | Tipo de processamento a ser realizado | x |
nParm2 | Código da empresa para inicializar o serviço | x |
nParm3 | Código da Filial para inicializar o serviço | x |
Exemplo:
[RMI] Main=RmiControl Environment=SEU_AMBIENTE nParms=3 Parm1=CUPOM Parm2=CODIGO_EMPRESA Parm3=CODIGO_FILIAL
GRAVABATCH
Dica!
O que é o GravaBtach e por que preciso configura-lo?
O GravaBatch é um serviço de extrema importância pois é responsável pelo processamento da venda(gera financeiro/Baixa de estoque, geração de Pedido/Livros fiscais etc.).
Este serviço deve ser configurado para as filiais utilizadas na integração.
Este serviço deve ser configurado no seu appserver.ini, abaixo o exemplo de configuração
Parâmetro | Descrição | Obrigatório |
---|---|---|
Main | Nome da rotina responsável pela inicialização do serviço | x |
Environment | Nome do ambiente Protheus que será inicializado o serviço | x |
nParms | Número de parâmetros necessários | x |
nParm1 | Tipo de processamento a ser realizado | x |
nParm2 | Código da empresa para inicializar o serviço | x |
nParm3 | Código da Filial para inicializar o serviço | x |
Exemplo:
[Integracao_ERP] Main=LJGRVBATCH Environment=SEU_AMBIENTE nParms=2 Parm1=_CODIGO_EMPRESA Parm2=CODIGO_FILIAL
GravaBatch
Para maiores detalhes da configuração do serviço acesse: Detalhes GravaBatch
ONSTART
OnStart
Após realizar a configuração dos serviços acima, para que os serviços sejam executados é necessário inclui-los na sessão OnStart do arquivo AppServer.ini, como mostra a imagem abaixo:
[ONSTART] JOBS=RMIPUBLICA,RMIDISTRIB,RMIENVIA,RMIBUSCA,RMI,Integracao_ERP REFRESHRATE=120
Log's
Todos os serviços listados acima possuem um log que indica que foi iniciado, isso ajuda na analise de possíveis falhas na execução, seja por configuração incorreta ou ate mesmo pela falta de configuração.
Exemplo:
Obs: esta informação é apresentada no console.log
Próximo passo!
Ao avançar, vamos para a etapa de Confirmação