مولد التقارير لـ Python
مكتبة Python لإنشاء تقارير مخصصة للغاية باستخدام REST API
مكتبة Python لإنشاء تقارير مخصصة للغاية باستخدام REST API
GroupDocs.Assembly Cloud SDK لـ Python يتيح للمطورين أتمتة إنشاء مستندات ذات تنسيق غني مثل العقود، الفواتير، تقارير الشحن، عروض المبيعات، الجرد والعديد من القطع الحيوية للأعمال. الحل مبني بالكامل على السحابة ويتم الوصول إليه عبر REST API، مما يعني أن أي تطبيق Python قادر على إرسال طلبات HTTP يمكنه توليد المستندات عند الطلب دون الحاجة إلى تثبيت برامج على الخادم أو أدوات طرف ثالث.
في جوهره، يعمل المنصّة مع قوالب المستندات التي تحتوي على حقول نائبة خاصة وبُنى برمجية. يتم استبدال هذه الحقول النائبة تلقائيًا بالقيم المستخرجة من مصدر بيانات (XML أو JSON) باستخدام صياغة تعبيرية على نمط LINQ. تسمح لك هذه المقاربة القوية بتضمين الصور، المخططات، الباركود، تعيين ألوان الخلفية لمخرجات HTML، إنشاء جداول وقوائم ديناميكية من بيانات المصفوفة، وتطبيق منطق شرطي لتضمين أو استبعاد أقسام المستند. نظرًا لأن SDK يدعم مجموعة واسعة من صيغ الإدخال والإخراج، يمكنك توليد PDF من قالب DOCX، إنتاج تقارير HTML، أو إخراج ملفات OpenDocument دون خطوات تحويل إضافية.
تتكون سير العمل النموذجي في Python من ثلاث خطوات بسيطة:
1️⃣ إنشاء قالب – صمم ملف Word أو Excel أو PowerPoint أو أي ملف مدعوم من نوع Office/OpenOffice وأدرج حقول نائبة وقواعد التوليد.
2️⃣ تحضير مصدر بيانات – قدّم بياناتك بصيغة XML أو JSON، مطابقة للحقول النائبة المحددة في القالب.
3️⃣ كتابة بضع أسطر من كود Python – استخدم حزمة groupdocsassemblycloud لرفع القالب إلى GroupDocs Cloud Storage، مرّر مصدر البيانات مع صيغة الإخراج المطلوبة، واستدعِ عملية AssembleDocument. تُعيد API المستند المُجمّع مباشرةً في الاستجابة أو تخزّنه في السحابة للاسترجاع لاحقًا.
جميع التفاعلات مؤمنة بتشفير SSL/TLS، ويتم المصادقة عبر معرف التطبيق الشخصي (App SID) وApp Key. يضمن ذلك بقاء مستنداتك وبياناتك محمية أثناء معالجتها في السحابة. تتيح الطبيعة متعددة المنصات لـ SDK دمج توليد المستندات في خدمات الويب، وظائف الدُفعات، التطبيقات المكتبية، أو الدوال غير الخادمة، لتوفير مستندات قابلة للطباعة، جاهزة للويب أو البريد الإلكتروني فورًا وبشكل موثوق.
نظرة عامة على الميزات التي يدعمها التجميع Cloud API.
تنسيقات المستندات المدعومة للتجميع Cloud API.
أنظمة التشغيل وبيئات التطوير المدعومة
هذا المثال Python يوضح كيفية رفع قالب، ربط ملف بيانات، وإنشاء مستند ناتج باستخدام مجموعة GroupDocs Cloud SDK.
الخطوات
AssemblyApi باستخدام معرف التطبيق (App SID) وApp Key.TemplateFileInfo وAssembleOptions.assemble_document لإنشاء النتيجة.import groupdocsassemblycloud
# Initialize API client (replace with your credentials)
assembly_api = groupdocsassemblycloud.AssemblyApi('####################', '####################')
# 1️⃣ Upload the template
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Load data source (could be XML, JSON or DOCX)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ Set assemble options (output format: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Assemble the document
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Document generated successfully:", result.path)