A - O que é o Comparador de dicionários ?
O Comparador de dicionários é uma ferramenta do VAREJO que permite realizar a comparação dos dicionários entre os ambientes da Retaguarda(Server) e os Ambientes PDVs Offlines(TOTVS PDV, FRONTLOJA).
Ao final do processo o comparador envia um e-mail com resultado da análise. Desta Forma é possível avaliar possíveis divergências entre as bases.
O Comparador pode ser executado via menu do sistema (Sem Interface) ou ainda ser programado para rodar via Schedule(Retaguarda) no horário que desejar.
B - Quais são as vantagens de usar o Comparador de dicionários ?
Com o relatório destalhado é possível saber as divergências entre as bases e providenciar a correção.
Com as bases iguais você terá mais segurança e integridade nas operações de Venda, Carga, Importação de Orçamento, Subida de Venda Etc.
C - Como Funciona ?
- O Comparador de dicionários valida as informações encontradas nas bases e envia o resultado da análise por e-mail.
- Serão sinalizadas apenas as divergências encontradas, não serão sinalizados os itens que não possuírem divergências;
- O Comparador não possui interface e o resultado da análise será apenas por e-mail.
- Caso não existam divergências será enviado um e-mail sinalizando que não houveram divergências nas bases analisadas;
- Pode ser iniciado a partir da Retaguarda ou do PDV sendo que:
- Iniciado da Retaguarda ele vai comparar a base Local x Base dos PDVs. Desta Forma todos os PDVs Serão Analisados.
- Iniciado do PDV ele vai comparar a base Local(PDV) x Base do servidor(Retaguarda). Desta forma apenas um(1) PDV é analisado.
Caso algum Host(PDVs ou Retaguarda) esteja Offline no momento da execução será adicionado uma linha informando que o Host estava Offline no momento da análise.
Atenção: As divergências apenas serão sinalizadas, o comparador não corrige/ajusta/altera os dicionários.
Você deverá providencia as correções conforme sua necessidade.
D - O que é avaliado na comparação ?
As seguintes tabelas serão analisadas:
SL1, SL2, SL4, SFI, SB1,
SB0, DA0, DA1, SBI, SLK,
SA1, SA3, SAE, SE4, SF4,
SF7, SA6, SLF ,SLG.
Essas tabelas terão as seguintes informações avaliadas:
- Compartilhamento das tabelas(SX2) para os Campos:
X2_MODO, X2_MODOUN, X2_MODOEMP.
- Divergência das informações(PDV x Retaguarda) encontradas nos campos:
X3_TIPO, X3_TAMANHO, X3_DECIMAL, X3_PICTURE,
X3_VALID, X3_VLDUSER, X3_USADO, X3_RELACAO, X3_CBOX.
- Falta dos Campos em comparação PDV x Retaguarda.
- A comparação é realizada para Empresa e Filial logada.
E - Quais PDVs ou Hosts serão analisados?
- Serão analisados os PDVs/Hosts que estiverem cadastrados corretamente no "Cadastro do Processo Offline".
Mais detalhes ver item 1.4. abaixo.
F - O que "NÂO" está contemplado no comparador de Dicionários ?
Funcionalidades que NÃO serão atendidas:
- IP dinâmico no PDV quando executado da Retaguarda;
- IP dinâmico na Retaguarda quando executado do PDV;
- Alteração/ajuste de dicionário;
- Validação de tabelas diferentes das descritas no Item D;
- Validação de estruturas de campos diferentes dos descritos no Item D;
- Tela de visualização da análise;
- Geração de arquivo com resultado da análise;
- Comparação Multi-Empresa e Multi-Filial na mesma execução.
G - Quais são suas principais rotinas?
Comparador de dicionários (STFCompDic): Rotina principal responsável pela análise;
Teste de E-mail (STFMailTes): Rotina auxiliar para teste do processo de envio de e-mail;
H - Exite alguma limitação para executar a rotina?
- Se executado na Retaguarda os PDVs devem possuir IP Fixo.
- Se executado no PDV a Retaguarda(Server) devem possuir IP Fixo.
- O E-mail será limitado ao tamanho máximo de string configurado do Protheus, se ultrapassar será enviado apenas o conteúdo até o momento que atingir o limite.
para mais informações sobre limite de string veja a FAQ abaixo:
Seção [general], chave MaxStringSize
I - Pré-requisitos
Todos os ambientes envolvidos(PDVs e Retaguarda) devem ter:
- IP e Portas RPC liberadas para acesso interno e externo no Firewall.
- Obter sempre as últimas versões do Binário e Lib.
- Se executado na Retaguarda os PDVs devem possuir IP Fixo.
- Se executado no PDV a Retaguarda(Server) devem possuir IP Fixo.
- Obter sempre as últimas versões do Binário e Lib.
J - Qualquer usuário pode executar a rotina?
A rotina não realiza validação de usuário podendo ser executada por qualquer usuário(Administrador, Caixa etc.) com acesso ao menu.
k - Não consigo enviar e-mail o que fazer?
- Para alguns servidores de SMTP é necessário informar a porta junto ao endereço. Ex: smtp.suaempresa.com.br:587
- Realize o teste com a opção "Servidor requer autenticação" = Não
Veja detalhes de configuração nos Links do Item 1.5 abaixo.
COMO CONFIGURAR ?
1- Como Configurar o Comparador de dicionários ?
1.1 Aplicar Pacote(Patch) em todos PDVs e na Retaguarda;
1.2 - Criar/Configurar parâmetro MV_LJMMAIL no ambiente que será executado a rotina principal;
1.2 1 - No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/Configure o parâmetro(s) a seguir;
Itens/Pastas | Descrição |
---|
Nome: | MV_LJMMAIL |
Tipo: | C |
Cont. Por.: | [email protected];email2@suaempresa.com |
Descrição: | Email do Responsavel pela analise de vendas encontradas pelo Monitor de PDVs pode separar por ponto e virgula para mais de um email |
No conteúdo do parâmetro informe os e-mails dos interessados na analise do comparador de dicionários. Separar com ponto e virgula ";"
1.3 - No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do SIGALOJA ou SIGAFRT, conforme instruções a seguir:
Menu | Atualizações |
---|
Submenu | "Off-Line/Integração" ou "Atualizações/Retaguarda" ** |
Nome da Rotina | E-mail Teste |
Programa | STFMailTes |
Módulo | SIGALOJA ou SIGAFRT *** |
Tipo | 1 |
Menu | Atualizações |
---|
Submenu | "Off-Line/Integração" ou "Atualizações/Retaguarda" ** |
Nome da Rotina | Comp. Dicionários |
Programa | STFCompDic |
Módulo | SIGALOJA ou SIGAFRT *** |
Tipo | 1 |
** O Submenu deverá ser de acordo com o Ambiente em que a rotina será executada se SIGALOJA = "Off-Line/Integração" se SIGAFRT = "Atualizações/Retaguarda".
*** O Módulo deverá ser de acordo com o Ambiente em que a rotina será executada se SIGALOJA ou SIGAFRT.
1.4. - O comparador de dicionários utiliza as configurações do "Processo Offline" para efetuar a comunicação entre os Hosts.
Cadastre ou Revise as Configuração de Ambiente(MD4) e Comunicação de ambientes(MD3).
Você deverá se certificar que o IP, porta e ambiente de todos os PDVs estão corretos.
Para saber detalhes de Como Configurar o Processo Offline veja a FAQ abaixo:
SIGAFRT_SIGALOJA_0435_Como cadastrar Ambiente e comunicação para processo Offline?
Atenção, Para executar a rotina diretamente do PDV é preciso antes realizar uma Carga das tabelas "Configuração de Ambiente"(MD4) e "Comunicação de ambientes"(MD3).
Desta forma o PDV recebe as configurações de comunicação da retaguarda para conseguir realizar a conexão.
1.5 - Realize as configurações gerais de e-mail do Protheus em SIGACFG(Ambiente/E-mail-Proxy/Configurar) no ambiente que será executado a rotina principal;.
Exemplo:
Caso tenha dificuldades para configurar o e-mail verifique mais detalhes na FAQ abaixo:
Como configurar o envio de e-mail
SIGAFRT_SIGALOJA_0433_Como configurar e-mail para o monitor de PDVs?
Atenção: Verifique corretamente as configurações de e-mail com a equipe de TI de sua empresa.
Para alguns servidores de SMTP é necessário informar a porta junto ao endereço. Ex: smtp.suaempresa.com.br:587
1.6 -Teste de envio de email:
1.6.1 - Se SIGALOJA Entre opção “Atualizações\Off-line\Integração\E-mail Teste” (STFMailTes)";
Se SIGAFRT Entre opção “Atualizações\Retaguarda\E-mail Teste” (STFMailTes)";
1.6.2 - Informe o destinatário do e-mail de testes e clique em "Enviar E-mail".
1.6.3 - Caso o e-mail seja enviado com sucesso você receberá uma mensagem "E-mail enviado com sucesso";
1.6.4 - Caso o e-mail não seja enviado você receberá uma mensagem com detalhes do erro para providenciar a configuração;
1.6.5 - Após conseguir enviar o e-mail de testes Feche as janelas para encerrar.
COMO EXECUTAR ?
2- Como executar o Comparador de dicionários ?
2.1 - Se SIGALOJA Entre opção “Atualizações\Off-line\Integração\Comp. Dicionários” (STFCompDic)" ou
se SIGAFRT Entre opção “Atualizações\Retaguarda\Comp. Dicionários” (STFCompDic)";
2.2 - Será apresentada uma janela informando que o comparador será executado em segundo plano(Outra thread) e que o resultado será enviado ao e-mail cadastrado:
2.3 - Clique em "Sim" para Continuar;
2.4 - Será apresentada uma janela informando que o processo foi iniciado com sucesso. Feche a janela;
2.5 - Neste Momento o Comparador de dicionários está sendo executado em segundo plano. Ao Final do processo será enviado o e-mail com análise das informações.
Você pode executar outras rotinas enquanto o monitor esta sendo executado.
2.6 - Analisando o Resultado recebido por e-mail;
Você receberá um e-mail parecido com o exemplo abaixo com as divergências encontradas.
Caso julgar necessário realize a correção dos campos, pois o monitor apenas informa as divergências.
Atenção, Nem todas as diferenças indicam erro. Em alguns casos o sistema pode trabalhar com versões diferentes de bases para PDV e Retaguarda.
3 - Como analisar a execução da rotina?
3.1 - Em casos de dificuldade ou implantação da rotina pode-se utilizar o LOGLOJA que mostra passo a passo do processo para acompanhamento:
Para Habilitar o LOGLOJA verifique a FAQ abaixo:
SIGALOJA_0011_Como habilitar a geração de LOG nas rotinas do módulo de Varejo?
3.2 - A rotina Grava o Log com a tag "Comparador_Bases". Veja um pequeno exemplo de log da rotina: