Trikčių šalinimo vadovai

Trikčių šalinimo vadovai

Common Issues

Šiame skyriuje aptariamos dažnos problemos, su kuriomis susiduriama naudojant Aspose.Cells FOSS Python, ypač su API paviršiaus klasėmis, tokiomis kaip Cell, AutoFilter, CSVHandler, ir CFBReader.

CSV Import Fails with Encoding Errors

Simptomai apima iškraipytą tekstą arba UnicodeDecodeError įkeliant CSV failus. Tai atsitinka, kai CSV failas naudoja ne UTF-8 koduotę (pvz., cp1252 arba Shift-JIS). Norint išspręsti, konvertuokite failą į UTF-8 prieš įkeliant arba perduokite CSVLoadOptions instanciją į CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

AutoFilter Netaikoma po XLSX įkėlimo

Simptomai apima trūkstamus filtrų valdiklius arba nefiltruotus duomenis po .xlsx failo įkėlimo. Tai įvyksta, kai AutoFilterXMLLoader.load_auto_filter() tyliai nesėkmingai dėl neteisingai suformuoto XML šaltinio faile. Patikrinkite, ar XLSX xl/autofilters/autofilter*.xml yra gerai suformuotas. Jei failas sukurtas išorėje, įsitikinkite, kad jis atitinka ECMA-376 standartą. Naudokite AutoFilter.range, filter_columns, ir sort_state norint patikrinti įkeltą būseną po įkėlimo.

Encrypted XLSX Files Cannot Be Read

Simptomai apima NotImplementedError: Standard encryption is not yet supported bandant atverti šifruotą .xlsx failą. Aspose.Cells FOSS palaiko tik Agile šifravimą (ECMA-376 Part 2, Section 4) per AgileEncryptionParameters. Failai, šifruoti senesniu XOR arba standartiniu ECMA-376 šifravimu, nepalaikomi. Naudokite CFBReader.read_encryption_info() tik jei failas naudoja Agile šifravimą; priešingu atveju, iššifruokite išorėje prieš įkeliant.

Cell Vertės neteisingai išskaitomos iš XML

Simptomai apima neteisingas datos vertes, skaitines eilutes, klaidingai interpretuojamas kaip skaičius, arba klaidos vertes (pvz., #N/A) neatpažįstamos. Tai įvyksta, kai CellValueHandler.parse_value_from_xml() naudojamas su neteisingu cell_type arba trūkstamu shared_strings kontekstas. Užtikrinti cell_type atitinka ECMA-376 t atributas (pvz., 's' skirtas shared string, 'n' skaičiaui), ir pateikti užpildytą shared_strings sąrašas eilučių tipų. Naudokite CellValueHandler.get_cell_type() norint patikrinti išvestus tipus prieš analizavimą.

Error Messages

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, ir AutoFilterXMLLoader, kartu su jų priežastimis ir pataisymais.

KlaidaPriežastisPataisyti
NotImplementedError: Standard encryption is not yet supportedBandoma skaityti arba rašyti užšifruotą XLSX naudojant ne‑Agile šifravimą (pvz., XOR, RC4).Naudoti AgileEncryptionParameters ir įsitikinkite, kad failas naudoja Agile šifravimą (ECMA-376 Part 2, Section 4).
NotImplementedError: Only Agile encryption is currently supportedNaudojant CFBWriter arba CFBReader su šifravimo parametrais, kurie nėra Agile.Konfigūruokite šifravimą per AgileEncryptionParameters prieš iškviečiant write() arba read_encrypted_package().
NotImplementedError: Unsupported chart type for creationKuriant diagramą, kurios tipas nėra ChartType.LINE, BAR, PIE, AREA, arba STOCK.Ribokite diagramų kūrimą iki palaikomų tipų: LINE, BAR, PIE, AREA, STOCK.
NotImplementedError: Only line, bar, pie, area and stock charts are currently supportedĮrašoma nepalaikomi diagramų tipai (pvz., WATERFALL, BOX_WHISKER) į XML.Naudokite tik palaikomus ChartType reikšmes, kai išsaugote diagramas per xml_chart_saver.
ValueError: Invalid CSV contentNetinkamai suformuoti CSV duomenys perduoti į CSVHandler.load_csv_from_string() arba load_csv().Patikrinkite CSV sintaksę prieš įkeliant.
ValueError: Cell value type mismatchPerduodamas nesuderinamas tipas į CellValueHandler.format_value_for_xml() arba parse_value_from_xml().Naudokite CellValueHandler.get_cell_type() nustatyti teisingą ląstelės tipą prieš formatuojant arba analizuojant.

Getting Help

Aspose.Cells FOSS atveju praneškite apie problemas arba prašykite funkcijų per GitHub Issues. Peržiūrėkite dokumentaciją klasėms, tokioms kaip AutoFilter, Cell, CSVHandler, ir AgileEncryptionParameters. Įtraukite bendruomenę į GitHub Discussions dėl bendrų klausimų apie bibliotekos naudojimą Python darbo srautų kontekste.

Žr. taip pat

Susijusiam patarimui, kaip spręsti dažnas problemas Aspose.Cells FOSS, peržiūrėkite dokumentaciją pagrindinėms klasėms, tokioms kaip Cell, AutoFilter, CSVHandler, ir AgileEncryptionParameters.

 Lietuvių