Vodiči za rješavanje problema
Uobičajeni problemi
Ovaj odjeljak pokriva česte probleme s kojima se susreće pri korištenju Aspose.Cells FOSS u Python, posebno s klasama iz API površine poput Cell, AutoFilter, CSVHandler, i CFBReader.
Uvoz CSV-a ne uspijeva zbog pogrešaka kodiranja
Simptomi uključuju iskrivljen tekst ili UnicodeDecodeError prilikom učitavanja CSV datoteka. To se događa kada CSV datoteka koristi kodiranje koje nije UTF-8 (npr., cp1252 ili Shift-JIS). Za rješenje, pretvorite datoteku u UTF-8 prije učitavanja ili proslijedite CSVLoadOptions instancu u CSVHandler.load_csv():
from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions
opts = CSVLoadOptions()
wb = Workbook()
CSVHandler.load_csv(wb, "data.csv", opts)AutoFilter Nije primijenjeno nakon učitavanja XLSX
Simptomi uključuju nedostajuće kontrole filtra ili nefiltrirane podatke nakon učitavanja .xlsx datoteke. To se događa kada AutoFilterXMLLoader.load_auto_filter() tiho ne uspije zbog neispravnog XML-a u izvornoj datoteci. Provjerite da je XLSX-ova xl/autofilters/autofilter*.xml ispravno oblikovana. Ako je datoteka stvorena izvan sustava, osigurajte da je u skladu s ECMA-376. Koristite AutoFilter.range, filter_columns, i sort_state za pregled učitanog stanja nakon učitavanja.
Šifrirane XLSX datoteke ne mogu se pročitati
Simptomi uključuju NotImplementedError: Standard encryption is not yet supported prilikom pokušaja otvaranja šifrirane .xlsx datoteke. Aspose.Cells FOSS podržava samo Agile šifriranje (ECMA-376 Part 2, Section 4) putem AgileEncryptionParameters. Datoteke šifrirane naslijeđenim XOR-om ili standardnim ECMA-376 šifriranjem nisu podržane. Koristite CFBReader.read_encryption_info() samo ako datoteka koristi Agile šifriranje; u suprotnom, dešifrirajte je izvan sustava prije učitavanja.
Cell Vrijednosti se ne parsiraju ispravno iz XML-a
Simptomi uključuju netočne datumske vrijednosti, numeričke stringove koji se pogrešno tumače kao brojevi ili vrijednosti grešaka (npr., #N/A) nisu prepoznate. Ovo se događa kada CellValueHandler.parse_value_from_xml() se koristi s neispravnim cell_type ili nedostaje shared_strings kontekstom. Osigurajte cell_type odgovara ECMA-376 t atributu (npr., 's' za zajednički niz, 'n' za broj), i pružite popunjen shared_strings popis za tipove nizova. Upotrijebite CellValueHandler.get_cell_type() za provjeru izvedenih tipova prije parsiranja.
Poruke o greškama
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, i AutoFilterXMLLoader, zajedno s njihovim uzrocima i rješenjima.
| Greška | Uzrok | Rješenje |
|---|---|---|
NotImplementedError: Standard encryption is not yet supported | Pokušaj čitanja ili pisanja šifriranog XLSX-a koristeći ne‑Agile šifriranje (npr., XOR, RC4). | Upotrijebite AgileEncryptionParameters i osigurajte da datoteka koristi Agile šifriranje (ECMA-376 Part 2, Section 4). |
NotImplementedError: Only Agile encryption is currently supported | Korištenje CFBWriter ili CFBReader s parametrima šifriranja koji nisu Agile. | Konfigurirajte šifriranje putem AgileEncryptionParameters prije poziva write() ili read_encrypted_package(). |
NotImplementedError: Unsupported chart type for creation | Stvaranje grafikona vrste koja nije u ChartType.LINE, BAR, PIE, AREA ili STOCK. | Ograničite stvaranje grafikona na podržane vrste: LINE, BAR, PIE, AREA, STOCK. |
NotImplementedError: Only line, bar, pie, area and stock charts are currently supported | Spremanje nepodržanih vrsta grafikona (npr., WATERFALL, BOX_WHISKER) u XML. | Koristite samo podržane ChartType vrijednosti pri spremanju grafikona putem xml_chart_saver. |
ValueError: Invalid CSV content | Neispravni CSV podaci proslijeđeni u CSVHandler.load_csv_from_string() ili load_csv(). | Provjerite CSV sintaksu prije učitavanja. |
ValueError: Cell value type mismatch | Prosljeđivanje nekompatibilnog tipa u CellValueHandler.format_value_for_xml() ili parse_value_from_xml(). | Koristite CellValueHandler.get_cell_type() za određivanje ispravnog tipa ćelije prije formatiranja ili parsiranja. |
Dobivanje pomoći
Za Aspose.Cells FOSS, prijavite probleme ili zatražite značajke putem GitHub Issues. Pregledajte dokumentaciju za klase poput AutoFilter, Cell, CSVHandler, i AgileEncryptionParameters. Angažirajte zajednicu na GitHub Discussions za opća pitanja o korištenju biblioteke u Python radnim tokovima.
- GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
- GitHub rasprave: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
- API referenca: https://reference.aspose.org/cells/python/
Vidi također
Za povezane smjernice o rješavanju uobičajenih problema u Aspose.Cells FOSS, pregledajte dokumentaciju za osnovne klase poput Cell, AutoFilter, CSVHandler, i AgileEncryptionParameters.