Hibakeresési útmutatók

Általános problémák

Ez a szakasz a Aspose.Cells FOSS Python használata során gyakran előforduló problémákat tárgyalja, különösen az API felület osztályaival, például Cell, AutoFilter, CSVHandler, és CFBReader.

CSV importálás hibát jelez kódolási hibákkal

A tünetek közé tartozik a torz szöveg vagy UnicodeDecodeError CSV-fájlok betöltésekor. Ez akkor fordul elő, ha a CSV-fájl nem UTF-8 kódolást használ (például cp1252 vagy Shift-JIS). A javításhoz konvertálja a fájlt UTF-8 formátumba a betöltés előtt, vagy adjon át egy CSVLoadOptions példányt a CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` Nem alkalmazva XLSX betöltése után

A tünetek közé tartozik a hiányzó szűrővezérlők vagy a szűretlen adatok egy .xlsx fájl betöltése után. Ez akkor történik, amikor AutoFilterXMLLoader.load_auto_filter() csendesen hibázik a forrásfájl hibás XML-je miatt. Ellenőrizze az XLSX xl/autofilters/autofilter*.xml helyes szerkezetű-e. Ha a fájlt külsőleg hozták létre, győződjön meg róla, hogy megfelel az ECMA-376 szabványnak. Használja AutoFilter.range, filter_columns, és sort_state a betöltött állapot ellenőrzéséhez a betöltés után.

Titkosított XLSX fájlok nem olvashatók

A tünetek közé tartozik NotImplementedError: Standard encryption is not yet supported amikor titkosított .xlsx fájlt. A Aspose.Cells FOSS csak az Agile titkosítást (ECMA-376 Part 2, Section 4) támogatja a AgileEncryptionParameters. A régi XOR vagy a szabványos ECMA-376 titkosítással titkosított fájlok nem támogatottak. Használja CFBReader.read_encryption_info() csak akkor, ha a fájl Agile titkosítást használ; egyébként dekódold külsőleg a betöltés előtt.

`Cell` Az értékek nem kerülnek helyesen feldolgozásra XML-ből

A tünetek közé tartozik a helytelen dátumértékek, a numerikus karakterláncok számként való félreértelmezése, vagy hibaértékek (például., #N/A) nem ismerhető fel. Ez akkor fordul elő, amikor CellValueHandler.parse_value_from_xml() helytelenül van használva cell_type vagy hiányzik shared_strings környezetben. Biztosítsa cell_type megegyezik az ECMA-376 t attribútummal (például,., 's' a megosztott karakterlánc esetén, 'n' a szám esetén), és adjon meg egy feltöltött shared_strings listát a karakterlánc típusokhoz. Használja CellValueHandler.get_cell_type() az előrejelzett típusok ellenőrzéséhez a feldolgozás előtt.

Hibaüzenetek

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, és AutoFilterXMLLoader, valamint azok okait és javításait.

Hiba	Ok	Javítás
`NotImplementedError: Standard encryption is not yet supported`	Megpróbálja olvasni vagy írni a titkosított XLSX-et nem Agile titkosítással (például XOR, RC4).	Használja `AgileEncryptionParameters` és biztosítsa, hogy a fájl az Agile titkosítást használja (ECMA-376 Part 2, Section 4).
`NotImplementedError: Only Agile encryption is currently supported`	Használva `CFBWriter` vagy `CFBReader` az Agile-től eltérő titkosítási paraméterekkel.	Titkosítás beállítása a következővel `AgileEncryptionParameters` hívás előtt `write()` vagy `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Diagram létrehozása olyan típusú, amely nincs a `ChartType.LINE`, BAR, PIE, AREA vagy STOCK.	Korlátozza a diagram létrehozását a támogatott típusokra: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Nem támogatott diagramtípusok (pl. WATERFALL, BOX_WHISKER) mentése XML-be.	Csak a támogatott `ChartType` értékeket diagramok mentésekor a következővel `xml_chart_saver`.
`ValueError: Invalid CSV content`	Hibás CSV adatok átadva a `CSVHandler.load_csv_from_string()` vagy `load_csv()`.	Érvényesítse a CSV szintaxist betöltés előtt.
`ValueError: Cell value type mismatch`	Nem kompatibilis típus átadása a `CellValueHandler.format_value_for_xml()` vagy `parse_value_from_xml()`.	Használja `CellValueHandler.get_cell_type()` a megfelelő cellatípus meghatározásához formázás vagy elemzés előtt.

Segítség kérése

A Aspose.Cells FOSS esetén jelentse a hibákat vagy kérjen funkciókat a GitHub Issues-on keresztül. Tekintse meg a dokumentációt az olyan osztályokhoz, mint AutoFilter, Cell, CSVHandler, és AgileEncryptionParameters. Vegye fel a kapcsolatot a közösséggel a GitHub Discussions-ben általános kérdések esetén, amelyek a könyvtár Python munkafolyamataiban való használatával kapcsolatosak.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
GitHub megbeszélések: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
API hivatkozás: https://reference.aspose.org/cells/python/

Lásd még

A Aspose.Cells FOSS általános problémáinak kezelésével kapcsolatos további útmutatásért tekintse meg a dokumentációt a fő osztályokhoz, például Cell, AutoFilter, CSVHandler, és AgileEncryptionParameters.