أدلة استكشاف الأخطاء وإصلاحها

مشكلات شائعة

يغطي هذا القسم المشكلات المتكررة التي تُواجه عند استخدام Aspose.Cells FOSS في Python، وبشكل خاص مع الفئات من سطح API مثل Cell, AutoFilter, CSVHandler, و CFBReader.

فشل استيراد CSV بسبب أخطاء الترميز

تشمل الأعراض نصًا مشوشًا أو UnicodeDecodeError عند تحميل ملفات CSV. يحدث هذا عندما يستخدم ملف CSV ترميزًا غير UTF-8 (مثال: cp1252 أو Shift-JIS). لإصلاح ذلك، حوّل الملف إلى UTF-8 قبل التحميل، أو مرّر 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

تشمل الأعراض فقدان عناصر التحكم في الفلتر أو بيانات غير مفلترة بعد تحميل .xlsx ملف. يحدث هذا عندما AutoFilterXMLLoader.load_auto_filter() يفشل بصمت بسبب XML غير صالح في ملف المصدر. تحقق من صحة XLSX xl/autofilters/autofilter*.xml صحيح البنية. إذا تم إنشاء الملف خارجيًا، تأكد من توافقه مع ECMA-376. استخدم AutoFilter.range, filter_columns,، و sort_state لفحص الحالة المحملة بعد التحميل.

لا يمكن قراءة ملفات XLSX المشفرة

تشمل الأعراض 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() للتحقق من صحة الأنواع المستنتجة قبل التحليل.

رسائل الأخطاء

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()` لتحديد نوع الخلية الصحيح قبل التنسيق أو التحليل.

الحصول على المساعدة

بالنسبة إلى Aspose.Cells FOSS، أبلغ عن المشكلات أو اطلب ميزات عبر GitHub Issues. راجع الوثائق للفئات مثل AutoFilter, Cell, CSVHandler,، و AgileEncryptionParameters. تفاعل مع المجتمع على GitHub Discussions لطرح أسئلة عامة حول استخدام المكتبة في سير عمل Python.

قضايا GitHub: https://github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Python/issues
مناقشات GitHub: 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.