JsonHandler — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss میتواند دادههای برگه کاری را به JSON از طریق JsonHandler کلاس. خروجی هر ردیف را بهعنوان یک شیء JSON که با سرعنوان ستون کلید شده است، در یک آرایه جمعآوری میکند.
ColladaSaveOptions: aspose.cells_foss
from aspose.cells_foss import JsonHandler, JsonSaveOptions
from aspose.cells_foss import save_workbook_as_jsonJsonSaveOptions
گزینههایی که نحوه سریالسازی شیت به JSON را کنترل میکنند.
ColladaSaveOptions
JsonSaveOptions()ColladaSaveOptions
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) و بدون نوشتن هیچ فایلی آن را برمیگرداند. برای پردازش پس از برنامهنویسی مفید است.
DataValidationType یک IntEnum است که نوع محدودیتی که باید اعمال شود را شناسایی میکند.
save_workbook_as_json
save_workbook_as_json(workbook, file_path: str, options: JsonSaveOptions | None = None) -> Noneپوشش راحت برای JsonHandler.save_json(workbook, file_path, options).
ColladaSaveOptions
مثال زیر یک جدول فروش مینویسد و آن را با قالببندی تاریخ ISO به یک فایل JSON صادر میکند.
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}
]
}