في عالم اليوم المهووس بالتكنولوجيا، يلعب تصور البيانات دورًا محوريًا في تقديم المعلومات بشكل فعال وشامل. تعد القدرة على إنشاء تقارير ديناميكية باستخدام بيانات وقوالب 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
الآن، يرجى الحصول على معرف العميل وسر العميل من لوحة التحكم وإضافة الرمز كما هو موضح أدناه:
تحميل مصدر البيانات وملفات القالب
أولاً، قم بتحميل مصدر البيانات وملفات القالب إلى السحابة باستخدام مثال الكود الموضح أدناه:
ونتيجة لذلك، ستكون الملفات التي تم تحميلها متاحة في قسم الملفات بلوحة التحكم الخاصة بك على السحابة.
عرض بيانات JSON على صفحة HTML باستخدام Python
لعرض بيانات JSON على صفحة HTML، يرجى اتباع الخطوات الواردة أدناه:
- قم بإنشاء مثيل AssemblyApi باستخدام Client_id وclient_secret.
- قم بإعداد معلومات القالب باستخدام مسار الملف واسم التخزين ومعرف الإصدار وكلمة المرور.
- قم بإعداد طلب التجميع باستخدام AssembleOptions مع بيانات التقرير ومعلومات القالب ومسار الإخراج وحفظ التنسيق.
- قم بإنشاء تقرير HTML باستخدام طريقة AssemblyApi.assemble_document(AssembleOptions).
يوضح مثال التعليمات البرمجية التالي كيفية عرض بيانات JSON على صفحة HTML باستخدام Python SDK لمولد تقارير HTML REST API.
تحميل ملف HTML
يقوم الكود الوارد في الخطوة السابقة بحفظ ملف HTML المحول على السحابة. لتنزيله، يمكنك استخدام مقتطف التعليمات البرمجية التالي.
خاتمة
في منشور المدونة هذا، تناولنا عملية عرض بيانات JSON على صفحة HTML باستخدام GroupDocs.Assembly Cloud REST API وPython SDK الخاص بها. تسمح واجهة برمجة التطبيقات القوية هذه للمطورين بإنشاء تقارير ديناميكية بتنسيقات مختلفة بسهولة، والاستفادة من البيانات من مصادر وقوالب JSON أو XML بتنسيقات مختلفة مثل مستندات Word أو جداول البيانات أو الملفات النصية.
علاوة على ذلك، يمكنك معرفة المزيد حول GroupDocs.Assembly Cloud API باستخدام الوثائق. نوفر أيضًا قسمًا مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. الكود المصدري الكامل لـ Python SDK متاح مجانًا على Github.
أخيرًا، نستمر في كتابة مقالات مدونة جديدة بتنسيقات ملفات مختلفة وتحليلها باستخدام REST API. لذا يرجى التواصل للحصول على آخر التحديثات. ترميز سعيد!
طرح سؤال
في حالة وجود أي استفسارات أو ارتباك حول مولد تقارير HTML، فلا تتردد في الاتصال بنا عبر [المنتدى] الخاص بنا17.
أنظر أيضا
فيما يلي بعض المقالات ذات الصلة التي قد تجدها مفيدة: