Linha Microsiga Protheus

Árvore de páginas

Como configurar e usar o Comparador de dicionários

Produto:

Protheus

Versões:

11.80, 12.1.14 ou Superior

Ambiente:

SIGALOJA , SIGAFRT

Passo a passo:

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:

MenuAtualizações
Submenu"Off-Line/Integração" ou "Atualizações/Retaguarda" **
Nome da RotinaE-mail Teste
ProgramaSTFMailTes
MóduloSIGALOJA ou SIGAFRT ***
Tipo1
MenuAtualizações
Submenu"Off-Line/Integração" ou "Atualizações/Retaguarda" **
Nome da RotinaComp. Dicionários
ProgramaSTFCompDic
MóduloSIGALOJA ou SIGAFRT ***
Tipo1

 

** 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: