Pular para o conteúdo principal

Abril

14/04/2026​

Suporte a codificação na leitura de arquivos XML​

Arquivos XML podem ser gerados em diferentes padrões de codificação de caracteres. Para garantir que informações como acentos e caracteres especiais sejam interpretadas corretamente pelo sistema, é fundamental que o leitor de arquivos consiga identificar o formato original (charset) do documento.

A API do bfc-script foi atualizada para permitir a especificação manual da codificação (encoding) durante a leitura de arquivos XML. Anteriormente, o sistema não suportava esse parâmetro adicional, o que poderia causar erros de leitura em arquivos que não estivessem no padrão global (UTF-8).

Agora, ao utilizar o comando de leitura de arquivos, você pode passar um mapa de opções contendo a chave encoding e o valor desejado (ex: 'ISO-8859-1').

Exemplo de uso:

Para ler um arquivo XML utilizando uma codificação específica, utilize a sintaxe abaixo:

arquivo = Arquivo.ler(arquivoParam, 'xml', [ encoding: 'ISO-8859-1' ]);

Passo a passo para implementação:

  • Identifique a codificação do arquivo de origem que será processado.
  • No seu script, localize a chamada da função Arquivo.ler.
  • Adicione o terceiro parâmetro à função, especificando o encoding necessário entre colchetes.
  • Salve e publique a alteração no bfc-script.
Importante
  • Caso o parâmetro de encoding não seja informado, o sistema manterá o comportamento padrão de leitura.
  • Certifique-se de que o nome da codificação informado (como 'UTF-8', 'ISO-8859-1', etc.) é um padrão reconhecido internacionalmente.
  • Essa alteração é retrocompatível; scripts que já utilizam a leitura de XML sem especificar o encoding continuarão funcionando normalmente.