إرشادات حل المشاكل

القضايا المشتركة

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

CSV Import Fails مع أخطاء التشفير

وتشمل الأعراض النص المكسور أو UnicodeDecodeError عند تحميل ملفات CSV. هذا يحدث عندما يستخدم ملف CSV رمز غير UTF-8 (على سبيل المثال، cp1252 أو Shift-JIS).إصلاح، تحويل الملف إلى UT F-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 يدعم فقط التشفير السليم (ECMA-376 الجزء 2، القسم 4) عن طريق AgileEncryptionParameters.الملفات المشفرة مع التراث XOR أو التشفير القياسي ECMA-376 غير مدعومة. CFBReader.read_encryption_info() فقط إذا كان الملف يستخدم التشفير السريع؛ وإلا، يتم فك تشفيرها خارجيًا قبل تحميل.

`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 باستخدام التشفير غير العصبي (على سبيل المثال، XOR، RC4).	استخدام `AgileEncryptionParameters` وتأكد من أن الملف يستخدم التشفير السريع (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`,بار، بي، منطقة، أو مخزون.	الحد من إنشاء الرسم البياني إلى أنواع مدعومة: 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 للحصول على أسئلة عامة حول استخدام المكتبة في سير العمل 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.