Feilsøkingsveiledninger
Vanlige problemer
Denne delen dekker hyppige problemer som oppstår ved bruk av Aspose.Cells FOSS i Python, spesielt med klasser fra API-overflaten som Cell, AutoFilter, CSVHandler, og CFBReader.
CSV-import mislykkes med kodingsfeil
Symptomer inkluderer forvrengt tekst eller UnicodeDecodeError ved lasting av CSV-filer. Dette skjer når CSV-filen bruker en ikke-UTF-8-koding (f.eks. cp1252 eller Shift-JIS). For å rette dette, konverter filen til UTF-8 før lasting, 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 brukt etter lasting av XLSX
Symptomer inkluderer manglende filterkontroller eller ufiltrerte data etter lasting av en .xlsx-fil. Dette skjer når AutoFilterXMLLoader.load_auto_filter() mislykkes stille på grunn av feilformatert XML i kildefilen. Verifiser at XLSX-filens xl/autofilters/autofilter*.xml er velformatert. Hvis filen ble opprettet eksternt, sørg for at den er i samsvar med ECMA-376. Bruk AutoFilter.range, filter_columns, og sort_state for å inspisere lastet tilstand etter lasting.
Krypterte XLSX-filer kan ikke leses
Symptomer inkluderer NotImplementedError: Standard encryption is not yet supported ved forsøk på å åpne en kryptert .xlsx-fil. Aspose.Cells FOSS støtter kun Agile-kryptering (ECMA-376 Del 2, Seksjon 4) via AgileEncryptionParameters. Filer kryptert med eldre XOR eller standard ECMA-376-kryptering støttes ikke. Bruk CFBReader.read_encryption_info() kun hvis filen bruker Agile-kryptering; ellers, dekrypter eksternt før lasting.
Cell-verdier parses ikke korrekt fra XML
Symptomer inkluderer feil datoverdier, numeriske strenger som mistolkes som tall, eller feilverdier (f.eks. #N/A) som ikke gjenkjennes. Dette skjer når CellValueHandler.parse_value_from_xml() brukes med feil cell_type eller manglende shared_strings-kontekst. Sørg for at cell_type samsvarer med ECMA-376 t-attributtet (f.eks. 's' for delt streng, 'n' for tall), og oppgi en utfylt shared_strings-liste for strengtyper. Bruk CellValueHandler.get_cell_type() for å validere utledede typer før parsing.
Feilmeldinger
Aspose.Cells FOSS genererer spesifikke feil under fil-I/O-, krypterings- og parsingoperasjoner. Denne delen dokumenterer vanlige feilmeldinger fra klasser som CFBReader, CFBWriter, og AutoFilterXMLLoader, sammen med årsaker og rettelser.
| Feil | Årsak | Rettelse |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Forsøk på å lese eller skrive kryptert XLSX med ikke-Agile-kryptering (f.eks. XOR, RC4). | Bruk AgileEncryptionParameters og sørg for at filen bruker Agile-kryptering (ECMA-376 Del 2, Seksjon 4). |
NotImplementedError: Only Agile encryption is currently supported | Bruk av CFBWriter eller CFBReader med krypteringsparametere som ikke er Agile. | Konfigurer kryptering via AgileEncryptionParameters før kall til write() eller read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Oppretting av et diagram av en type som ikke er i ChartType.LINE, BAR, PIE, AREA eller STOCK. | Begrens diagramoppretting til støttede typer: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Lagring av ikke-støttede diagramtyper (f.eks. WATERFALL, BOX_WHISKER) til XML. | Bruk kun støttede ChartType-verdier ved lagring av diagrammer via xml_chart_saver. |
ValueError: Invalid CSV content | Feilformaterte CSV-data sendt til CSVHandler.load_csv_from_string() eller load_csv(). | Valider CSV-syntaks før lasting. |
ValueError: Cell value type mismatch | Overføring av en inkompatibel type til CellValueHandler.format_value_for_xml() eller parse_value_from_xml(). | Bruk CellValueHandler.get_cell_type() for å fastslå riktig celletype før formatering eller parsing. |
Få hjelp
For Aspose.Cells FOSS, rapporter problemer eller be om funksjoner via GitHub-problemer. Se dokumentasjonen for klasser som AutoFilter, Cell, CSVHandler, og AgileEncryptionParameters. Engasjer deg i fellesskapet på GitHub-diskusjoner for generelle spørsmål om bruk av biblioteket i Python-arbeidsflyter.
- GitHub-problemer: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- GitHub-diskusjoner: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- API-referanse: https://reference.aspose.org/cells/python/
Se også
For relatert veiledning om håndtering av vanlige problemer i Aspose.Cells FOSS, se dokumentasjonen for kjerneklasser som Cell, AutoFilter, CSVHandler, og AgileEncryptionParameters.