O artigo a seguir visa instruir a execução do programa de atualização do dicionário de dados do Importador de XML da Qive. Esse programa tem o nome U_IMPXACI e também é chamado de update ou compatibilizador. Seu objetivo é manter as tabelas do importador atualizadas no banco de dados do Protheus.
Para executá-lo o ambiente do Protheus necessita estar em modo exclusivo, ou seja, nenhum usuário ou rotina pode estar em execução no sistema.
Abaixo encontram-se as etapas para execução:
1º Após a aplicação do pacote de atualização do importador, execute a função U_IMPXACI diretamente pelo Smartclient.
2º Será apresentado a tela inicial do wizard, onde se deve clicar em Avançar >.
3º Selecione a empresa para efetuar a atualização e clique em Avançar >. Nessa etapa é possível selecionar apenas uma empresa, ou seja, caso haja mais de uma empresa, é necessário repetir o processo.
4º Escolha a opção do portal de integração para captura de XML, podendo ser as opções Qive ou ConexãoNF-e. Caso o campo já esteja preenchido, conforme imagem abaixo, basta seguir para próxima etapa, clicando em Avançar >.
5º Nessa etapa o programa solicita as ações necessárias para continuar com a atualização como, por exemplo, informar o código de uma tabela nova. Preencha o(s) campo(s) quando solicitado e clique em Avançar >. Caso não haja ações, é apresentado a mensagem Nenhuma ação é necessária!
Quando solicitado o nome de uma tabela, deve-se escolher um nome que não esteja em uso. Para auxiliar a identificação dessa tabela, clique no botão Tabelas Em Uso, e escolha alguma que não esteja nessa lista.
6º Nesse momento a rotina passa pela etapa de Análise de Integridade, visando identificar ocorrências de registros de XMLs duplicados na tabela principal do sistema. Essa etapa tornou-se necessária a partir da versão 24.11.08 em conjunto com a alteração de índice único da tabela 1 (contida no parâmetro MV_XGTTAB1).
Caso apareça a mensagem abaixo, deve ser cancelado o processo e analisado cada caso, a fim de compreender a veracidade da informação e identificar possíveis falhas no processo.
Vale destacar que a duplicidade nessa tabela não significa que existam lançamentos duplicados, pois tanto o Protheus quanto o sistema da Qive possuem mecanismos de integridade a partir de validações e índice único da tabela SF1.
Caso não haja necessidade de validar profundamente as ocorrências apresentadas, há a possibilidade de deixar a própria rotina ajustar os registros duplicados. Clicando em Continuar na mensagem abaixo, o sistema identificará os registros inválidos e realizará a exclusão, deixando apenas o registro original (primeira gravação).
Destacando também a necessidade de exclusão de registros obsoletos de carta de correção e cancelamentos (legado). Para mais detalhes, consulte o descritivo da release.
7º Por fim, é apresentado o resumo das atualizações, indicando o que o sistema irá alterar no seu banco de dados. Basta clicar em Concluir e aguardar o término da atualização.
Assim termina a atualização do dicionário de dados do Importador.