01. VISÃO GERAL

Com o objetivo de facilitar a configuração inicial da rotina de conciliação, foi desenvolvido um wizard que auxiliará na adequação das estruturas das tabelas utilizadas nesse processo.

Além disso, esta ferramenta também possibilitará a carga inicial dos novos dados nos registros já gravados do sistema (registros legados), dessa forma, será possível utilizar a rotina de conciliação nos dados antigos do PROTHEUS.

Este WIZARD é uma ferramenta de implementação e configuração do ambiente para o Conciliador, não é necessário executa-lo previamente todas as vezes em que for utilizado o Conciliador Backoffice.

02. PRIMEIROS PASSOS

Para utilizar o wizard de configuração, são necessários alguns pré-requisitos:

02.01. FONTES COMPILADOS

Arquivos CTBA930.PRW, CTBA930a.PRW, CTBA930b.PRW, CTBA930c.PRW e CTBA930d.PRW compilados no repositório de objetos.

02.02. DICIONÁRIO DE DADOS

Baixar o pacote de atualização de dicionários necessários para implementação do Conciliador e executar o UPDDISTR. O pacote de dicionário deverá criar em seu banco de dados as tabelas QLB, QLC e QLC, além de incluír os campos CV3_IDORIG e CV3_IDDEST na tabela já existente CV3.

02.03. DBACCESS E LIB

O Conciliador irá utilizar campos do tipo "Unique Identifier" ou "UUID" para relacionar um registro conciliado a outro em diferentes tabelas, para lidar com esses tipos de campos, são necessárias versões de DBAccess e Lib possam lidar com este tipo de campo.

• 
  
  • A versão mínima de DBAccess deve ser a versão 21.1.1.8.
    Para conferir a versão de seu DBAccess, acesse o DBMonitor. A versão fica na aba 'Informações'
    
    

• 
  
  • A versão mínima de Lib deve ser a versão 20220725.
    Para conferir sua versão de Lib atual, abra o Protheus e acesse o menu Ajuda>Sobre.
    

02.04. POSTGRESQL

Caso esteja utilizando banco de dados Postgres confira se sua fonte de dados ODBC está configurada corretamente conforme a documentação:

É necessário habilitar a chave chave MemoInQuery no DBAccess.ini

• 
  
  • 
    Essas configurações são essenciais para o correto funcionamento do Conciliador em ambientes que utilizam banco de dados PostgreSQL.

02.05. CARREGAR CONFIGURAÇÕES DE MATCH

Para carregar as configurações de match, basta acessar a rotina Conciliador Backoffice (CTBA940) em seu menu Protheus, ao acessar a rotina serão carregadas as Configurações de Match padrões do sistema na tabela QLB. Este carregamento também servirá para que os usuários recebam as atualizações nas configurações padrões.

Estas configurações padrões servirão de base para os usuários criem suas próprias configurações personalizadas.

03. EXECUÇÃO DA ROTINA

Antes de executar o Wizard, ative o parâmetro MV_PRJOVER preenchendo o seu conteúdo com '.T.' nos grupos de empresa que deseja utilizar, conforme o exemplo abaixo.

Com este parâmetro ativado, será possível a inclusão de campos de identificação única nas tabelas que serão conciliadas

Para utilizar o Wizard de Configurações, nos parâmetros iniciais do sistema, deve ser informado o programa inicial: WIZARDUUID.

04. APRESENTAÇÃO

Ao confirmar a tela anterior, será exibida a tela de apresentação do Wizard:

Por motivos de segurança do ambiente, apenas o usuário administrador pode acessa-lo. Após informar a senha, clique em 'Avançar'

Selecione o grupos de empresas que deseja utilizar no processamento e clique em 'Avançar'

05. OPÇÕES NO WIZARD

Após a tela de abertura serão exibidas as opções disponíveis para processamento.

Serão três opções para auxiliar a configuração inicial da base de dados para o uso do conciliador.

Siga todas as etapas disponíveis do Wizard de acordo com a sequência apresentada no momento de implantação, não pule etapas para que não ocorram erros no processo.

Após ter realizado seu primeiro acesso a rotina Conciliador Backoffice para o carregamento das configurações de match, siga a sequencia:

1º - Gerar SDF com os campos de ID
2º - Popular os campos de ID
3º - Popular Rastreamento Contábil

05.01. GERAR SDF COM CAMPOS DE ID

O objetivo da opção Gerar SDF com campos de ID é facilitar a criação dos campos de ID necessários para utilização do conciliador.

01. RESUMO

Esta opção fará a leitura das configurações contidas na tabela QLB e, com as tabelas de origem e destino encontradas, fará a sugestão para criação dos campos XXX_MSUIDT, onde XXX representa o código da tabela utilizada na conciliação.

Esta opção não irá criar os campos no banco, ela ira gerar um arquivo SDF na pasta \systemload\ para posterior execução do UPDDISTR.

02. GERANDO SDF

Escolher a opção "Gerar SDF com campos de ID" e clicar no botão Avançar.

Será exibida a tela de apresentação da opção selecionada:

Ao clicar em avançar, o sistema fará a leitura das tabelas de origem e destino cadastradas da tabela QLB (Configurações de Match). Será sugerida a criação dos campos XXX_MSUIDT dessas tabelas (onde XXX é o código da tabela encontrada).

Os campos já existentes na base de dados ficarão com o STATUS "OK" e não serão exportados para o SDF.

Os campos não encontrados, ficarão com o STATUS "Incluir" e serão exportados para o arquivo SDF.

Campos que serão criados com base nas tabelas encontradas no cadastro da QLB:

Clique em avançar para exportar o arquivo SDF para a pasta systemload:
Caso já exista um arquivo diferencial nessa pasta, o sistema perguntará se deve sobrescrevê-lo.

Exemplo de arquivo criado na pasta systemload.

Evidência do arquivo manifest_update com os detalhes do arquivo SDF gerado pela ferramenta.

Após confirmar a gravação do arquivo, o Wizard exibe a mensagem de SDF exportado com sucesso:

Clicando no botão finalizar desta opção, o sistema pergunta se deseja executar o UPDDISTR para criação dos campos:

Se clicar em Sim, o sistema redirecionará para execução do UPDDISTR

Se clicar em Não, o sistema finalizará esta etapa.

Ao finalizar esta etapa do Wizard, a mensagem de Processamento Finalizado é exibida:

05.02. POPULAR OS CAMPOS DE ID

O objetivo da opção Popular os campos de ID é preencher o código de ID único nos registros já gravados do sistema.

01. RESUMO

O objetivo da opção Popular os campos de ID é preencher o código de ID único nos registros já existentes do sistema. Essa opção é importante para que seja possível a utilização do conciliador nos registros do legado. 

Como os campos são novos, no momento da instalação/configuração da rotina eles estarão sem conteúdo.

02. PREENCHENDO OS IDS

Escolher a opção Popular os campos de ID e clicar no botão Avançar:

Será exibida a tela de apresentação da opção selecionada. No caso desta opção, será exibido um range de datas. 

Esse range representa o período retroativo que se deseja gravar os códigos de ID nos campos XXX_MSUIDT

Após clicar em avançar, o sistema exibira a tela com os campos que serão gravados "XXX_MSUIDT".

Além disso, também serão exibidos os campos que serão utilizados na comparação do range de datas para filtrar os registros.

Os campos utilizados para fazer o filtro podem ser editados pelo usuário.

Clicando duas vezes em cima do campo é exibida uma tela com os campos data disponíveis para alteração.

Após a confirmação das tabelas selecionadas, o wizard realizará a gravação dos campos de ID

Campos gravados após processamento da rotina:

Após o processamento da opção, a mensagem de Processamento Finalizado é exibida.

Ao confirmar, o wizard retornará ao menu de opções.

05.03. POPULAR RASTREAMENTO CONTABIL

A última opção do Wizard é específica para o módulo contábil e não seria possível conciliar os dados contábeis do legado sem esse tratamento.

01. RESUMO

O objetivo da opção Popular Rastreamento Contábil é ser um facilitador da conciliação dos registros já gravados do rastreamento contábil (Tabela CV3), com os códigos UUID. Com este facilitador será possível que os registros do legado sejam conciliados de forma automática, sem a necessidade de conciliações manuais.

Neste passo, os registros das tabelas de origem e de destino (SE1 e CT2, por exemplo) já devem possuir os códigos MSUIDT preenchidos nos registros. O sistema fará a leitura da tabela de rastreamento contábil (CV3) e gravará nos campos CV3_IDORIG e CV3_IDDEST os ID's dos registros de origem e destino (SE1 e CT2, por exemplo). Como os campos são novos, no momento da instalação/configuração da rotina eles estarão em branco.

Dessa forma, será possível fazer a ligação entre a tabela de lançamentos contábeis com as tabelas dos módulos de origem.

Para este rastreamento, a busca de dados será feita conforme o Tracker Contábil do Protheus. Para identificar o registro de origem e o destino serão tomados como base os campos CV3_RECORI e CV3_RECDES que guardam os RECNOS (Posição do(s) registros nas tabelas do Protheus) dos registros que contidos nas tabelas de origem e na tabela de contabilização (CT2 - Lançamentos contábeis), sendo assim, uma premissa para realizar o rastreamento contábil por meio deste facilitador dos campos, é que os campos que guardam os RECNOs estejam integros e reflitam a realidade das tabelas de origem e a tabela CT2

02. POPULANDO RASTREAMENTO CONTÁBIL

Escolher a opção Popular Rastreamento Contábil:

Será exibida a tela de apresentação da opção selecionada.

No caso desta opção, será exibido um range de datas. 

Esse range representa o período retroativo que se deseja gravar os códigos de ID nos campos da tabela CV3-Rastreamento Contábil.

Após clicar em avançar, o sistema exibirá os campos "XXX_MSUIDT" das tabelas que possuem configurações de match cadastradas com a tabela de lançamentos contábeis CT2.

Selecione os tabelas/Empresas que deseja processar e clique em Finalizar.

Após selecionar as tabelas/empresas, será exibida uma mensagem de confirmação informando como será realizado o preenchimento do rastreamento contábil.

Para continuar basta apenas confirmar.

O sistema fará a gravação dos campos CV3_IDORIG com os dados da tabela de origem (SE1, por exemplo) e CV3_IDDEST com os dados da tabela de destino CT2 - Lançamentos contábeis.

Após o processamento da opção, a mensagem de Processamento Finalizado é exibida:

Ao finalizar o wizard retorna ao menu de opções.

03. COMO FUNCIONA A BUSCA DE REGISTROS ENTRE AS TABELAS? (EXEMPLO DE RASTREAMENTO)

Para exemplificar, serão utilizados estes dois registros abaixo na tabela CV3.
São dois registros de contabilização (uma partida a débito e uma partida a crédito) de um titulo a receber (SE1), ou seja, 1 registro na tabela SE1 para 2 registros na tabela CT2.
Como pode ser visto, ambos estão com os campos CV3_IDORIG e CV3_IDDEST em branco.

Para encontrar o registro de origem, o wizard ira procurar na tabela contida no campo CV3_TABORI, os registros com que possuem os R_E_C_N_Os contidos nos campos CV3_RECORI.
No exemplo, na tabela SE1 será procurado o registro de R_E_C_N_O 10903.

Para encontrar os registros de contabilização, o wizard ira procurar na tabela CT2 os registros que possuem os R_E_C_N_Os contidos nos campos CV3_RECDES.
No exemplo, será procurado os registros de R_E_C_N_Os 25709 e 25714.

Encontrando o registro na origem, é possível ver que o título a receber já possui seu código de identificação única no campo E1_MSUIDT.

O mesmo ocorre com os registros na CT2_MSUIDT.

Sendo possível encontrar os registros de origem e destino da contabilização, utilizando o facilitador de Rastreamento contábil do WIZARDUUID, o sistema poderá rastrear de forma correta e gravar na tabela CV3 os campos de ID de origem e ID de destino.

Executando o rastreamento contábil no Wizard:

Após execução do WIZARDUUID, os campos CV3_IDORIG e CV3_IDDEST já estarão devidamente preenchidos com os identificadores de suas respectivas tabelas.

No conciliador, os registros já podem ser conciliados de forma automatica.