عرض بيانات JSON على صفحة HTML في Python باستخدام REST API

في عالم اليوم المهووس بالتكنولوجيا، يلعب تصور البيانات دورًا محوريًا في تقديم المعلومات بشكل فعال وشامل. تعد القدرة على إنشاء تقارير ديناميكية باستخدام بيانات وقوالب JSON بتنسيقات مختلفة مثل مستندات Word أو جداول البيانات أو التنسيق النصي أمرًا بالغ الأهمية للمطورين والشركات على حدٍ سواء. في منشور المدونة هذا، سنوجه مطوري Python حول كيفية الاستفادة من GroupDocs.Assembly Cloud REST API وPython SDK الخاص بها لتحميل بيانات التقرير في شكل JSON وملف قالب، ثم عرض التقارير التي تم إنشاؤها على [HTML][ 1 صفحة. توفر واجهة برمجة التطبيقات (API) مجموعة من الميزات مثل المخططات والجداول والصور والرموز الشريطية والمزيد لإنشاء تقارير جذابة وغنية بالمعلومات.

المتطلبات الأساسية:

قبل البدء، تأكد من توفر ما يلي:

تم تثبيت لغة بايثون على نظامك.
تثبيت GroupDocs.Assembly Cloud SDK لـ Python.
حساب GroupDocs.Assembly Cloud نشط ببيانات اعتماد API صالحة.
نموذج بيانات وقوالب للاختبار (سنستخدم نموذج بيانات JSON التالي ونموذج التقرير).

نموذج لبيانات JSON

احفظ البيانات التالية في ملف JSON.

\[
	{
		"Name":"John Smith","Contract":\[
		{"Client":{"Name":"A Company"},"Price":1200000},
		{"Client":{"Name":"B Ltd."},"Price":750000},
		{"Client":{"Name":"C & D"},"Price":350000}\]
	},
	{
		"Name":"Tony Anderson","Contract":\[
		{"Client":{"Name":"E Corp."},"Price":650000},
		{"Client":{"Name":"F & Partners"},"Price":550000}\]
	},
	{
		"Name":"July James","Contract":\[
		{"Client":{"Name":"G & Co."},"Price":350000},
		{"Client":{"Name":"H Group"},"Price":250000},
		{"Client":{"Name":"I & Sons"},"Price":100000},
		{"Client":{"Name":"J Ent."},"Price":100000}\]
	}
\]

نموذج النموذج

قم بإنشاء القالب التالي في TXT أو DOCX أو التنسيق المطلوب لتكرار بيانات المديرين مع عملائهم وتفاصيلهم. ثم تابع التعليمات البرمجية لإنشاء التقرير.

<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

النقاط التي يجب تغطيتها:

ابدأ باستخدام Python HTML Report Generator SDK
بدء تشغيل عميل API
تحميل القالب وملفات مصدر البيانات
عرض بيانات JSON على صفحة HTML
تحميل ملف HTML

قم بتكوين حزمة SDK لمولد تقارير Python HTML

للبدء، قم بتثبيت GroupDocs.Assembly Cloud SDK for Python إلى مشروع Python الخاص بك باستخدام pip ([package installer for Python]]) باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs-assembly-cloud

قم بتشغيل عميل API

الآن، يرجى الحصول على معرف العميل وسر العميل من لوحة التحكم وإضافة الرمز كما هو موضح أدناه:

	import groupdocsassemblycloud as assembly

	# Get app_sid & app_key from https://dashboard.groupdocs.cloud after free registration.
	app_sid = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
	app_key = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

	# Get File API configurations.
	configuration = assembly.Configuration(app_sid, app_key)
	configuration.api_base_url = "https://api.groupdocs.cloud"
	storage_name = "LocalStorage"

view raw initialize-API-client.py hosted with ❤ by GitHub

تحميل مصدر البيانات وملفات القالب

أولاً، قم بتحميل مصدر البيانات وملفات القالب إلى السحابة باستخدام مثال الكود الموضح أدناه:

	# Create an instance of the file API
	file_api = groupdocsassemblycloud.FileApi.from_config(configuration)

	# Call upload file request
	request = groupdocsassemblycloud.UploadFileRequest("python-testing\input-sample-file.json", "H:\\groupdocs-cloud-data\\input-sample-file.json", "storage_name")

	# Upload file to the cloud
	response = file_api.upload_file(request)
	print(response.uploaded)

view raw upload-file.py hosted with ❤ by GitHub

ونتيجة لذلك، ستكون الملفات التي تم تحميلها متاحة في قسم الملفات بلوحة التحكم الخاصة بك على السحابة.

عرض بيانات JSON على صفحة HTML باستخدام Python

لعرض بيانات JSON على صفحة HTML، يرجى اتباع الخطوات الواردة أدناه:

قم بإنشاء مثيل AssemblyApi باستخدام Client_id وclient_secret.
قم بإعداد معلومات القالب باستخدام مسار الملف واسم التخزين ومعرف الإصدار وكلمة المرور.
قم بإعداد طلب التجميع باستخدام AssembleOptions مع بيانات التقرير ومعلومات القالب ومسار الإخراج وحفظ التنسيق.
قم بإنشاء تقرير HTML باستخدام طريقة AssemblyApi.assemble_document(AssembleOptions).

يوضح مثال التعليمات البرمجية التالي كيفية عرض بيانات JSON على صفحة HTML باستخدام Python SDK لمولد تقارير HTML REST API.

	import groupdocsassemblycloud as assembly

	client_id = "XXXX-XXXX-XXXX-XXXX"
	client_secret = "XXXXXXXXXXXXXXXX"

	assemblyAPI = assembly.AssemblyApi(client_id,client_secret )

	# Set up template info
	templateInfo = assembly.TemplateFileInfo()
	templateInfo.file_path= 'Python_Testing/template.txt'
	templateInfo.storage_name= 'LocalStorage'
	templateInfo.version_id= ''
	templateInfo.password='abc123'

	# Prepare assemble request
	options=assembly.AssembleOptions()
	options.report_data = 'Python_Testing/report-data.json';
	options.template_file_info = templateInfo
	options.output_path = 'Python_Testing/report.html';
	options.save_format = 'html'

	# Generate HTML report
	assemblyAPI.assemble_document(options)

view raw generate-html-report.py hosted with ❤ by GitHub

تحميل ملف HTML

يقوم الكود الوارد في الخطوة السابقة بحفظ ملف HTML المحول على السحابة. لتنزيله، يمكنك استخدام مقتطف التعليمات البرمجية التالي.

	# Create instance of the API
	file_api = groupdocsassemblycloud.FileApi.from_config(configuration)

	request = groupdocs_conversion_cloud.DownloadFileRequest('Python_Testing/report.html', my_storage)
	response = file_api.download_file(request)

	# Move downloaded file to your working directory
	shutil.move(response, "C:\\Files\\")

view raw download-file.py hosted with ❤ by GitHub

خاتمة

في منشور المدونة هذا، تناولنا عملية عرض بيانات JSON على صفحة HTML باستخدام GroupDocs.Assembly Cloud REST API وPython SDK الخاص بها. تسمح واجهة برمجة التطبيقات القوية هذه للمطورين بإنشاء تقارير ديناميكية بتنسيقات مختلفة بسهولة، والاستفادة من البيانات من مصادر وقوالب JSON أو XML بتنسيقات مختلفة مثل مستندات Word أو جداول البيانات أو الملفات النصية.

علاوة على ذلك، يمكنك معرفة المزيد حول GroupDocs.Assembly Cloud API باستخدام الوثائق. نوفر أيضًا قسمًا مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. الكود المصدري الكامل لـ Python SDK متاح مجانًا على Github.

أخيرًا، نستمر في كتابة مقالات مدونة جديدة بتنسيقات ملفات مختلفة وتحليلها باستخدام REST API. لذا يرجى التواصل للحصول على آخر التحديثات. ترميز سعيد!

طرح سؤال

في حالة وجود أي استفسارات أو ارتباك حول مولد تقارير HTML، فلا تتردد في الاتصال بنا عبر [المنتدى] الخاص بنا17.

أنظر أيضا

فيما يلي بعض المقالات ذات الصلة التي قد تجدها مفيدة:

المتطلبات الأساسية:#

نموذج لبيانات JSON#

نموذج النموذج#

النقاط التي يجب تغطيتها:#

قم بتكوين حزمة SDK لمولد تقارير Python HTML#

قم بتشغيل عميل API#

تحميل مصدر البيانات وملفات القالب#

عرض بيانات JSON على صفحة HTML باستخدام Python#

تحميل ملف HTML#

خاتمة#

طرح سؤال#

أنظر أيضا#