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.
| Eroare | Cauză | 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 supported | Utilizarea 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 creation | Crearea 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 supported | Salvarea 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 content | Date CSV malformate transmise la CSVHandler.load_csv_from_string() sau load_csv(). | Validați sintaxa CSV înainte de încărcare. |
ValueError: Cell value type mismatch | Transmiterea 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.
- 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
- Referință API: https://reference.aspose.org/cells/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.