مولد التقارير لـ Swift
مكتبة Swift لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST
مكتبة Swift لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST
GroupDocs.AssemblyCloud هي خدمة تجميع مستندات مُدارة بالكامل، قائمة على REST، تُمكّن المطورين من إنشاء تقارير وعقود وفواتير وعروض أسعار بتنسيق غني، وأي نوع آخر من المستندات مباشرةً من تطبيقات Swift. تعمل الخدمة على منصة GroupDocs Cloud Storage، حيث تُحمّل القوالب والبيانات إلى السحابة، ويعالجها محرك التجميع، ثم تُعاد الوثيقة النهائية إلى العميل دون الحاجة إلى تثبيت أي برامج Office محلية. هذا يُغني عن تكاليف صيانة مكتبات الجهات الخارجية، ويُقلل من عبء المعالجة من جانب الخادم، ويضمن توافر أحدث التنسيقات (DOCX، PDF، PPTX، XLSX، HTML، إلخ) دائمًا.
مع Swift SDK، يتناسب سير العمل بأكمله بسلاسة مع دورة تطوير iOS/macOS النموذجية:
إعداد قالب - Word أو Excel أو PowerPoint أو أي تنسيق مدعوم يحتوي على عناصر نائبة (مثل {{Customer.Name}}) وقواعد إنشاء اختيارية مكتوبة بلغة LINQ.
إنشاء مصدر بيانات - ملف JSON أو XML يوفر قيم العناصر النائبة. يمكن استخدام هياكل معقدة مثل المصفوفات لإنشاء جداول أو مخططات أو أقسام متكررة.
رفع القالب إلى GroupDocs Cloud Storage باستخدام استدعاء واجهة برمجة تطبيقات واحد (تتولى SDK معالجة الطلب متعدد الأجزاء).
استدعاء نقطة نهاية التجميع - مرر مسار القالب السحابي، ومحتوى مصدر البيانات، وتنسيق الإخراج المطلوب (قد يختلف تنسيق الإخراج عن تنسيق القالب، على سبيل المثال، إنشاء ملف PDF من قالب DOCX).
٥. استلم المستند المُجمّع - تُعيد الخدمة بثّ النتيجة؛ ويمكن لحزمة تطوير البرامج (SDK) حفظها محليًا، أو إرسالها عبر البريد الإلكتروني، أو تخزينها مجددًا في التخزين السحابي.
تُلخص حزمة تطوير البرامج (SDK) جميع تفاصيل HTTP - ما عليك سوى تقديم مُعرّف تطبيقك (SID) ومفتاح التطبيق (رموز الوصول الشخصية). جميع الاتصالات مُشفّرة باستخدام SSL/TLS، وتتبع معالجة الأخطاء رموز حالة HTTP القياسية، وتتوافق الخدمة مع معايير الأمان المُعتمدة في هذا المجال. ولأن المعالجة تُجرى في السحابة، فإن نفس شفرة Swift تعمل على أجهزة iPhone أو iPad أو Mac أو أي منصة أخرى يُمكنها تنفيذ شفرة Swift وتنفيذ طلبات الشبكة.
تُقدم علامات التبويب التالية نظرة عامة مُختصرة على الميزات التي يدعمها AssemblyCloud for Swift، والقائمة الكاملة لتنسيقات المستندات، وأنظمة التشغيل/أدوات التطوير المُتوافقة مع حزمة تطوير البرامج (SDK).
القدرات الأساسية لـ Assembly Cloud API لـ Swift.
تنسيقات المستندات المدعومة بواسطة Assembly Cloud API.
أنظمة التشغيل وأطر التطوير المدعومة.
يوضح المقطع أدناه كيفية إنشاء تقرير باستخدام مجموعة أدوات تطوير البرامج Assembly Cloud SDK لـ Swift. يقوم هذا المقطع بتحميل قالب، وقراءة ملف بيانات، وتكوين خيارات التجميع، واستدعاء واجهة برمجة التطبيقات (API).
الخطوات
AssemblyApi باستخدام معرف أمان التطبيق (SID) ومفتاح التطبيق.TemplateFileInfo مع الإشارة إلى القالب الذي تم تحميله.AssembleOptions باستخدام قالب وبيانات وتنسيق.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)