Sprievodcovia riešením problémov

Bežné problémy

Táto sekcia pokrýva časté problémy, ktoré sa vyskytujú pri používaní Aspose.Cells FOSS v Python, konkrétne s triedami z rozhrania API, ako napríklad Cell, AutoFilter, CSVHandler, a CFBReader.

Import CSV zlyhá kvôli chybám kódovania

Príznaky zahŕňajú skreslený text alebo UnicodeDecodeError pri načítavaní CSV súborov. K tomu dochádza, keď CSV súbor používa kódovanie iné ako UTF-8 (napr. cp1252 alebo Shift-JIS). Pre opravu konvertujte súbor na UTF-8 pred načítaním alebo odovzdajte CSVLoadOptions inštanciu do CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)

`AutoFilter` Neaplikované po načítaní XLSX

Príznaky zahŕňajú chýbajúce ovládacie prvky filtra alebo nefiltrované dáta po načítaní .xlsx súboru. K tomu dochádza, keď AutoFilterXMLLoader.load_auto_filter() tichý zlyhá kvôli neplatnému XML v zdrojovom súbore. Overte, že XLSX’s xl/autofilters/autofilter*.xml je dobre formátovaný. Ak bol súbor vytvorený externým spôsobom, uistite sa, že spĺňa ECMA-376. Použite AutoFilter.range, filter_columns, a sort_state na kontrolu načítaného stavu po načítaní.

Šifrované XLSX súbory nie je možné prečítať

Príznaky zahŕňajú NotImplementedError: Standard encryption is not yet supported pri pokuse otvoriť šifrovaný .xlsx súbor. Aspose.Cells FOSS podporuje iba Agile šifrovanie (ECMA-376 Part 2, Section 4) prostredníctvom AgileEncryptionParameters. Súbory šifrované starým XOR alebo štandardným ECMA-376 šifrovaním nie sú podporované. Použite CFBReader.read_encryption_info() iba ak súbor používa šifrovanie Agile; inak ho dešifrujte externým spôsobom pred načítaním.

`Cell` Hodnoty sa neparsujú správne z XML

Príznaky zahŕňajú nesprávne dátumové hodnoty, číselné reťazce nesprávne interpretované ako čísla alebo chybové hodnoty (napr., #N/A) nie je rozpoznané. Toto sa vyskytuje, keď CellValueHandler.parse_value_from_xml() sa používa s nesprávnym cell_type alebo chýbajúcim shared_strings kontextom. Zabezpečte cell_type zodpovedá ECMA-376 t atribútu (napr., 's' pre zdieľaný reťazec, 'n' pre číslo), a poskytnite vyplnený shared_strings zoznam pre typy reťazcov. Použite CellValueHandler.get_cell_type() na overenie odvodených typov pred parsovaním.

Chybové správy

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, a AutoFilterXMLLoader, spolu s ich príčinami a opravami.

Chyba	Príčina	Oprava
`NotImplementedError: Standard encryption is not yet supported`	Pokus o čítanie alebo zápis šifrovaného XLSX pomocou ne‑Agile šifrovania (napr. XOR, RC4).	Použite `AgileEncryptionParameters` a zabezpečte, aby súbor používal šifrovanie Agile (ECMA-376 Part 2, Section 4).
`NotImplementedError: Only Agile encryption is currently supported`	Použitie `CFBWriter` alebo `CFBReader` s parametrami šifrovania inými ako Agile.	Nakonfigurujte šifrovanie pomocou `AgileEncryptionParameters` pred volaním `write()` alebo `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Vytváranie grafu typu, ktorý nie je v `ChartType.LINE`, BAR, PIE, AREA, alebo STOCK.	Obmedzte vytváranie grafov na podporované typy: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Ukladanie nepodporovaných typov grafov (napr. WATERFALL, BOX_WHISKER) do XML.	Používajte iba podporované `ChartType` hodnoty pri ukladaní grafov pomocou `xml_chart_saver`.
`ValueError: Invalid CSV content`	Nesprávne formátované CSV dáta odovzdané do `CSVHandler.load_csv_from_string()` alebo `load_csv()`.	Overte syntax CSV pred načítaním.
`ValueError: Cell value type mismatch`	Odovzdanie nekompatibilného typu do `CellValueHandler.format_value_for_xml()` alebo `parse_value_from_xml()`.	Použite `CellValueHandler.get_cell_type()` na určenie správneho typu bunky pred formátovaním alebo parsovaním.

Získanie pomoci

Pre Aspose.Cells FOSS nahláste problémy alebo požadujte funkcie prostredníctvom GitHub Issues. Prezrite si dokumentáciu pre triedy ako AutoFilter, Cell, CSVHandler, a AgileEncryptionParameters. Zapojte komunitu na GitHub Discussions pre všeobecné otázky týkajúce sa používania knižnice v Python pracovných postupoch.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
Diskusie na GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
Referenčná dokumentácia API: https://reference.aspose.org/cells/python/

Pozri tiež

Pre súvisiace usmernenia pri riešení bežných problémov v Aspose.Cells FOSS si prezrite dokumentáciu pre základné triedy, ako sú Cell, AutoFilter, CSVHandler, a AgileEncryptionParameters.