مكتبة Java لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST
ابدأ التجربة المجانيةGroupDocs.Assembly Cloud هي خدمة مُدارة بالكامل، تعتمد على REST، تُمكّن مطوري Java من إنشاء مستندات وتقارير وعقود وفواتير ورسائل دمج بريدي عالية التخصيص مباشرةً من السحابة. يعمل الحل مع مجموعة واسعة من تنسيقات الإدخال والإخراج، مما يسمح لك بتخزين ملفات القوالب في GroupDocs Cloud Storage، وربطها بمصادر بيانات XML أو JSON، واستلام المستند المُجمّع بالتنسيق الذي تختاره - DOCX، PDF، HTML، PPTX، XLSX، إلخ. ولأن جميع عمليات المعالجة تتم على جانب الخادم، فلا حاجة لتثبيت أي برامج أو مكتبات خارجية على جهاز العميل؛ الشرط الوحيد هو بيئة تشغيل Java وحزمة أدوات تطوير برمجيات Assembly Cloud، التي توفر واجهات برمجة تطبيقات دقيقة.
يتكون سير عمل Java النموذجي من ثلاث خطوات بسيطة. أولاً، أضف تبعية حزمة أدوات تطوير برمجيات Assembly Cloud إلى مشروع Maven أو Gradle، وقم بتهيئة ApiClient باستخدام معرف التطبيق AppSID ومفتاح التطبيق AppKey الخاصين بك. ثانيًا، حمّل ملف القالب إلى خدمة GroupDocs Cloud Storage باستخدام دالة “uploadFile”. ثالثًا، أنشئ كائن “AssembleOptions”، وحدد مسار القالب، وملف البيانات (XML أو JSON)، وتنسيق الإخراج المطلوب، ثم استدعِ دالة “assembleDocument”. تُعيد الخدمة المستند المُجمّع كدفق يمكن حفظه محليًا أو معالجته لاحقًا. كما توفر مجموعة تطوير البرامج (SDK) طرقًا مساعدة لمعاينة القوالب، واسترجاع التنسيقات المدعومة، ومعالجة الأخطاء. يتيح لك هذا النهج البسيط دمج إنشاء المستندات في تطبيقات الويب، أو مهام المعالجة الدفعية، أو الخدمات المصغرة بأقل قدر من الأكواد البرمجية.
جميع الاتصالات مُشفّرة باستخدام SSL/TLS، ويتم التحكم في الوصول باستخدام مفاتيح شخصية. تتوسّع المنصة تلقائيًا للتعامل مع كميات كبيرة من الطلبات، وتدعم عمليات دمج البريد الدفعي، حيث يُمكن لمكالمة واحدة من واجهة برمجة التطبيقات (API) إنشاء آلاف الرسائل الشخصية. بالإضافة إلى ذلك، تدعم مجموعة أدوات تطوير البرامج (SDK) تضمين الصور والمخططات والرموز الشريطية وتطبيق المنطق الشرطي مباشرةً داخل القالب باستخدام تعبيرات على غرار LINQ، مما يمنحك التحكم الكامل في تخطيط المستند النهائي.
يوضح المقطع أدناه كيفية تحميل قالب، وتعيين مصدر البيانات، وإنشاء تقرير DOCX باستخدام واجهة برمجة تطبيقات Assembly Cloud. الخطوات
AssembleOptions - مسار القالب، وتنسيق الإخراج، وملف البيانات.assembleDocument للحصول على النتيجة.import com.groupdocs.assembly.*;
AssembleApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("......##").setAppSid(".#-.#-.#-.#");
String fileName = "Input1.docx";
ملف بيانات السلسلة = "Input2.docx"؛
طلب ملف محتوى الملف = ملف جديد (اسم الملف)؛
طلب تحميل ملف، تحميل مستند، طلب =
طلب تحميل ملف جديد (محتوى ملف الطلب، اسم الملف، فارغ)؛
assemblyApi.uploadFile(uploadDocumentRequest)؛
خيارات التجميع، خيارات التجميع = خيارات التجميع الجديدة؛
assemblyOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assemblyOptions.setSaveFormat("docx");
assemblyOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest، طلب = طلب تجميع مستند جديد (assembleOptions)؛
assemblyApi.assembleDocument(request);