Guias de Solução de Problemas
Problemas comuns
Esta seção cobre problemas frequentes encontrados ao usar Aspose.Cells FOSS em Python, especificamente com classes da superfície da API, como Cell, AutoFilter, CSVHandler, e CFBReader.
Importação de CSV falha com erros de codificação
Os sintomas incluem texto embaralhado ou UnicodeDecodeError ao carregar arquivos CSV. Isso ocorre quando o arquivo CSV usa uma codificação que não seja UTF-8 (por exemplo, cp1252 ou Shift-JIS). Para corrigir, converta o arquivo para UTF-8 antes de carregá-lo, ou passe um CSVLoadOptions instância para CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter Não Aplicado Após Carregar XLSX
Os sintomas incluem controles de filtro ausentes ou dados não filtrados após carregar um .xlsx arquivo. Isso acontece quando AutoFilterXMLLoader.load_auto_filter() falha silenciosamente devido a XML malformado no arquivo de origem. Verifique se o XLSX xl/autofilters/autofilter*.xml está bem formado. Se o arquivo foi criado externamente, certifique-se de que ele esteja em conformidade com ECMA-376. Use AutoFilter.range, filter_columns, e sort_state para inspecionar o estado carregado após o carregamento.
Arquivos XLSX criptografados não podem ser lidos
Os sintomas incluem NotImplementedError: Standard encryption is not yet supported ao tentar abrir um arquivo criptografado .xlsx arquivo. Aspose.Cells FOSS suporta apenas criptografia Agile (ECMA-376 Parte 2, Seção 4) via AgileEncryptionParameters. Arquivos criptografados com XOR legado ou criptografia padrão ECMA-376 não são suportados. Use CFBReader.read_encryption_info() somente se o arquivo usar criptografia Agile; caso contrário, descriptografe externamente antes do carregamento.
Cell Valores Não Analisados Corretamente a partir do XML
Os sintomas incluem valores de data incorretos, cadeias numéricas interpretadas erroneamente como números ou valores de erro (por exemplo,., #N/A) não reconhecidos. Isso ocorre quando CellValueHandler.parse_value_from_xml() é usado com incorreto cell_type ou ausente shared_strings contexto. Garanta cell_type corresponde ao ECMA-376 t atributo (por exemplo,., 's' para string compartilhada, 'n' para número), e forneça um preenchido shared_strings lista para tipos de string. Use CellValueHandler.get_cell_type() para validar tipos inferidos antes da análise.
Mensagens de erro
Aspose.Cells FOSS raises specific errors during file I/O, encryption, and parsing operations. This section documents common error messages from classes like CFBReader, CFBWriter, e AutoFilterXMLLoader, juntamente com suas causas e correções.
| Erro | Causa | Corrigir |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Tentando ler ou gravar XLSX criptografado usando criptografia não Agile (por exemplo, XOR, RC4). | Use AgileEncryptionParameters e garanta que o arquivo use criptografia Agile (ECMA-376 Parte 2, Seção 4). |
NotImplementedError: Only Agile encryption is currently supported | Usando CFBWriter ou CFBReader com parâmetros de criptografia diferentes de Agile. | Configure a criptografia via AgileEncryptionParameters antes de chamar write() ou read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Criando um gráfico de tipo não presente em ChartType.LINE, BAR, PIE, AREA, ou STOCK. | Limite a criação de gráficos aos tipos suportados: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Salvando tipos de gráfico não suportados (por exemplo, WATERFALL, BOX_WHISKER) em XML. | Use apenas os suportados ChartType valores ao salvar gráficos via xml_chart_saver. |
ValueError: Invalid CSV content | Dados CSV malformados passados para CSVHandler.load_csv_from_string() ou load_csv(). | Valide a sintaxe CSV antes de carregar. |
ValueError: Cell value type mismatch | Passando um tipo incompatível para CellValueHandler.format_value_for_xml() ou parse_value_from_xml(). | Use CellValueHandler.get_cell_type() para determinar o tipo de célula correto antes de formatar ou analisar. |
Obtendo ajuda
Para Aspose.Cells FOSS, reporte problemas ou solicite recursos via GitHub Issues. Revise a documentação para classes como AutoFilter, Cell, CSVHandler, e AgileEncryptionParameters. Engaje a comunidade no GitHub Discussions para perguntas gerais sobre o uso da biblioteca em fluxos de trabalho Python.
- GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- Discussões no GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- Referência da API: https://reference.aspose.org/cells/python/
Veja Também
Para orientações relacionadas sobre como lidar com problemas comuns em Aspose.Cells FOSS, revise a documentação para classes principais como Cell, AutoFilter, CSVHandler, e AgileEncryptionParameters.
