Probleemoplossingsgidsen
Veelvoorkomende problemen
Deze sectie behandelt veelvoorkomende problemen die optreden bij het gebruik van Aspose.Cells FOSS in Python, specifiek met klassen van de API-oppervlakte zoals Cell, AutoFilter, CSVHandler, en CFBReader.
CSV-import mislukt door coderingsfouten
Symptomen omvatten onleesbare tekst of UnicodeDecodeError bij het laden van CSV‑bestanden. Dit gebeurt wanneer het CSV‑bestand een niet‑UTF‑8‑codering gebruikt (bijv. cp1252 of Shift-JIS). Om dit op te lossen, converteer het bestand naar UTF-8 vóór het laden, of geef een CSVLoadOptions instantie aan CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter Niet toegepast na het laden van XLSX
Symptomen omvatten ontbrekende filterbesturingselementen of ongefilterde gegevens na het laden van een .xlsx bestand. Dit gebeurt wanneer AutoFilterXMLLoader.load_auto_filter() stilzwijgend faalt vanwege slecht gevormde XML in het bronbestand. Controleer of de XLSX‑ xl/autofilters/autofilter*.xml goed gevormd is. Als het bestand extern is aangemaakt, zorg er dan voor dat het voldoet aan ECMA-376. Gebruik AutoFilter.range, filter_columns, en sort_state om de geladen status na het laden te inspecteren.
Versleutelde XLSX‑bestanden kunnen niet worden gelezen
Symptomen omvatten NotImplementedError: Standard encryption is not yet supported bij het proberen te openen van een versleuteld .xlsx bestand. Aspose.Cells FOSS ondersteunt alleen Agile-encryptie (ECMA-376 Deel 2, Sectie 4) via AgileEncryptionParameters. Bestanden versleuteld met legacy XOR of standaard ECMA-376-encryptie worden niet ondersteund. Gebruik CFBReader.read_encryption_info() alleen als het bestand Agile encryptie gebruikt; anders moet je het extern ontcijferen voordat je het laadt.
Cell Waarden worden niet correct geparseerd uit XML
Symptomen omvatten onjuiste datumwaarden, numerieke tekenreeksen die als getallen worden geïnterpreteerd, of foutwaarden (bijv., #N/A) niet herkend. Dit gebeurt wanneer CellValueHandler.parse_value_from_xml() wordt gebruikt met onjuiste cell_type of ontbreekt shared_strings context. Zorg ervoor dat cell_type overeenkomt met de ECMA-376 t attribuut (bijv., 's' voor gedeelde tekenreeks, 'n' voor getal), en lever een ingevulde shared_strings lijst voor tekenreeks-types. Gebruik CellValueHandler.get_cell_type() om afgeleide types te valideren vóór het parseren.
Foutmeldingen
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, en AutoFilterXMLLoader, samen met hun oorzaken en oplossingen.
| Fout | Oorzaak | Oplossing |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Poging om een versleutelde XLSX te lezen of te schrijven met niet‑Agile encryptie (bijv. XOR, RC4). | Gebruik AgileEncryptionParameters en zorg ervoor dat het bestand Agile-encryptie gebruikt (ECMA-376 Part 2, Section 4). |
NotImplementedError: Only Agile encryption is currently supported | Gebruiken CFBWriter of CFBReader met encryptieparameters anders dan Agile. | Configureer encryptie via AgileEncryptionParameters voordat u aanroept write() of read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Een diagram van een type maken dat niet in ChartType.LINE, BAR, PIE, AREA, of STOCK. | Beperk het maken van diagrammen tot ondersteunde types: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Opslaan van niet-ondersteunde diagramtypes (bijv. WATERFALL, BOX_WHISKER) naar XML. | Gebruik alleen ondersteunde ChartType waarden bij het opslaan van diagrammen via xml_chart_saver. |
ValueError: Invalid CSV content | Misvormde CSV-gegevens doorgegeven aan CSVHandler.load_csv_from_string() of load_csv(). | Valideer CSV-syntaxis voordat u laadt. |
ValueError: Cell value type mismatch | Een incompatibel type doorgeven aan CellValueHandler.format_value_for_xml() of parse_value_from_xml(). | Gebruik CellValueHandler.get_cell_type() om het juiste celtype te bepalen voordat u formatteert of parseert. |
Hulp krijgen
Voor Aspose.Cells FOSS, meld problemen of vraag functies aan via GitHub Issues. Bekijk de documentatie voor klassen zoals AutoFilter, Cell, CSVHandler, en AgileEncryptionParameters. Betrek de community op GitHub Discussions voor algemene vragen over het gebruik van de bibliotheek in Python workflows.
- GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- GitHub Discussies: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- API-referentie: https://reference.aspose.org/cells/python/
Zie ook
Voor gerelateerde richtlijnen over het omgaan met veelvoorkomende problemen in Aspose.Cells FOSS, bekijk de documentatie voor kernklassen zoals Cell, AutoFilter, CSVHandler, en AgileEncryptionParameters.