Guia de solução de problemas

Problemas comuns

Esta seção abrange problemas frequentes encontrados ao usar Aspose.Cells FOSS em Python, especificamente com classes da superfície API como: Cell, AutoFilter, CSVHandler, e CFBReader.

Importação CSV falha com erros de codificação

Os sintomas incluem texto distorcido ou UnicodeDecodeError Quando o arquivo CSV usa uma codificação não-UTF-8 (por exemplo, cp1252 ou Shift-JIS). Para corrigir isso, converta o ficheiro para UTF-8 antes de carregar ou passe um código de segurança. CSVLoadOptions instância a 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 carregamento XLSX

Os sintomas incluem a falta de controles do filtro ou dados não filtrados após o carregamento da máquina. .xlsx Isto acontece quando o arquivo de um dos dois membros da equipa é executado. AutoFilterXMLLoader.load_auto_filter() falha silenciosamente devido a XML malformado no arquivo de origem. Verifique o XLSX’s xl/autofilters/autofilter*.xml Se o ficheiro foi criado externamente, certifique-se de que está em conformidade com a ECMA-376. AutoFilter.range, filter_columns, e sort_state inspeccionar o estado de carga após a carregagem.

Arquivos XLSX encriptados não podem ser lidos

Os sintomas incluem: NotImplementedError: Standard encryption is not yet supported quando se tenta abrir um código criptografado. .xlsx FOSS só suporta criptografia ágil (ECMA-376 Parte 2, Seção 4) via AgileEncryptionParameters.Os arquivos criptografados com a encriptação XOR ou ECMA-376 padrão não são suportados. Use CFBReader.read_encryption_info() apenas se o ficheiro utilizar a criptografia ágil; caso contrário, deve ser decodificado externamente antes do carregamento.

`Cell` Valores não analisados corretamente a partir do XML

Os sintomas incluem valores de data incorretos, cadeias numéricas mal interpretadas como números ou valores com erros (por exemplo:., #N/A) não reconhecido. CellValueHandler.parse_value_from_xml() é utilizado com o erro de cell_type ou ausente. shared_strings Contexto. cell_type corresponde à ECMA-376 t atributo (por exemplo,., 's' para cordas partilhadas, 'n' (para número), e fornecer um conjunto de dados, shared_strings lista para tipos de cadeias. 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 as suas causas e soluções.

Erro de identificação	Causa da morte	Correção
`NotImplementedError: Standard encryption is not yet supported`	Tentativa de ler ou escrever XLSX criptografado utilizando encriptação não ágil (por exemplo, XOR, RC4).	Utilização: `AgileEncryptionParameters` e assegurar que o ficheiro utiliza a criptografia ágil (ECMA-376 Parte 2, Secção 4).
`NotImplementedError: Only Agile encryption is currently supported`	Utilização de: `CFBWriter` ou a) `CFBReader` com parâmetros de encriptação diferentes dos Agile.	Configurar a criptografia via `AgileEncryptionParameters` Antes de ligares. `write()` ou a) `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Criação de um gráfico do tipo não incluído no anexo I. `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`	Salvar tipos de gráficos não suportados (por exemplo, WATERFALL, BOX_WHISKER) em XML.	Utilização apenas apoiada `ChartType` valores ao guardar gráficos via `xml_chart_saver`.
`ValueError: Invalid CSV content`	Dados CSV malformados transmitidos a: `CSVHandler.load_csv_from_string()` ou a) `load_csv()`.	Validação da sintaxe CSV antes do carregamento.
`ValueError: Cell value type mismatch`	Transmissão de um tipo incompatível para o `CellValueHandler.format_value_for_xml()` ou a) `parse_value_from_xml()`.	Utilização: `CellValueHandler.get_cell_type()` Para determinar o tipo de célula correto antes da formatação ou análise.

Obter ajuda

Para Aspose.Cells FOSS, informe problemas ou solicite recursos via GitHub Issues. Revise a documentação para classes como AutoFilter, Cell, CSVHandler, e AgileEncryptionParameters.Envolva a comunidade em Discussões do GitHub para perguntas gerais sobre o uso da biblioteca nos fluxos de trabalho Python.

Questões do GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
Discussões do GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
Referência API: https://reference.aspose.org/cells/python/

Ver também:

Para obter orientações relacionadas sobre o tratamento de questões comuns em Aspose.Cells FOSS, consulte a documentação para classes principais como: Cell, AutoFilter, CSVHandler, e AgileEncryptionParameters.