Průvodci řešením problémů

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.

ChybaPříčinaOprava
NotImplementedError: Standard encryption is not yet supportedPokus 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 supportedPouží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 creationVytvář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 supportedUklá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 contentPoš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 mismatchPř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.

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.

 Čeština