Probleemoplossingsgidsen

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.

FoutOorzaakOplossing
NotImplementedError: Standard encryption is not yet supportedPoging 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 supportedGebruiken 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 creationEen 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 supportedOpslaan 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 contentMisvormde CSV-gegevens doorgegeven aan CSVHandler.load_csv_from_string() of load_csv().Valideer CSV-syntaxis voordat u laadt.
ValueError: Cell value type mismatchEen 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.

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.

 Nederlands