مولد التقارير لـ Swift

مكتبة Swift لبناء تقارير مخصصة للغاية باستخدام REST API

  • GroupDocs.Assembly Cloud لـ cURL
  • GroupDocs.Assembly Cloud SDK لـ.NET
  • GroupDocs.Assembly Cloud SDK لـJava
  • GroupDocs.Assembly Cloud SDK لـC++
  • GroupDocs.Assembly Cloud SDK لـGo
  • GroupDocs.Assembly Cloud SDK لـNode.js
  • GroupDocs.Assembly Cloud SDK لـPHP
  • GroupDocs.Assembly Cloud SDK لـPython
  • GroupDocs.Assembly Cloud SDK لـRuby
  • GroupDocs.Assembly Cloud SDK لـSwift
ابدأ التجربة المجانية

GroupDocs.Assembly Cloud هي خدمة تجميع مستندات مُدارة بالكامل ومبنية على REST، تتيح للمطورين إنشاء تقارير، عقود، فواتير، مقترحات، وأي نوع آخر من المستندات ذات التنسيق الغني مباشرةً من تطبيقات Swift. تعمل الخدمة فوق GroupDocs Cloud Storage – حيث تُرفع القوالب والبيانات إلى السحابة، ويعالج محرك التجميع هذه، وتُعاد المستندات المكتملة إلى العميل دون الحاجة إلى أي تثبيتات محلية لـ Office. هذا يُزيل عبء صيانة المكتبات الخارجية، يقلل من حمل المعالجة على الخادم، ويضمن توفر أحدث دعم الصيغ (DOCX، PDF، PPTX، XLSX، HTML، إلخ) دائمًا.

مع Swift SDK يتكامل سير العمل بالكامل بشكل طبيعي مع دورة التطوير النموذجية iOS/macOS:

  1. تحضير قالب – قالب من نوع Word أو Excel أو PowerPoint أو أي صيغة مدعومة تحتوي على عناصر نائبة (مثال: {{Customer.Name}}) وقواعد توليد اختيارية مكتوبة بصيغة تشبه LINQ.
  2. إنشاء مصدر بيانات – ملف JSON أو XML يزود القيم للعناصر النائبة. يمكن استخدام هياكل معقدة مثل المصفوفات لتوليد جداول أو مخططات أو أقسام مكررة.
  3. رفع القالب إلى GroupDocs Cloud Storage باستخدام استدعاء واحد API (يتولى SDK معالجة طلب multipart).
  4. استدعاء نقطة النهاية Assemble – مرّر مسار القالب في السحابة، محتوى مصدر البيانات، وصيغة الإخراج المطلوبة (يمكن أن تختلف صيغة الإخراج عن صيغة القالب، مثال: توليد PDF من قالب DOCX).
  5. استلام المستند المُجمّع – تقوم الخدمة ببث النتيجة؛ يمكن لـ SDK حفظه محليًا، إرساله عبر البريد الإلكتروني، أو تخزينه مرة أخرى في التخزين السحابي.

يقوم SDK بتجريد جميع تفاصيل HTTP – فأنت بحاجة فقط إلى توفير App SID وApp Key (رموز وصول شخصية). جميع الاتصالات مشفّرة باستخدام SSL/TLS، وتعامل الأخطاء يتبع رموز الحالة القياسية لـ HTTP، وتلتزم الخدمة بمعايير الأمان على مستوى الصناعة. نظرًا لأن المعالجة تُجرى في السحابة، يعمل نفس كود Swift على iPhone و iPad و Mac أو أي منصة أخرى يمكنها تنفيذ كود Swift وإجراء طلبات الشبكة.

توفر علامات التبويب التالية نظرة مختصرة على الميزات المدعومة من قبل Assembly Cloud لـ Swift، القائمة الكاملة لصيغ المستندات، وأنظمة التشغيل، وأدوات التطوير المتوافقة مع SDK.

ميزات تجميع المستندات REST API

تجميع المستندات السحابي عبر REST API

عناصر نائبة للقالب لإدخال البيانات

ربط التعبير بنمط LINQ لـ XML/JSON

تضمين المستندات الخارجية، والصور، والمخططات

قوائم وجداول ديناميكية وكتل شرطية

صيغ وجداول البيانات

سمات محتوى البريد الإلكتروني والمرفقات

إنشاء الباركود (QR، Code128، إلخ)

تنسيق لون الخلفية لـ HTML

دمج البريد للرسائل الشخصية على دفعات

نقل البيانات الآمن عبر SSL/TLS

رفع القوالب إلى التخزين السحابي

إنشاء مستند في Swift

المقتطف أدناه يوضح كيفية إنشاء تقرير باستخدام Assembly Cloud SDK لـ Swift. يقوم بتحميل قالب، قراءة ملف البيانات، تكوين خيارات التجميع واستدعاء API.

الخطوات

  1. تهيئة AssemblyApi باستخدام معرف التطبيق App SID وApp Key.
  2. رفع مستند القالب إلى التخزين السحابي.
  3. تحميل بيانات التقرير (XML/JSON) من ملف محلي.
  4. إنشاء TemplateFileInfo يشير إلى القالب المرفوع.
  5. تحديد تنسيق الإخراج المطلوب (مثال: docx).
  6. بناء كائن AssembleOptions باستخدام القالب والبيانات والتنسيق.
  7. استدعاء assembleDocument والحصول على الملف المجمع.
import GroupDocsAssemblyCloud

let assemblyApi = AssemblyApi(appSid: "####################", appKey: "####################")
let fileName = "Input1.docx"
let dataFile = "Input2.docx"

// Upload template
let requestFileContent = InputStream(url: URL(string: fileName)!)!
let uploadDocumentRequest = UploadFileRequest(fileContent: requestFileContent, path: fileName)
_ = try assemblyApi.uploadFile(request: uploadDocumentRequest)

// Prepare template info
let templateFileInfo = TemplateFileInfo()
templateFileInfo.setFilePath(filePath: fileName)

// Load data
let reportData = try String(contentsOfFile: dataFile, encoding: .utf8)

// Assemble options
let assembleOptions = AssembleOptions()
assembleOptions.setTemplateFileInfo(templateFileInfo: templateFileInfo)
assembleOptions.setSaveFormat(saveFormat: "docx")
assembleOptions.setReportData(reportData: reportData)

// Execute assembly
let request = AssembleDocumentRequest(assembleOptions: assembleOptions)
let result = try assemblyApi.assembleDocument(request: request)

Support and Learning Resources

GroupDocs.Assembly Cloud يقدم أيضًا تجميع مستندات فردية SDKs للغات أخرى كما هو موضح أدناه:

  عربي
4f0b7297e