Fejlfindingsguider
Almindelige problemer
Dette afsnit dækker hyppige problemer, der opstår ved brug af Aspose.Cells FOSS i Python, særligt med klasser fra API-overfladen såsom Cell, AutoFilter, CSVHandler, og CFBReader.
CSV-import mislykkes med kodningsfejl
Symptomerne inkluderer forvrænget tekst eller UnicodeDecodeError ved indlæsning af CSV-filer. Dette sker, når CSV-filen bruger en ikke-UTF-8-kodning (f.eks. cp1252 eller Shift-JIS). For at rette dette, konverter filen til UTF-8 inden indlæsning, eller send en CSVLoadOptions-instans til CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter Ikke anvendt efter indlæsning af XLSX
Symptomerne inkluderer manglende filterkontroller eller ufiltrerede data efter indlæsning af en .xlsx-fil. Dette sker, når AutoFilterXMLLoader.load_auto_filter() mislykkes lydløst på grund af fejlformateret XML i kildefilen. Kontrollér, at XLSX-filens xl/autofilters/autofilter*.xml er velformateret. Hvis filen er oprettet eksternt, skal du sikre, at den overholder ECMA-376. Brug AutoFilter.range, filter_columns, og sort_state til at inspicere den indlæste tilstand efter indlæsning.
Krypterede XLSX-filer kan ikke læses
Symptomerne inkluderer NotImplementedError: Standard encryption is not yet supported ved forsøg på at åbne en krypteret .xlsx-fil. Aspose.Cells FOSS understøtter kun Agile-kryptering (ECMA-376 Del 2, Afsnit 4) via AgileEncryptionParameters. Filer krypteret med ældre XOR eller standard ECMA-376-kryptering understøttes ikke. Brug CFBReader.read_encryption_info() kun hvis filen bruger Agile-kryptering; ellers skal du dekryptere eksternt inden indlæsning.
Cell-værdier parses ikke korrekt fra XML
Symptomerne inkluderer forkerte datoværdier, numeriske strenge der fejlfortolkes som tal, eller fejlværdier (f.eks. #N/A) der ikke genkendes. Dette sker, når CellValueHandler.parse_value_from_xml() bruges med forkert cell_type eller manglende shared_strings-kontekst. Sørg for, at cell_type matcher ECMA-376 t-attributten (f.eks. 's' for delt streng, 'n' for tal), og angiv en udfyldt shared_strings-liste for strengtyper. Brug CellValueHandler.get_cell_type() til at validere udledte typer inden parsing.
Fejlmeddelelser
Aspose.Cells FOSS genererer specifikke fejl under fil-I/O, kryptering og parsingoperationer. Dette afsnit dokumenterer almindelige fejlmeddelelser fra klasser som CFBReader, CFBWriter, og AutoFilterXMLLoader, sammen med deres årsager og rettelser.
| Fejl | Årsag | Rettelse |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Forsøg på at læse eller skrive krypteret XLSX med ikke-Agile-kryptering (f.eks. XOR, RC4). | Brug AgileEncryptionParameters og sørg for, at filen bruger Agile-kryptering (ECMA-376 Del 2, Afsnit 4). |
NotImplementedError: Only Agile encryption is currently supported | Brug af CFBWriter eller CFBReader med krypteringsparametre der ikke er Agile. | Konfigurer kryptering via AgileEncryptionParameters inden kald af write() eller read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Oprettelse af et diagram af en type der ikke er i ChartType.LINE, BAR, PIE, AREA eller STOCK. | Begræns diagramoprettelse til understøttede typer: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Gemning af ikke-understøttede diagramtyper (f.eks. WATERFALL, BOX_WHISKER) til XML. | Brug kun understøttede ChartType-værdier ved gemning af diagrammer via xml_chart_saver. |
ValueError: Invalid CSV content | Fejlformaterede CSV-data sendt til CSVHandler.load_csv_from_string() eller load_csv(). | Valider CSV-syntaks inden indlæsning. |
ValueError: Cell value type mismatch | Aflevering af en inkompatibel type til CellValueHandler.format_value_for_xml() eller parse_value_from_xml(). | Brug CellValueHandler.get_cell_type() til at fastslå den korrekte celletype inden formatering eller parsing. |
Få hjælp
For Aspose.Cells FOSS, rapporter problemer eller anmod om funktioner via GitHub-problemer. Gennemgå dokumentationen for klasser som AutoFilter, Cell, CSVHandler, og AgileEncryptionParameters. Engager fællesskabet på GitHub-diskussioner for generelle spørgsmål om brug af biblioteket i Python-arbejdsgange.
- GitHub-problemer: 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-reference: https://reference.aspose.org/cells/python/
Se også
For relateret vejledning om håndtering af almindelige problemer i Aspose.Cells FOSS, gennemgå dokumentationen for kerneklasser som Cell, AutoFilter, CSVHandler, og AgileEncryptionParameters.