Histórico da Página
Índice maxLevel 43
Informações | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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.
04. Apresentação
Será exibida a tela de abertura do Wizard:
05. Opções disponíveis no Wizard
Após a tela de abertura serão exibidas as opções disponíveis para processamento.
São quatro opções para auxiliar a configuração inicial da base de dados para uso do conciliador de dados.
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.
- Apresentação do Wizard de exportação do arquivo SDF
2. Exibição dos campos que serão exportados para o arquivo:
3. O arquivo será exportado para a pasta systemload.
Caso já exista um arquivo diferencial nessa pasta, o sistema pergunta se deve sobrescrevê-lo.
4. Mensagem informando que o arquivo foi gravado com sucesso:
5. Arquivo criado na pasta systemload.
Evidência do arquivo manifest_update com os detalhes do arquivo SDF gerado pela ferramenta.
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:
Nota | ||
---|---|---|
| ||
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 (identificador único universal) 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, anteriores à criação dos campos XXX_TCUUID.
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.
- Tela de apresentação com o filtro de data para gravação dos Id's nos registros do legado.
2. Tela com exibição dos campos que serão gravados "XXX_TCUUID" e com os campos que serão utilizados para filtrar os dados (Campos de data).
3. Os campos utilizados para fazer o filtro podem ser editados pelo usuário:
4. Campos gravados após processamento da rotina:
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.
Confira: Atualizador de dicionário e base de dados - UPDDISTR
Informações | ||
---|---|---|
| ||
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'
- A versão mínima de DBAccess deve ser a versão 21.1.1.8.
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.
- A versão mínima de Lib deve ser a versão 20220725.
...
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.
Dica | ||
---|---|---|
| ||
*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. Para mais detalhes sobre esta melhoria, confira: |
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
Incluir Página | ||||
---|---|---|---|---|
|
...
05.02. POPULAR OS CAMPOS DE ID
Incluir Página | ||||
---|---|---|---|---|
|
...
05.03. POPULAR RASTREAMENTO CONTABIL
Incluir Página | ||||
---|---|---|---|---|
|
...
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> |