Felsökningsguider

Vanliga problem

Detta avsnitt täcker vanliga problem som uppstår vid användning av Aspose.Cells FOSS i Python, specifikt med klasser från API-ytan såsom Cell, AutoFilter, CSVHandler, och CFBReader.

CSV‑import misslyckas med kodningsfel

Symptom inkluderar förvrängd text eller UnicodeDecodeError vid inläsning av CSV-filer. Detta sker när CSV-filen använder en icke-UTF-8-kodning (t.ex. cp1252 eller Shift-JIS). För att åtgärda, konvertera filen till UTF-8 innan inläsning, eller skicka en CSVLoadOptions instans till CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` Ej tillämpad efter inläsning av XLSX

Symptom inkluderar saknade filterkontroller eller ofiltrerad data efter inläsning av en .xlsx fil. Detta händer när AutoFilterXMLLoader.load_auto_filter() misslyckas tyst på grund av felaktig XML i källfilen. Verifiera att XLSX:ens xl/autofilters/autofilter*.xml är välformad. Om filen skapades externt, säkerställ att den följer ECMA-376. Använd AutoFilter.range, filter_columns, och sort_state för att inspektera laddat tillstånd efter inläsning.

Krypterade XLSX‑filer kan inte läsas

Symptom inkluderar NotImplementedError: Standard encryption is not yet supported vid försök att öppna en krypterad .xlsx fil. Aspose.Cells FOSS stödjer endast Agile-kryptering (ECMA-376 Part 2, Section 4) via AgileEncryptionParameters. Filer krypterade med äldre XOR eller standard ECMA-376-kryptering stöds inte. Använd CFBReader.read_encryption_info() endast om filen använder Agile-kryptering; annars, dekryptera externt innan inläsning.

`Cell` Värden parsas inte korrekt från XML

Symptom inkluderar felaktiga datumvärden, numeriska strängar som misstolkas som tal, eller felvärden (t.ex., #N/A) känns inte igen. Detta inträffar när CellValueHandler.parse_value_from_xml() används med felaktig cell_type eller saknas shared_strings kontext. Säkerställ cell_type matchar ECMA-376 t attribut (t.ex., 's' för delad sträng, 'n' för tal), och tillhandahåll en ifylld shared_strings lista för strängtyper. Använd CellValueHandler.get_cell_type() för att validera härledda typer innan parsning.

Felmeddelanden

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, och AutoFilterXMLLoader, tillsammans med deras orsaker och åtgärder.

Fel	Orsak	Åtgärd
`NotImplementedError: Standard encryption is not yet supported`	Försöker läsa eller skriva krypterad XLSX med icke-Agile-kryptering (t.ex. XOR, RC4).	Använd `AgileEncryptionParameters` och säkerställ att filen använder Agile-kryptering (ECMA-376 Part 2, Section 4).
`NotImplementedError: Only Agile encryption is currently supported`	Använder `CFBWriter` eller `CFBReader` med krypteringsparametrar som inte är Agile.	Konfigurera kryptering via `AgileEncryptionParameters` innan du anropar `write()` eller `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	Skapar ett diagram av en typ som inte finns i `ChartType.LINE`, BAR, PIE, AREA, eller STOCK.	Begränsa diagramskapande till stödda typer: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Sparar ej stödda diagramtyper (t.ex. WATERFALL, BOX_WHISKER) till XML.	Använd endast stödda `ChartType` värden när du sparar diagram via `xml_chart_saver`.
`ValueError: Invalid CSV content`	Felaktig CSV-data skickad till `CSVHandler.load_csv_from_string()` eller `load_csv()`.	Validera CSV-syntax innan inläsning.
`ValueError: Cell value type mismatch`	Skickar en inkompatibel typ till `CellValueHandler.format_value_for_xml()` eller `parse_value_from_xml()`.	Använd `CellValueHandler.get_cell_type()` för att bestämma rätt celltyp innan formatering eller parsning.

Få hjälp

För Aspose.Cells FOSS, rapportera problem eller begär funktioner via GitHub Issues. Granska dokumentationen för klasser som AutoFilter, Cell, CSVHandler, och AgileEncryptionParameters. Engagera dig i communityn på GitHub Discussions för allmänna frågor om att använda biblioteket i Python-arbetsflöden.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
GitHub-diskussioner: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
API-referens: https://reference.aspose.org/cells/python/

Se även

För relaterad vägledning om hur du hanterar vanliga problem i Aspose.Cells FOSS, granska dokumentationen för kärnklasser såsom Cell, AutoFilter, CSVHandler, och AgileEncryptionParameters.