Ghiduri de depanare

Ghiduri de depanare

Probleme frecvente

Această secțiune acoperă problemele frecvente întâlnite la utilizarea Aspose.Cells FOSS în Python, în special cu clasele din suprafața API precum Cell, AutoFilter, CSVHandler și CFBReader.

Importul CSV eșuează cu erori de codificare

Simptomele includ text corupt sau UnicodeDecodeError la încărcarea fișierelor CSV. Acest lucru se întâmplă când fișierul CSV folosește o codificare non-UTF-8 (de exemplu, cp1252 sau Shift-JIS). Pentru remediere, convertiți fișierul în UTF-8 înainte de încărcare sau transmiteți o instanță CSVLoadOptions la CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

AutoFilter Nu se aplică după încărcarea XLSX

Simptomele includ controale de filtrare lipsă sau date nefiltrate după încărcarea unui fișier .xlsx. Aceasta se întâmplă când AutoFilterXMLLoader.load_auto_filter() eșuează silențios din cauza unui XML malformat în fișierul sursă. Verificați că xl/autofilters/autofilter*.xml din fișierul XLSX este bine format. Dacă fișierul a fost creat extern, asigurați-vă că este conform cu ECMA-376. Folosiți AutoFilter.range, filter_columns și sort_state pentru a inspecta starea încărcată după încărcare.

Fișierele XLSX criptate nu pot fi citite

Simptomele includ NotImplementedError: Standard encryption is not yet supported când se încearcă deschiderea unui fișier .xlsx criptat. Aspose.Cells FOSS suportă numai criptarea Agile (ECMA-376 Partea 2, Secțiunea 4) prin AgileEncryptionParameters. Fișierele criptate cu XOR moștenit sau cu criptarea standard ECMA-376 nu sunt suportate. Folosiți CFBReader.read_encryption_info() numai dacă fișierul utilizează criptarea Agile; altfel, decriptați extern înainte de încărcare.

Valorile Cell nu sunt analizate corect din XML

Simptomele includ valori de dată incorecte, șiruri numerice interpretate greșit ca numere sau valori de eroare (de exemplu, #N/A) nerecunoscute. Aceasta se întâmplă când CellValueHandler.parse_value_from_xml() este utilizat cu cell_type incorect sau context shared_strings lipsă. Asigurați-vă că cell_type corespunde atributului ECMA-376 t (de exemplu, 's' pentru șir partajat, 'n' pentru număr) și furnizați o listă shared_strings completată pentru tipurile de șiruri. Folosiți CellValueHandler.get_cell_type() pentru a valida tipurile deduse înainte de analiză.

Mesaje de eroare

Aspose.Cells FOSS generează erori specifice în timpul operațiunilor de I/O fișier, criptare și analiză. Această secțiune documentează mesajele de eroare frecvente din clasele precum CFBReader, CFBWriter și AutoFilterXMLLoader, împreună cu cauzele și remedierile lor.

EroareCauzăRemediere
NotImplementedError: Standard encryption is not yet supportedÎncercare de citire sau scriere a unui XLSX criptat folosind criptare non-Agile (de exemplu, XOR, RC4).Folosiți AgileEncryptionParameters și asigurați-vă că fișierul utilizează criptarea Agile (ECMA-376 Partea 2, Secțiunea 4).
NotImplementedError: Only Agile encryption is currently supportedUtilizarea CFBWriter sau CFBReader cu parametri de criptare alții decât Agile.Configurați criptarea prin AgileEncryptionParameters înainte de a apela write() sau read_encrypted_package().
NotImplementedError: Unsupported chart type for creationCrearea unui grafic cu un tip care nu se află în ChartType.LINE, BAR, PIE, AREA sau STOCK.Limitați crearea graficelor la tipurile suportate: LINE, BAR, PIE, AREA, STOCK.
NotImplementedError: Only line, bar, pie, area and stock charts are currently supportedSalvarea tipurilor de grafice nesuportate (de exemplu, WATERFALL, BOX_WHISKER) în XML.Folosiți numai valorile ChartType suportate la salvarea graficelor prin xml_chart_saver.
ValueError: Invalid CSV contentDate CSV malformate transmise la CSVHandler.load_csv_from_string() sau load_csv().Validați sintaxa CSV înainte de încărcare.
ValueError: Cell value type mismatchTransmiterea unui tip incompatibil la CellValueHandler.format_value_for_xml() sau parse_value_from_xml().Folosiți CellValueHandler.get_cell_type() pentru a determina tipul corect de celulă înainte de formatare sau analiză.

Obținerea ajutorului

Pentru Aspose.Cells FOSS, raportați probleme sau solicitați funcții prin GitHub Issues. Consultați documentația pentru clasele precum AutoFilter, Cell, CSVHandler și AgileEncryptionParameters. Implicați-vă în comunitate pe GitHub Discussions pentru întrebări generale despre utilizarea bibliotecii în fluxurile de lucru Python.

Vezi și

Pentru îndrumări conexe privind gestionarea problemelor frecvente în Aspose.Cells FOSS, consultați documentația pentru clasele de bază precum Cell, AutoFilter, CSVHandler și AgileEncryptionParameters.

 Română