مولد التقارير لبايثون
مكتبة Python لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST
مكتبة Python لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST
تُمكّن GroupDocs.Assembly Cloud SDK للغة بايثون المطورين من أتمتة إنشاء مستندات بتنسيق غني، مثل العقود والفواتير وتقارير الشحن وعروض المبيعات والمخزونات وغيرها من العناصر المهمة للأعمال. يعتمد هذا الحل بشكل كامل على السحابة، ويمكن الوصول إليه عبر واجهة برمجة تطبيقات REST، مما يعني أن أي تطبيق بايثون قادر على إرسال طلبات HTTP يمكنه إنشاء مستندات عند الطلب دون الحاجة إلى تثبيت برامج من جانب الخادم أو أدوات خارجية.
في جوهرها، تعمل المنصة مع قوالب المستندات التي تحتوي على حقول خاصة للعناصر النائبة وبنيات برمجة. يتم استبدال هذه الحقول النائبة تلقائيًا بقيم مأخوذة من مصدر بيانات (XML أو JSON) باستخدام صيغة تعبير بنمط LINQ. يتيح لك هذا النهج الفعال تضمين الصور والمخططات والرموز الشريطية وتعيين ألوان الخلفية لمخرجات HTML وإنشاء جداول وقوائم ديناميكية من بيانات المصفوفة وتطبيق منطق شرطي لتضمين أو استبعاد أقسام من المستند. لأن مجموعة أدوات تطوير البرامج (SDK) تدعم مجموعة واسعة من تنسيقات الإدخال والإخراج، يمكنك إنشاء ملف PDF من قالب DOCX، أو إنتاج تقارير HTML، أو إخراج ملفات OpenDocument دون الحاجة إلى خطوات تحويل إضافية.
يتكون سير العمل النموذجي في بايثون من ثلاث خطوات بسيطة:
1️⃣ إنشاء قالب - تصميم ملف Word أو Excel أو PowerPoint أو أي ملف Office/OpenOffice مدعوم، وإدراج حقول نائبة وقواعد إنشاء.
2️⃣ إعداد مصدر بيانات - توفير بياناتك بتنسيق XML أو JSON، مع مطابقة الحقول النائبة المحددة في القالب.
3️⃣ كتابة بضعة أسطر من شيفرة بايثون - استخدام حزمة groupdocsassemblycloud لتحميل القالب إلى خدمة التخزين السحابي GroupDocs، وتمرير مصدر البيانات مع تنسيق الإخراج المطلوب، ثم استدعاء عملية AssembleDocument. تُرجع واجهة برمجة التطبيقات المستند المُجمّع مباشرةً في الاستجابة أو تُخزّنه في السحابة لاسترجاعه لاحقًا.
جميع التفاعلات مؤمنة بتشفير SSL/TLS، ويتم المصادقة عبر معرف تطبيقك الشخصي (SID) ومفتاح التطبيق. هذا يضمن حماية مستنداتك وبياناتك أثناء معالجتها في السحابة. تتيح لك طبيعة حزمة تطوير البرامج (SDK) متعددة المنصات دمج إنشاء المستندات في خدمات الويب، أو المهام المجمعة، أو تطبيقات سطح المكتب، أو الوظائف التي لا تحتاج إلى خادم، مما يوفر مستندات قابلة للطباعة، أو جاهزة للويب، أو جاهزة للبريد الإلكتروني، بشكل فوري وموثوق.
نظرة عامة على الميزات التي تدعمها واجهة برمجة تطبيقات Assembly Cloud.
تنسيقات المستندات المدعومة لـ Assembly Cloud API.
أنظمة التشغيل وبيئات التطوير المدعومة
يوضح هذا المثال بلغة بايثون كيفية تحميل قالب، وربط ملف بيانات، وإنشاء مستند إخراج باستخدام GroupDocs Assembly Cloud SDK.
الخطوات
AssemblyApi باستخدام معرف تطبيقك ومفتاح التطبيق.TemplateFileInfo وAssembleOptions.assemble_document لإنشاء النتيجة.import groupdocsassemblycloud
# تهيئة عميل واجهة برمجة التطبيقات (استبدله ببيانات اعتمادك)
assembly_api = groupdocsassemblycloud.AssemblyApi('......##', '......##')
# 1️⃣ حمّل القالب
file_name = 'Input1.docx'
باستخدام open(file_name, 'rb') كـ request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ حمّل مصدر البيانات (يمكن أن يكون XML أو JSON أو DOCX)
data_file = 'Input2.docx'
باستخدام open(data_file, 'rb') كبيانات:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ تعيين خيارات التجميع (تنسيق الإخراج: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ تجميع المستند
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("تم إنشاء المستند بنجاح:", result.path)