Histórico da Página
...
- Visão Geral
- Exemplo de utilização
- Tela XXXdo SistemaOutras Ações / Ações relacionadas
- Tela XXX
- Principais Campos e Parâmetros
- Principais Campos e Parâmetros
- Tabelas utilizadas
01. VISÃO GERAL ÂncoraVIS VIS
VIS | |
VIS |
...
Para utilizar a nova rotina de importação da Brasíndice®, é necessário que no ambiente conste as novas tabelas e demais alterações de dicionário - informadas no tópico xx Item 5 - Tabelas Utilizadas. Para uso da rotina:
- Acesse a rotina no caminho Atualizações / Procedimentos / Brasindice (PLSBRASIN1).
- O sistema irá exibir a tela inicial da rotina, que irá exibir as importações já realizadas no grid, além de disponibilizar ao usuário as opções de Importação, visualização e outras.
- Com relação aos botões da tela, temos:
- Importar: inicia o processo de importação dos arquivos, de acordo com as configurações cadastradas no sistema;
- Configurar: abre a tela de configuração das Regras de importação - medicamentos, soluções, materiais;
- Visualização: após importação dos arquivos, ao posicionar em alguma importação realizada, o sistema irá exibir resumo de todos os eventos importados;
- Outras Ações / Excluir: realiza a exclusão de uma importação realizada.
- Para que o sistema possa realizar a importação dos arquivos, é necessário realizar a configuração das Regras/Layouts de importação, pois será baseado nessas informações que o sistema irá proceder com a importação, respeitando a configuração realizada.
- Desta forma, iremos dividir esse tópico em vários subtópicos, para o cadastro das pré-condições de importações e demais informações vitais para o uso da rotina.
...
Importação dos arquivos Brasíndice
Âncora imp imp - Após configuração das regras e demais informações, devemos proceder com a importação dos arquivos, para que as informações sejam replicadas no SIGAPLS.
- Para iniciar a importação, basta estar na tela inicial do processo da Brasíndice.
- Clique no botão Importar.
- O sistema irá abrir um Pergunte, aonde o usuário deve informar:
- Diretório onde os arquivos .txt de medicamentos, materiais e soluções estão salvos, prontos para serem importados (seguindo o padrão de nomes, discutidos nos tópicos anteriores);
- Informar o código da Edição Brasíndice que está sendo importado;
- Data de Publicação. Essa informação irá ser utilizada como a data inicial da composição dos eventos, na tabela BD4, bem como se houver registro anterior de composição, será finalizado com a data do dia anterior a essa informada.
- Tipo de Operação - Inclusão ou Exclusão. Informe se está realizando a importação de Inclusão - para preencher as tabelas, ou se está informando os arquivos de Exclusão - itens excluídos da Brasíndice. Atualmente, funciona apenas Inclusão. Em versões futuras, será adicionada a funcionalidade de exclusão.
- Após informar esses dados, clique no botão OK, para que o processo de importação tenha início.
- Caso no diretório os arquivos estejam com os nomes corretos - iguais nas Regras/layouts configurados - e com a versão igual à informada no Pergunte, o sistema irá iniciar o processo de importação. Contudo, se houver arquivos com nomes que não se encaixam em nenhuma regra de importação ou com versão diferente, o sistema irá indagara o usuário o que deve ser feito:
- Se o nome do arquivo está certo, mas contêm uma versão diferente da informada no Pergunte, o sistema pede para que o usuário confirme se deve rejeitar o arquivo - não será importado - ou então, que será importado, mas os eventos ficarão atrelados a chave da edição do Pergunte. Ou seja, se no Pergunte foi informado a versão "600", mas o nome do arquivo consta "500", caso importe, os campo desses eventos ficarão com o valor da edição "600", pois é a informada no Pergunte. Essa informação será utilizada para controle das versões, no novo campo da tabela BD4, de nome BD4_CHVIMP.
Na imagem abaixo, temos arquivos com a versão "850", diferente da informada no Pergunte, que é "861". O sistema exibe a diferença, devendo o usuário escolher qual ação tomar.
Quando no diretório existir arquivos que não condizem com nenhuma regra, antes de iniciar a importação, o sistema irá abrir um browse, exibindo estes arquivos do lado esquerdo e no lado direito, o usuário pode informar manualmente qual regra deseja usar para o arquivo e no final, clicar no botão Salvar.
Caso não queira informar nenhuma regra, desconsiderando estes arquivos, basta clica no botão Cancelar.
- Caso tenha mais de um arquivo, onde alguns devem ser importados, conforme regras selecionadas pelo usuário, e outros não, basta informar a regra desejada para os que devem ser importados e os demais deixar em branco.
O combo do lado direito, referente a Configuração Brasíndice, nem sempre vai apresentar todas as configurações cadastradas no sistema. Caso tenhamos um arquivo correto na pasta, associado a uma regra, essa regra não será exibida no combo, pois já tem arquivo associado. Será apresentado apenas as regras que ainda não tiveram arquivos associados à esta regra.
Por exemplo, se tenho três regras - Material, Solução, Medicamento - e no diretório tenha um arquivo com o nome correto, associado a regra de Solução, ao exibir esse browse, a opção Solução não estará disponível para escolha, visto que já temos arquivo associado a regra.Aviso title ATENÇÃO Sempre devemos colocar o nome do arquivo no formato correto, esperado pela rotina de importação, conforme visto nos tópicos anteriores. As situações acima são consideradas anômalas e estes auxiliares visam alertar o usuário do problema e não devem ser utilizados como padrão na Operadora, pois o usuário pode importar um arquivo com versão diferente, ocasionando problema nos preços, bem como pode associar a uma regra errada, ocasionando uma importação em tabelas indevidas e problemas na valoração do sistema.
Assim, sempre nomear o arquivo Brasíndice da forma correta!
- Após essas escolhas, o sistema irá dar início ao processo de importação, exibindo de forma visual o progresso.
Durante o processo de importação, as seguintes tabelas são inseridas/alteradas:
Tabela Ação Descrição e informações BF8 Inclusão / Consulta Caso na configuração conste que deve ser criado a TDE (B6G_CRITDE igual a "Sim"), o sistema irá realizar a inclusão de uma nova TDE. Caso contrário, realiza apenas a consulta na TDE existente, para obtenção dos dados.
Caso seja criada uma nova TDE:
- O nome dela será "TABELA BRASINDICE - " + nome do tipo de procedimento que está sendo importado (MATERIAIS ou MEDICAMENTOS ou SOLUCOES).
- O campo BF8_TPPROC será preenchido com o valor "1", quando for Material; com o valor "2", quando Medicamento e valor "9", quando Solução.
BA8 Inclusão / Alteração Caso o arquivo contenha algum item não existente na BA8, o sistema irá incluir este evento. Caso contrário, irá realizar a alteração do registro.
Caso exista na base os campos BA8_DFORMA e BA8_NMFABRA, serão preenchidos respectivamente com as informações do Nome da Apresentação e Nome do Laboratório.
BD4 Inclusão / Alteração O sistema irá criar a composição do item.
- Se o evento já existir na BD4, será finalizado, informando no campo BD4_VIGFIM a data final. Essa data final é o dia anterior da data informada no Pergunte, no campo data da publicação. Ou seja, se foi informada a data 20/01/2019 no Pergunte, a data final do BD4 existente será 19/01/2019.
- Ao criar o evento na BD4, o campo BD4_VIGINI será preenchido com a data informada no Pergunte.
- O campo BD4_CODIGO será preenchido com a unidade informada na configuração da Regra (B6G_CODUND).
- O campo BD4_VALREF será preenchido com o valor do arquivo - valor total ou parcial - conforme layout (B6G_TIPVAL)
- Foi criado o novo campo na BD4, de nome BD4_CHVIMP. Este campo irá armazenar a chave da importação realizada, para criar os vínculos necessários.
- Por isso, é extremamente importante informar a versão correta que está sendo importada e os arquivos possuírem essa mesma versão no nome, pois será a chave do relacionamento.
BR8 Inclusão / Alteração O sistema irá verificar se o evento já existe na tabela BR8. Caso não exista, irá realizar inclusão e caso e se existir, irá realizar a atualização dos dados.
- O campo Ativo (BR8_BENUTL) será preenchido com a informação constante na Regra (B6G_ATIVO).
- O campo Classe (BR8_CLASSE) será preenchido com a informação definida na Regra (B6G_CLASSE).
- O campo Tipo de autorização (BR8_AUTORI) será preenchido com a informação constante na Regra (B6G_AUTORI).
- O campo BR8_TPPROC será preenchido com o valor "1", quando for Material; com o valor "2", quando Medicamento e valor "9", quando Solução.
BTQ Inclusão / Alteração Quando o evento for criado na TDE própria - ou seja, evento que ainda não possui equivalência de código TUSS/TISS - o sistema irá verificar se já foi criado na Tabela 64, de Terminologias. Se não existir, será criado e caso exista, irá proceder com a atualização dos dados.
- O campo Código de grupo (BTQ_CODGRU) será preenchido com "029", quando for Material e "030", para Medicamento e Solução.
- O campo Forma de envio (BTQ_FENVIO) será preenchido como"CONSOLIDADO".
- Durante a importação, o sistema exibe de forma visual o progresso das operações, por meio de barra de progresso. A primeira barra mostra quantas Regras/layouts existem cadastradas no sistema e que serão analisadas, enquanto que a segunda barra mostra o progresso de importação do arquivo. O tamanho mostrado é a quantidade de bytes lidas do arquivo, não registros presentes no mesmo.
- No final do processamento, caso tenhamos ocorrências diversas, será exibido browse com os erros detalhados, para análise do usuário. Caso clique no botão Cancelar da janela, o browse será fechado, mas se clicar no botão Salvar, será criado um log com essas ocorrências, sendo gravado na mesma pasta onde estão os arquivos para importação - no caminho definido no Pergunte.
- No browse, é exibido um código de erro - detalhado no rodapé do browse - e a descrição do erro.
- No browse, é exibido um código de erro - detalhado no rodapé do browse - e a descrição do erro.
- O nome do arquivo de log será: "erros_importacao_brasindice_ + data atual + hora da geração + .log", como por exemplo: "erros_importacao_brasindice_05_06_2020_11_40_15.log"
Abaixo, um resumo dos códigos das ocorrências:
Código do Erro Descrição Informação 0 - "O arquivo 'XXX.txt' possui as regras da configuração: 'YYY', mas a presente regra já possui arquivo herdado"
- Como detalhado nos tópicos anteriores, quando o sistema vai realizar o processo de importação, podemos apenas ter um arquivo por regra. Ou seja, se colocar dois arquivos na pasta de importação, do tipo Medicamento e PMC, apenas um será importado e o outro não, sendo exibido essa crítica.
1 - "Arquivo: 'XXX.txt' não foi dado 'match' manual."
- Exibida quando existir um arquivo na pasta, mas que não corresponde a nenhuma regra e o usuário também não selecionou uma configuração de forma manual, no browse de arquivos sem correspondência.
2 - "Arquivo 'XXX.txt' do tipo 'Y' possui valor do tipo 'PMC' mas a configuração no sistema é para 'PFB'."
- Arquivo 'XXX.txt' do tipo 'Y' não possui a quantidade mínima de colunas esperada no arquivo. Quantidade de colunas esperada: 'A'
- no arquivo: 'B' - Arquivo 'XXX.txt' inválido, sem delimitador ou outro tipo de problema. Verifique se o arquivo é válido."'
- Exibida quando a regra de importação determinar que o tipo de preço é um (PMC/PFB), mas os registros constam outro tipo. Exemplo: O arquivo foi gerado como PFB, mas na hora de nomear o arquivo, o usuário colocou PMC e existe uma regra para PMC. Mas no início da importação, o sistema valida a regra e verifica que são diferentes, não realizando a importação.
- Aqui, o sistema valida se o número de colunas do arquivo bate com a configuração do tópico XX Regras dos nomes e campos dos arquivos, onde determina quais colunas devem ser exportadas. Por exemplo, ao exportar a tabela de Medicamentos, seguindo as orientações do tópico, o arquivo deve conter 17 colunas. Mas se o usuário esqueceu de marcar alguma opção, vai conter colunas a menos. Dessa forma, o sistema crítica e não realiza a exportação.
- Exibida quando o arquivo não for do formato esperado, o separador for diferente de "," ou outro problema com sua estrutura, não realizando a importação.
3 - "O item: 'B' - Código da Apresentação: 'APR', possui registro inválido, com colunas a mais que o esperado.
Este registro não será importado. Verifique esse item no arquivo." - "Item: TDE('CCC') - Cod. Tp Saúde ('AB') - Evento('12345678') encontra-se importado no sistema, com versão igual ou superior ('900')
a que está sendo importada neste momento (versão:'890'). O item não será importado." "Item: TDE('CCC') - Cod. Tp Saúde ('AB') - Evento('12345678') está importado no sistema com a mesma data inicial (BD4_VIGINI)
dessa importação. Devido a regras de integridade, o item não será importado."
- O arquivo pode conter algumas linhas mal formatadas, ocasionando problemas na identificação e sua importação. Essa linha é desconsiderada, sendo apresentado o nome e apresentação do item, para que o usuário identifique qual item não foi importado.
- Se o item a ser importado já constar no sistema, com a versão (Edição) superior a que está sendo importada, o item não será importado e será colocado essa crítica. Por exemplo, o item A foi importado na Edição 900 e o usuário está importando uma anterior. Será criticado dessa maneira.
- Essa crítica só irá ocorrer caso tenhamos um item já existente no sistema, com data inicial igual ao do item que será importado (informação proveniente do Pergunte - Data da Publicação). Por questão de Consistência do BD, o item não será importado.
DL - "Query 1/2/3/4 - " + Descrição do erro
- Mensagem exibida quando tenta excluir uma importação já realizada. O sistema irá exibir o erro dado na operação de exclusão, proveniente do DbAccess ou Servidor ADVPL.
- No final, os itens importados serão exibidos no grid, para que o usuário veja quais edições já foram importadas. Esse registro é gravado na tabela B6F - Importações Brasíndice.
- Observe que o sistema armazena nessa tabela o número da Edição informada no Pergunte, o usuário logado que realizou a importação, o nome do arquivo usado e os código da TDEs usadas, além do tipo de preço utilizado.
- Clique no botão Importar.
...
Visualização das importações realizadas
Âncora vis vis Conforme visto no tópico de Importações, após realizar a importação, o sistema irá gerar os registros das importações realizadas na tabela B6F, para que os usuários saibam quais arquivos e edições foram importados no sistema.
- Caso o usuário queira visualizar os itens vinculados a edição importada, basta na tela inicial da Brasíndice (PLSBRASIN1), posicionar na registro desejado e clicar no botão Visualização.
- O sistema irá exibir uma mensagem de carregando os dados e após carregamento, exibir o browser, mostrando todos os registros da tabela BD4 vinculados a essa importação. Essa vinculação é realizada pelo campo BD4_CHVIMP.
Nessa tela, visualizamos os itens atrelados a importação realizada.
Aviso title Atenção Como são importados milhares de registros e é checado a tabela BD4, é normal que ao clicar na opção Visualizar, o sistema tenha um carregamento mais moroso para os dados. Por isso, é exibido a dialog de "Carregando", que indica que o sistema está procurando os dados para exibição. Somente quando o carregamento for realizado pelo sistema, será aberto o browser para exibição dos dados.
Exclusão de Importações
Âncora del del Caso o usuário tenha efetuado alguma importação e queira excluir, o sistema permite, desde que:
A edição que está sendo excluída seja a última para o tipo de procedimento (Material, Solução ou Medicamento) e tipo de Preço (PMC ou PFB). Ou seja, se tenho duas importações realizadas, só posso excluir a última edição, a mais recente.
Exemplo Resultado 1º) Tipo: Material / Preço: PFB / Edição: 500
2º) Tipo: Material / Preço: PFB / Edição: 450
Tento excluir o segundo registro, edição 450.
Ao tentar excluir o segundo registro - de edição 450 - o sistema não irá deixar, pois temos edição mais recente importada no sistema.
- Para excluir, na tela inicial da rotina de importação Brasíndice, posicione no registro desejado e clique no botão Outras Ações / Excluir.
- Se o registro que está sendo excluído não for o último, conforme explica no item anterior, o sistema irá alertar o usuário, com aviso em tela, informando que para este mesmo tipo de Procedimento e Valor, possui importação mais recente e seu numero.
- Se for a última versão, o sistema pergunta ao usuário se realmente deseja excluir essa versão e registros.
- Se clicar em "Não", o processo é interrompido e nada é excluído. Se sim, o sistema inicia o processo de exclusão. Este processo é acompanhado pela barra de progresso, para que o usuário acompanhe visualmente os passos da exclusão.
- No final da exclusão, caso o processamento tenha ocorrido de forma normal, o sistema exibe um Help, informando que a edição e todos os dados vinculados foram excluídos.
- Caso ocorra algum problema na exclusão dos itens, o usuário é alertado do problema e abre-se um browse com os erros detalhados, para análise do usuário.
- Caso clique no botão Cancelar da janela, o browse será fechado, mas se clicar no botão Confirmar, o sistema abre o modal para o usuário selecionar o local onde deseja gravar o log em sua máquina. Selecione o local e clique no botão Abrir, para que o log seja salvo neste local.
- O nome do arquivo de log será: "erro_deletar_tabela_ + data atual + hora da geração + .log", como por exemplo: "erro_deletar_tabela_05_06_2020_14_41_55.log"
- Se o registro que está sendo excluído não for o último, conforme explica no item anterior, o sistema irá alertar o usuário, com aviso em tela, informando que para este mesmo tipo de Procedimento e Valor, possui importação mais recente e seu numero.
03. TELAS DO
...
SISTEMA Âncora telasist telasist
telasist | |
telasist |
PLSBRASIN1 - Importação dos arquivos Brasíndice
...
PLSBRASIN2 - Configuração das Regras de Importação.
04. TELA DE
...
IMPORTAÇÃO - PERGUNTE Âncora perg perg
perg | |
perg |
Principais Campos e Parâmetros
Campo | Descrição |
---|---|
Diretório dos arquivos | Informe o local onde estão os arquivos para importação. |
Número da Edição | Númerod a Edição Brasíndice que está sendo importada. |
Data Publicação | Data da Publicação, que servirá como data inicial dos procedimentos. |
Tipo de Operação | Incluão ou Exclusão. Apenas o Inclusão é funcional (V1). |
05. TABELAS UTILIZADAS Âncora tab tab
tab | |
tab |
- Criação da Tabela B6F - Importacoes Brasindice
...