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