Histórico da Página

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 , dessa forma, será possível utilizar a rotina de conciliação nos dados antigos do PROTHEUS.

02. PRÉ-REQUISITOS

Os pré-requisitos para utilização do wizard de configuração são:

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

...

Após baixar, descompacte o arquivo sdfbra.txt (onde ppp é o código do país - localização) na pasta Systemload do Protheus.
 

...

Image Removed
 

...

Image Removed

...

        Na seção GENERAL, deve-se incluir a chave “App_Environment”, cujo valor deve ser o nome do ambiente que os serviços rodar e na seção DRIVERS,  deve-se habilitar a porta multiprotocolo na chave “MultiProtocolPort” com o valor = 1.

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.


Image Added

Confira: Atualizador de dicionário e base de dados - UPDDISTR

...

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'
    
    

Image Added

Para atualizar seu DBAccess confira: DBAccess - Como atualizar o DBAccess

• • 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.
    

Image Added

...

02.04. POSTGRESQL

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

• • • DBAccess - Como fazer para criar uma fonte de dados para uso com o PostgreSQL - Windows

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

• • • DBAccess - Seção [Environment], chave MemoInQuery

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.

Image Added

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

        Por padrão a conexão SSL está ativa na porta multiprotocolo, os detalhes das configurações estão disponíveis na documentação Application Server - Porta Multiprotocolo. Para desabilitar a conexão por SSL é necessário informar a chave “MultiProtocolPortSecure = 0”
        
        AppServer.ini

        [Drivers]
        MultiProtocolPortSecure=0 
        MultiProtocolPort=1

...

03. EXECUÇÃO DA ROTINA

            Através do parâmetro MV_PRJOVER é possível permitir a inclusão de itens de mesma chave em projetos concorrentes.

...

Parâmetro

...

Tipo

...

Valor Default

...

Conteúdo

...

MV_PRJOVER

...

Lógico

...

.T.

...

.F. – Não permite a inclusão de itens de mesma chave em projetos concorrentes.

.T. - Permite a inclusão de itens de mesma chave em projetos concorrentes.

...

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

Image Modified

...

04. APRESENTAÇÃO

Ao confirmara 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'

Image Added

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

Image AddedImage Removed

...

05. OPÇÕES

...

NO WIZARD

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

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

...

Image Removed

...

06. RESUMO DE CADA OPÇÃO

1. Importar configurações de Match (QLB)

Selecione essa opção para popular a tabela QLB (Conciliador contábil - Chaves) com as configurações de match padrões.

Para utilização dessa funcionalidade os arquivos de configuração (arquivos .json) devem estar na pasta systemload\tc_config.

Essas configurações são utilizadas pelo conciliador na montagem dinâmica da tela e também no processamento das regras de Match.

Com essas configurações carregadas na tabela QLB, será possível utilizar a próxima opção de geração do arquivo SDF.

...

2. Gerar SDF com campos de ID

Nessa opção, o Wizard auxiliará na criação dos campos de ID necessários para a utilização da rotina de conciliação.

Os campos serão criados com a estrutura XXX_MSUIDT, onde XXX representa o código da tabela utilizada na conciliação.

O Wizard não fará a inclusão dos campos diretamente nas tabelas. Será criado um arquivo SDFBRA.txt que deve ser utilizado posteriormente na execução do UPDDISTR.

Conforme dito anteriormente, somente serão apresentados no Wizard os campos de tabelas que possuírem configuração de match cadastradas na tabela QLB.

...

Image Added

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 (opcional)
3º - Popular Rastreamento Contábil (opcional)

...

05.01. GERAR SDF COM CAMPOS DE ID

...

05.02. POPULAR OS CAMPOS DE ID

...

05.03. POPULAR RASTREAMENTO CONTABIL

...

Após executar as 3 etapas do wizard de configuração inicial, seu ambiente esta preparado para a utilização do Conciliador. Confira a documentação:

Conciliador Backoffice - CTBA940 - P12 - Contabilidade Gerencial

06. INFORMAÇÕES RELACIONADAS

• Campos UUID no DBAccess

3. Popular os campos de ID

Nessa opção será feita a gravação dos códigos MSUIDT nos campos criados no passo anterior (XXX_MSUIDT).

Isso se faz necessário para que o usuário possa utilizar o conciliador nos registros legados do sistema.

Os campos XXX_MSUIDT serão preenchidos com um id único formado por 36 posições (MSUIDT), do tipo uniqueidentifier, gerados automaticamente pelo banco de dados

Saiba mais

...

4. Popular Rastreamento Contábil

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.

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).

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.

...

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>