Problēmu novēršanas rokasgrāmatas

Bieži sastopamās problēmas

Šajā sadaļā aplūkotas biežāk sastopamās problēmas, kas rodas, izmantojot Aspose.Cells FOSS Python vidē, īpaši ar API virsmas klasēm, piemēram, Cell, AutoFilter, CSVHandler un CFBReader.

CSV importēšana neizdodas ar kodēšanas kļūdām

Simptomi ietver sagrozītu tekstu vai UnicodeDecodeError ielādējot CSV failus. Tas notiek, kad CSV fails izmanto ne-UTF-8 kodējumu (piemēram, cp1252 vai Shift-JIS). Lai novērstu problēmu, konvertējiet failu uz UTF-8 pirms ielādes vai nododiet CSVLoadOptions instanci CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` Netiek piemērots pēc XLSX ielādes

Simptomi ietver trūkstošas filtra vadīklas vai nefiltrotus datus pēc .xlsx faila ielādes. Tas notiek, kad AutoFilterXMLLoader.load_auto_filter() klusi neizdodas nepareizi veidota XML dēļ avota failā. Pārbaudiet, vai XLSX faila xl/autofilters/autofilter*.xml ir pareizi veidots. Ja fails tika izveidots ārēji, nodrošiniet tā atbilstību ECMA-376. Izmantojiet AutoFilter.range, filter_columns un sort_state, lai pārbaudītu ielādēto stāvokli pēc ielādes.

Šifrētus XLSX failus nevar nolasīt

Simptomi ietver NotImplementedError: Standard encryption is not yet supported mēģinot atvērt šifrētu .xlsx failu. Aspose.Cells FOSS atbalsta tikai Agile šifrēšanu (ECMA-376 2. daļa, 4. sadaļa) caur AgileEncryptionParameters. Faili, kas šifrēti ar mantoto XOR vai standarta ECMA-376 šifrēšanu, netiek atbalstīti. Izmantojiet CFBReader.read_encryption_info() tikai tad, ja fails izmanto Agile šifrēšanu; pretējā gadījumā atšifrējiet ārēji pirms ielādes.

`Cell` Vērtības netiek pareizi parsētas no XML

Simptomi ietver nepareizas datuma vērtības, skaitliskas virknes, kas kļūdaini tiek interpretētas kā skaitļi, vai kļūdu vērtības (piemēram, #N/A), kas netiek atpazītas. Tas notiek, kad CellValueHandler.parse_value_from_xml() tiek izmantots ar nepareizu cell_type vai trūkstošu shared_strings kontekstu. Nodrošiniet, lai cell_type atbilstu ECMA-376 t atribūtam (piemēram, 's' koplietotai virknei, 'n' skaitlim), un nodrošiniet aizpildītu shared_strings sarakstu virkņu tipiem. Izmantojiet CellValueHandler.get_cell_type(), lai pirms parsēšanas apstiprinātu secinātos tipus.

Kļūdu ziņojumi

Aspose.Cells FOSS ģenerē specifiskas kļūdas failu I/O, šifrēšanas un parsēšanas operāciju laikā. Šajā sadaļā dokumentēti bieži sastopamie kļūdu ziņojumi no klasēm, piemēram, CFBReader, CFBWriter un AutoFilterXMLLoader, kā arī to cēloņi un novēršanas veidi.

Kļūda	Cēlonis	Novēršana
`NotImplementedError: Standard encryption is not yet supported`	Mēģinājums lasīt vai rakstīt šifrētu XLSX, izmantojot ne-Agile šifrēšanu (piemēram, XOR, RC4).	Izmantojiet `AgileEncryptionParameters` un nodrošiniet, ka fails izmanto Agile šifrēšanu (ECMA-376 2. daļa, 4. sadaļa).
`NotImplementedError: Only Agile encryption is currently supported`	`CFBWriter` vai `CFBReader` izmantošana ar šifrēšanas parametriem, kas nav Agile.	Konfigurējiet šifrēšanu caur `AgileEncryptionParameters` pirms `write()` vai `read_encrypted_package()` izsaukšanas.
`NotImplementedError: Unsupported chart type for creation`	Diagrammas izveide ar tipu, kas nav `ChartType.LINE`, BAR, PIE, AREA vai STOCK.	Ierobežojiet diagrammu izveidi ar atbalstītajiem tipiem: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	Neatbalstīto diagrammu tipu (piemēram, WATERFALL, BOX_WHISKER) saglabāšana XML formātā.	Izmantojiet tikai atbalstītās `ChartType` vērtības, saglabājot diagrammas caur `xml_chart_saver`.
`ValueError: Invalid CSV content`	Nepareizi veidoti CSV dati nodoti `CSVHandler.load_csv_from_string()` vai `load_csv()`.	Validējiet CSV sintaksi pirms ielādes.
`ValueError: Cell value type mismatch`	Nesaderīga tipa nodošana `CellValueHandler.format_value_for_xml()` vai `parse_value_from_xml()`.	Izmantojiet `CellValueHandler.get_cell_type()`, lai noteiktu pareizo šūnas tipu pirms formatēšanas vai parsēšanas.

Palīdzības saņemšana

Lai saņemtu atbalstu Aspose.Cells FOSS jautājumos, ziņojiet par problēmām vai pieprasiet funkcijas caur GitHub Issues. Pārskatiet dokumentāciju klasēm, piemēram, AutoFilter, Cell, CSVHandler un AgileEncryptionParameters. Iesaistieties kopienā GitHub Discussions vispārīgiem jautājumiem par bibliotēkas izmantošanu Python darbplūsmās.

GitHub Issues: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
GitHub Discussions: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/discussions
API uzziņa: https://reference.aspose.org/cells/python/

Skatīt arī

Lai iegūtu saistītu norādījumu par bieži sastopamo problēmu risināšanu Aspose.Cells FOSS, pārskatiet dokumentāciju pamata klasēm, piemēram, Cell, AutoFilter, CSVHandler un AgileEncryptionParameters.