راهنمای عیبیابی
مشکلات رایج
این بخش به مشکلات رایجی که هنگام استفاده از 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 Part 2, Section 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 Part 2, Section 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. برای سؤالات کلی درباره استفاده از کتابخانه در جریانهای کاری Python، با جامعه در GitHub Discussions در ارتباط باشید.
- مسائل 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.
