JsonHandler — Aspose.Cells FOSS for Python API Reference
يمكن لـ aspose-cells-foss تصدير بيانات ورقة العمل إلى JSON عبر JsonHandler الفئة. يمثل الناتج كل صف ككائن JSON يتم تعيينه بواسطة عنوان العمود، ويتم جمعه في مصفوفة.
Enumerations: aspose.cells_foss
from aspose.cells_foss import JsonHandler, JsonSaveOptions
from aspose.cells_foss import save_workbook_as_jsonJsonSaveOptions
الخيارات التي تتحكم في كيفية تسلسل ورقة العمل إلى JSON.
Enumerations
JsonSaveOptions()Enumerations
JsonSaveOptions ليس له خصائص قابلة للتكوين. مرّر مثيلاً إلى JsonHandler.save_json() لاستخدام سلوك التسلسل الافتراضي.
JsonHandler
JsonHandler يحتوي فقط على طرق ثابتة ولا يتم إنشاء مثيل له أبداً.
JsonHandler.save_json
JsonHandler.save_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> Noneيصدر ورقة العمل الأولى إلى ملف JSON في file_path. إذا options هو None, الافتراضي JsonSaveOptions يتم استخدامها.
JsonHandler.save_json_to_dict
JsonHandler.save_json_to_dict(workbook, options: JsonSaveOptions | None = None) -> dictيسلسِل ورقة العمل إلى Python dict (أو list).
يدعم aspose-cells-foss إضافة قواعد التحقق من البيانات إلى نطاقات الخلايا. تُدار قواعد التحقق من خلال ws.data_validations، وهو DataValidationCollection المرتبط بكل Worksheet.
save_workbook_as_json
save_workbook_as_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> Noneغلاف ملائم حول JsonHandler.save_json(workbook, file_path, options).
Enumerations
المثال التالي يكتب جدول مبيعات ويصدّره إلى ملف JSON بتنسيق تاريخ ISO.
from aspose.cells_foss import Workbook, JsonHandler, JsonSaveOptions
import datetime
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Sales"
# Header row
ws.cells["A1"].put_value("Date")
ws.cells["B1"].put_value("Product")
ws.cells["C1"].put_value("Amount")
# Data rows
ws.cells["A2"].put_value(datetime.date(2025, 1, 15))
ws.cells["B2"].put_value("Widget A")
ws.cells["C2"].put_value(1250.00)
ws.cells["A3"].put_value(datetime.date(2025, 1, 22))
ws.cells["B3"].put_value("Widget B")
ws.cells["C3"].put_value(840.50)
opts = JsonSaveOptions()
# Save to file
JsonHandler.save_json(wb, "sales.json", options=opts)
# Or retrieve as a Python dict
data = JsonHandler.save_json_to_dict(wb, options=opts)
print(data)مثال على الإخراج (sales.json):
{
"Sales": [
{"Date": "2025-01-15", "Product": "Widget A", "Amount": 1250.0},
{"Date": "2025-01-22", "Product": "Widget B", "Amount": 840.5}
]
}