Průvodci řešením problémů
Běžné problémy
Tato sekce popisuje časté problémy, se kterými se setkáváte při používání Aspose.Cells FOSS v Python, konkrétně s třídami z rozhraní API, jako jsou Cell, AutoFilter, CSVHandler, a CFBReader.
Import CSV selže kvůli chybám kódování
Příznaky zahrnují poškozený text nebo UnicodeDecodeError při načítání CSV souborů. K tomu dochází, když CSV soubor používá kódování jiné než UTF-8 (např. cp1252 nebo Shift-JIS). Pro opravu převeďte soubor na UTF-8 před načtením nebo předávejte CSVLoadOptions instanci do CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter Není použito po načtení XLSX
Příznaky zahrnují chybějící ovládací prvky filtrů nebo nevyfiltrovaná data po načtení .xlsx souboru. K tomu dochází, když AutoFilterXMLLoader.load_auto_filter() zmlkne tiše kvůli poškozenému XML ve zdrojovém souboru. Ověřte, že XLSX xl/autofilters/autofilter*.xml je dobře vytvořený. Pokud byl soubor vytvořen externě, ujistěte se, že odpovídá standardu ECMA-376. Použijte AutoFilter.range, filter_columns, a sort_state k prozkoumání načteného stavu po načtení.
Šifrované soubory XLSX nelze přečíst
Příznaky zahrnují NotImplementedError: Standard encryption is not yet supported při pokusu otevřít šifrovaný .xlsx soubor. Aspose.Cells FOSS podporuje pouze šifrování Agile (ECMA-376 Part 2, Section 4) prostřednictvím AgileEncryptionParameters. Soubory šifrované starším XOR nebo standardním šifrováním ECMA-376 nejsou podporovány. Použijte CFBReader.read_encryption_info() pouze pokud soubor používá šifrování Agile; jinak jej dešifrujte externě před načtením.
Cell Hodnoty se nepodařilo správně parsovat z XML
Příznaky zahrnují nesprávné datumové hodnoty, číselné řetězce nesprávně interpretované jako čísla nebo chybové hodnoty (např., #N/A) není rozpoznáno. K tomu dochází, když CellValueHandler.parse_value_from_xml() se používá s nesprávným cell_type nebo chybějícím shared_strings kontextem. Zajistěte cell_type odpovídá ECMA-376 t atributu (např., 's' pro sdílený řetězec, 'n' pro číslo), a poskytněte vyplněný shared_strings seznam pro typy řetězců. Použijte CellValueHandler.get_cell_type() k ověření odvozených typů před parsováním.
Chybové zprá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 jejich příčinami a opravami.
| Chyba | Příčina | Oprava |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Pokus o čtení nebo zápis šifrovaného XLSX pomocí ne‑Agile šifrování (např. XOR, RC4). | Použijte AgileEncryptionParameters a ujistěte se, že soubor používá šifrování Agile (ECMA-376 Part 2, Section 4). |
NotImplementedError: Only Agile encryption is currently supported | Používání CFBWriter nebo CFBReader s šifrovacími parametry jinými než Agile. | Nakonfigurujte šifrování pomocí AgileEncryptionParameters před voláním write() nebo read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Vytváření grafu typu, který není v ChartType.LINE, BAR, PIE, AREA, nebo STOCK. | Omezte vytváření grafů na podporované typy: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Ukládání nepodporovaných typů grafů (např. WATERFALL, BOX_WHISKER) do XML. | Používejte pouze podporované ChartType hodnoty při ukládání grafů pomocí xml_chart_saver. |
ValueError: Invalid CSV content | Poškozená data CSV předána do CSVHandler.load_csv_from_string() nebo load_csv(). | Ověřte syntaxi CSV před načtením. |
ValueError: Cell value type mismatch | Předání nekompatibilního typu do CellValueHandler.format_value_for_xml() nebo parse_value_from_xml(). | Použijte CellValueHandler.get_cell_type() k určení správného typu buňky před formátováním nebo parsováním. |
Získání pomoci
Pro Aspose.Cells FOSS nahlaste problémy nebo požádejte o funkce prostřednictvím GitHub Issues. Prohlédněte si dokumentaci pro třídy jako AutoFilter, Cell, CSVHandler, a AgileEncryptionParameters. Zapojte se do komunity na GitHub Discussions pro obecné otázky ohledně používání knihovny v Python pracovních postupech.
- GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- Diskuse na GitHubu: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- Reference API: https://reference.aspose.org/cells/python/
Viz také
Pro související pokyny k řešení běžných problémů v Aspose.Cells FOSS si prohlédněte dokumentaci pro základní třídy, jako jsou Cell, AutoFilter, CSVHandler, a AgileEncryptionParameters.