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_json

JsonSaveOptions

الخيارات التي تتحكم في كيفية تسلسل ورقة العمل إلى 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}
  ]
}

انظر أيضًا

 العربية