Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice
4
maxLevel3


Informações
titleAtenção

Este conjunto de funcionalidades estará disponível a partir do release 12.1.33

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 preparação, tanto da estrutura adequação das estruturas das tabelas , quanto da carga inicial do legado do sistema. 

Informações
titleAtenção

Este conjunto de funcionalidades estará disponível apenas no release 12.1.33

02. Pré-requisitos

Os pré-requisitos para utilização do wizard de configuração é ter o arquivo CTBA930.PRW compilado no repositório de objetos.

E a versão da Lib igual ou superior a 20211004.

03. Execução da rotina

Para execução do Wizard de Configurações no Conciliador, deve ser utilizado, na abertura do sistema, o programa inicial: WIZARDUUID.

Image Removed

04. Opções disponíveis no Wizard

Após inciar o sistema com o programa inicial WIZARDUUID, o Wizard será iniciado e apresentará três opções para serem escolhidas:

Image Removed

1. Gerar SDF com campos de ID

Nessa opção o Wizard auxiliará na criação dos campos de ID utilizados para identificar os registros na rotina de conciliação.

Os campos serão criados com a estrutura XXX_TCUUID (Totvs Conciliador UUID), onde XXX é a tabela utilizada pelo conciliador.

Os campos TCUUID devem ser alimentados com um id único formado por 32 posições (UUID) obtidos pela função FWUUIDV4.

Somente serão apresentados no Wizard, campos das tabelas que possuem alguma configuração de match na rotina de conciliação (Tabela QLB).

O Wizard não fará a inclusão dos arquivos diretamente nas tabelas, mas sim, fará a geração de um arquivo SDFBRA.txt que será utilizado posteriormente pela rotina de atualização de dicionários UPDDISTR.

2. Popular os campos de ID

Nessa opção o Wizard fará a inclusão dos códigos UUID nos campos criados no passo anterior.

Isso se faz necessário para que o usuário possa utilizar o conciliador nos registros anteriores à criação dos campos de ID (XXX_TCUUID). Ou seja, essa opção serve para popular o legado.

3. Popular Rastreamento Contábil

Desenvolver documentação neste ponto após desenvolver a rotina

05. Gerar SDF com campos de ID

Ao selecionar a opção "Gerar SDF com campos de ID", o sistema fará a leitura das tabelas de origem e destino configuradas previamente na tabela QLB e serão listados os campos XXX_TCUUID dessas tabelas.

Os campos encontrados 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.

  1. Apresentação do Wizard de exportação do arquivo SDF

Image Removed

2. Exibição dos campos que serão exportados para o arquivo:

Image Removed

3. O arquivo será exportado para a pasta systemload.

Caso já exista um arquivo diferencial nessa pasta, o sistema pergunta se deve sobrescrevê-lo.

Image Removed

4. Mensagem informando que o arquivo foi gravado com sucesso:

Image Removed

5. Arquivo criado na pasta systemload.

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

Image Removed

6. Após finalizar o Wizard, e com o arquivo SDF gerado na pasta systemload, o usuário poderá optar por executar o UPDDISTR escolhendo a opção SIM na mensagem exibida:

Image Removed

Nota
titleImportante

Lembrando que para executar o UPDDISTR é necessário ter acesso exclusivo ao sistema.

06. Popular os campos de ID

Nessa opção o sistema fará a gravação dos códigos UUID nos campos criados no passo anterior (Geração do Arquivo SDF).

Isso se faz necessário para que seja possível conciliar dados anteriores a implantação da rotina de conciliação.

A partir da instalação do conciliador e da criação dos campos de ID, esses códigos serão inseridos automaticamente a cada inclusão de registro.

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.


Image Added


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


Informações
titleAtenção

O compartilhamento de tabelas de conciliação (QLC - Cabeçalho de conciliação e QLD - Itens da conciliação) devem ser iguais e compatíveis com a maneira em que se deseja trabalhar as conciliações.

Para conciliar e consultar conciliações de mais de uma filial por vez, as tabelas QLC e QLD deverão estar em modo compartilhado, por padrão, serão criadas em modo exclusivo.


...

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:


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


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

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

Image Added


...

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'

Image Added


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

Image Added


...

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.

Dica
titleImportante*

*Foi implementada uma melhoria que realiza a importação de configurações de Match (QLB) automaticamente ao acessar o Conciliador. Por esta razão que a primeira opção do Wizard foi descontinuada e encontra-se desabilitada e não é necessário a sua execução, basta acessar a rotina CTBA940 no menu do Protheus que as configurações de match serão importadas para a tabela QLB.

Portanto, se este for o primeiro uso do Conciliador, lembre-se de acessar a rotina Conciliador Backoffice (CTBA940) no menu Protheus, conforme o tópico 02.05. para que as configurações de match sejam carregadas em seu ambiente, após isso, retorne ao WIZARDUUID para os passos seguintes.

Para mais detalhes sobre esta melhoria, confira:


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:

Informações
titleObservação

A opções 'Popular os campos de ID' e 'Popular Rastreamento Contábil' estão descritas como opcionais porque tem como objetivo, preparar os registros presentes no ambiente, antes da inclusão do campo MSUIDT para conciliação. Caso não queira conciliar os registros anteriores, não é necessário executar essas opções.



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

Incluir Página
Gerar SDF com campos de ID
Gerar SDF com campos de ID


...

05.02. POPULAR OS CAMPOS DE ID

Incluir Página
Popular os campos de ID
Popular os campos de ID


...

05.03. POPULAR RASTREAMENTO CONTABIL

Incluir Página
Popular Rastreamento Contábil
Popular Rastreamento Contábil


...


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

...


HTML
<!-- 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>