מדריכי פתרון בעיות

בעיות נפוצות

סעיף זה מכסה בעיות נפוצות שנפגשות בעת השימוש ב-Aspose.Cells FOSS ב-Python, במיוחד עם מחלקות משטח ה-API כגון Cell, AutoFilter, CSVHandler, ו CFBReader.

CSV Import Fails with Encoding Errors

התסמינים כוללים טקסט מעוות או UnicodeDecodeError בעת טעינת קבצי CSV. זה קורה כאשר קובץ ה-CSV משתמש בקידוד שאינו UTF-8 (למשל, cp1252 או Shift-JIS). כדי לתקן, המר את הקובץ ל-UTF-8 לפני הטעינה, או העבר a CSVLoadOptions מופע ל CSVHandler.load_csv():

from aspose.cells_foss import Workbook, CSVHandler, CSVLoadOptions

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

`AutoFilter` לא יוחל לאחר טעינת XLSX

התסמינים כוללים חוסר בבקרי סינון או נתונים שלא סוננו לאחר טעינת an .xlsx קובץ. זה קורה כאשר AutoFilterXMLLoader.load_auto_filter() נכשל בשקט עקב XML פגום בקובץ המקור. אמת את ה-XLSX’s xl/autofilters/autofilter*.xml בעלת מבנה תקין. אם הקובץ נוצר מבחוץ, ודא שהוא תואם ל‑ECMA‑376. השתמש AutoFilter.range, filter_columns, ו sort_state כדי לבדוק את המצב הטעון לאחר הטעינה.

Encrypted XLSX Files Cannot Be Read

תסמינים כוללים NotImplementedError: Standard encryption is not yet supported בעת ניסיון לפתוח קובץ מוצפן .xlsx קובץ. Aspose.Cells FOSS תומך רק בהצפנת Agile (ECMA-376 חלק 2, סעיף 4) דרך AgileEncryptionParameters. קבצים מוצפנים עם XOR מדור קודם או הצפנה סטנדרטית של ECMA-376 אינם נתמכים. השתמש CFBReader.read_encryption_info() רק אם הקובץ משתמש בהצפנת Agile; אחרת, פענח חיצונית לפני הטעינה.

`Cell` ערכים שלא מתפרשים כראוי מ‑XML

התסמינים כוללים ערכי תאריך שגויים, מחרוזות מספריות שמפורשות כמספרים, או ערכי שגיאה (למשל,., #N/A) לא מזוהים. זה קורה כאשר CellValueHandler.parse_value_from_xml() משמש עם ערכים לא נכונים cell_type או חסרים shared_strings הקשר. ודא cell_type מתאים ל-ECMA-376 t תכונה (למשל,., 's' למחרוזת משותפת, 'n' למספר), וספק ערך ממולא shared_strings רשימה לסוגי מחרוזות. השתמש CellValueHandler.get_cell_type() לאמת סוגים שהוסקו לפני הפענוח.

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, ו AutoFilterXMLLoader, יחד עם הסיבות והפתרונות שלהם.

שגיאה	סיבה	תיקון
`NotImplementedError: Standard encryption is not yet supported`	ניסיון לקרוא או לכתוב קובץ XLSX מוצפן באמצעות הצפנה שאינה Agile (למשל, XOR, RC4).	השתמש `AgileEncryptionParameters` וודא שהקובץ משתמש בהצפנה Agile (ECMA-376 חלק 2, סעיף 4).
`NotImplementedError: Only Agile encryption is currently supported`	בשימוש `CFBWriter` או `CFBReader` עם פרמטרי הצפנה שאינם Agile.	הגדר הצפנה דרך `AgileEncryptionParameters` לפני קריאה ל `write()` או `read_encrypted_package()`.
`NotImplementedError: Unsupported chart type for creation`	יצירת תרשים מסוג שאינו ב `ChartType.LINE`, BAR, PIE, AREA, או STOCK.	הגבל יצירת גרפים לסוגים הנתמכים: LINE, BAR, PIE, AREA, STOCK.
`NotImplementedError: Only line, bar, pie, area and stock charts are currently supported`	שמירת סוגי גרפים לא נתמכים (למשל, WATERFALL, BOX_WHISKER) ל‑XML.	השתמש רק בנתמך `ChartType` ערכים בעת שמירת גרפים דרך `xml_chart_saver`.
`ValueError: Invalid CSV content`	נתוני CSV פגומים נשלחו ל‑ `CSVHandler.load_csv_from_string()` או `load_csv()`.	אמת תחביר CSV לפני הטעינה.
`ValueError: Cell value type mismatch`	העברת סוג לא תואם ל‑ `CellValueHandler.format_value_for_xml()` או `parse_value_from_xml()`.	השתמש `CellValueHandler.get_cell_type()` כדי לקבוע את סוג התא הנכון לפני עיצוב או ניתוח.

Getting Help

עבור Aspose.Cells FOSS, דווח על בעיות או בקש תכונות דרך GitHub Issues. עיין בתיעוד של מחלקות כגון AutoFilter, Cell, CSVHandler, ו AgileEncryptionParameters. פנה לקהילה ב‑GitHub Discussions עבור שאלות כלליות לגבי שימוש בספרייה בתהליכי עבודה של 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
הפניה ל‑API: https://reference.aspose.org/cells/python/

ראה גם

לקבלת הנחיות קשורות לטיפול בבעיות נפוצות ב‑Aspose.Cells FOSS, עיין בתיעוד של מחלקות הליבה כגון Cell, AutoFilter, CSVHandler, ו AgileEncryptionParameters.