AGRA680 – Importação de Resultados Laboratoriais HVI

01. OBJETIVO

A rotina AGRA680 permite importar automaticamente os resultados laboratoriais de HVI (análise de fibras) e Análises de Contaminantes a partir de arquivos texto (.TXT) gerados pelos laboratórios.
O processo realiza a leitura, validação e gravação dos resultados no sistema, vinculando-os aos romaneios e fardos correspondentes, de forma padronizada e segura.

02. FUNCIONALIDADES PRINCIPAIS

• Importa arquivos de resultados laboratoriais em formato texto (.TXT);
• Suporta dois tipos de análise:
• HVI
• Contaminantes;
• Permite configuração de layout via tabelas DX1/DX2, sem necessidade de alteração de código;
• Aceita arquivos delimitados (vírgula, ponto e vírgula) ou de largura fixa;
• Executa validações automáticas:
• Safra;
• Existência da mala/fardo (DXJ, DXI, DXD);
• Tipo de campo (numérico, data, texto);
• Gera log de inconsistências;
• Move automaticamente os arquivos para pastas:
• LIDO → quando a importação é concluída com sucesso;
• ERRO → quando há falhas de validação;
• Atualiza automaticamente o status dos romaneios e remessas após a importação.

03. PRÉ-REQUISITOS

1. Layouts configurados nas tabelas:
• DX1 / DX2 → definem estrutura e mapeamento de campos;
2. Safra válida cadastrada (tabelas NJU ou NN1);
3. Registros base existentes:
• DXJ (mala), DXI (fardo), DXD (bloco);
4. Permissão de acesso às tabelas utilizadas (DX1, DX2, DX7, DXI, DXJ, DXK, DXD, NPX);
5. Configuração de diretório de importação com subpastas:
• /LIDO
• /ERRO

04.COMO UTILIZAR

1. Acesse a rotina:
   SIGAAGR → Atualizações → Beneficiamento → Importação de Resultados (AGRA680)
2. Informe os parâmetros iniciais:
• Safra;
• Layout (HVI ou Contaminante);
• Diretório onde estão os arquivos .TXT a importar.
3. Selecione os arquivos:
• O sistema listará todos os arquivos encontrados no diretório informado;
• Marque os arquivos desejados para importação.
4. Execute a importação:
• Clique em Importar;
• A rotina fará a leitura e gravação dos dados conforme o layout configurado.
5. Acompanhe o resultado:
• Os arquivos processados com sucesso serão movidos para a pasta LIDO;
• Arquivos com erros serão movidos para ERRO, e o sistema exibirá um log com as inconsistências encontradas.

05. PROCESSOS INTERNOS (RESUMO TÉCNICO SIMPLIFICADO)

• A680IMPORT: controla a leitura dos arquivos e chama a rotina específica (HVI ou Contaminante);
• A680ImpHvi: trata as linhas de resultados HVI, grava na tabela DX7 e atualiza romaneios (DXJ);
• A680ImpCnt: trata resultados de contaminantes, gravando na NPX e atualizando os fardos/blocos;
• Validações:
  • Safra (A680VldSF);
  • Estrutura do layout (A680LAYOUT);
  • Conversão de tipos (Converte);
• Atualizações automáticas:
  • Status de romaneio (AtuClassif);
  • Status de remessa (AtuStaRems);
  • Propagação de resultados para fardos (FardinhoImport).

06. EXTENSIBILIDADE

A rotina permite customizações via ponto de entrada AGR680IMP1, possibilitando ajustes no comportamento antes da importação de cada etiqueta.

Observações:

• Sempre valide os layouts DX1/DX2 antes de iniciar o processo em produção;
• Teste a importação com arquivos de exemplo fornecidos pelo laboratório;
• Verifique configurações regionais de data e separadores decimais (influenciam nas conversões);
• Garanta que o usuário possua permissões de gravação nas tabelas envolvidas.