Guies de resolució de problemes

Problemes comuns

Aquesta secció cobreix problemes freqüents que es troben en utilitzar Aspose.Cells FOSS a Python, específicament amb classes de la superfície de l’API com ara Cell, AutoFilter, CSVHandler, i CFBReader.

La importació CSV falla amb errors de codificació

Els símptomes inclouen text desordenat o UnicodeDecodeError en carregar fitxers CSV. Això ocorre quan el fitxer CSV utilitza una codificació que no és UTF-8 (p. ex., cp1252 o Shift-JIS). Per solucionar-ho, converteix el fitxer a UTF-8 abans de carregar-lo, o passa un 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` No s’aplica després de carregar XLSX

Els símptomes inclouen controls de filtre desapareguts o dades sense filtrar després de carregar un .xlsx fitxer. Això passa quan AutoFilterXMLLoader.load_auto_filter() fallada silenciosa a causa d’un XML mal format al fitxer d’origen. Verifica que el XLSX’s xl/autofilters/autofilter*.xml estigui ben format. Si el fitxer es va crear externament, assegura’t que compleixi l’ECMA-376. Utilitza AutoFilter.range, filter_columns, i sort_state per inspeccionar l’estat carregat després de la càrrega.

No es poden llegir fitxers XLSX encriptats

Els símptomes inclouen NotImplementedError: Standard encryption is not yet supported en intentar obrir un fitxer encriptat .xlsx fitxer. Aspose.Cells FOSS només admet el xifrat Agile (ECMA-376 Part 2, Section 4) a través de AgileEncryptionParameters. Els fitxers encriptats amb XOR antic o amb el xifrat estàndard ECMA-376 no són compatibles. Utilitzeu CFBReader.read_encryption_info() només si el fitxer utilitza el xifrat Agile; en cas contrari, desxifra externament abans de la càrrega.

`Cell` Valors que no s’analitzen correctament des d’XML

Els símptomes inclouen valors de data incorrectes, cadenes numèriques interpretades erròniament com a nombres, o valors d’error (p. ex., #N/A) no reconeguts. Això ocorre quan CellValueHandler.parse_value_from_xml() s’utilitza amb incorrecte cell_type o absent shared_strings context. Assegureu cell_type coincideix amb l’ECMA-376 t atribut (p. ex., 's' per shared string, 'n' per number), i proporcioneu una poblada shared_strings llista per a tipus de cadena. Utilitzeu CellValueHandler.get_cell_type() per validar els tipus inferits abans d’analitzar.

Missatges d’error

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, i AutoFilterXMLLoader, juntament amb les seves causes i solucions.

Error	Causa	Correcció
`NotImplementedError: Standard encryption is not yet supported`	Intentant llegir o escriure un XLSX encriptat utilitzant una encriptació que no és Agile (p. ex., XOR, RC4).	Utilitzeu `AgileEncryptionParameters` i assegureu-vos que el fitxer utilitza l’encriptació Agile (ECMA-376 Part 2, Secció 4).
`NotImplementedError: Only Agile encryption is currently supported`	Utilitzant `CFBWriter` o `CFBReader` amb paràmetres d’encriptació diferents d’Agile.	Configureu l’encriptació via `AgileEncryptionParameters` abans de cridar `write()` o `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Creant un gràfic d’un tipus que no es troba a `ChartType.LINE`, BAR, PIE, AREA, o STOCK.	Limita la creació de gràfics als tipus compatibles: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Desant tipus de gràfic no compatibles (p. ex., WATERFALL, BOX_WHISKER) a XML.	Utilitza només els compatibles `ChartType` valors en desar gràfics mitjançant `xml_chart_saver`.
`ValueError: Invalid CSV content`	Dades CSV malformades passades a `CSVHandler.load_csv_from_string()` o `load_csv()`.	Valida la sintaxi CSV abans de carregar.
`ValueError: Cell value type mismatch`	Passant un tipus incompatible a `CellValueHandler.format_value_for_xml()` o `parse_value_from_xml()`.	Utilitza `CellValueHandler.get_cell_type()` per determinar el tipus de cel·la correcte abans de formatar o analitzar.

Obtenint ajuda

Per al FOSS de Aspose.Cells, informa d’incidències o sol·licita funcionalitats a través de GitHub Issues. Revisa la documentació de classes com AutoFilter, Cell, CSVHandler, i AgileEncryptionParameters. Interactua amb la comunitat a GitHub Discussions per a preguntes generals sobre l’ús de la biblioteca en fluxos de treball de Python.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
Debats a GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
Referència de l’API: https://reference.aspose.org/cells/python/

Vegeu també

Per a orientació relacionada sobre com gestionar problemes comuns al FOSS de Aspose.Cells, revisa la documentació de les classes principals com Cell, AutoFilter, CSVHandler, i AgileEncryptionParameters.