گزارش ساز برای سوئیفت
کتابخانه Swift برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API
کتابخانه Swift برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API
GroupDocs.AssemblyCloud یک سرویس مونتاژ سند کاملاً مدیریت‌شده و مبتنی بر REST است که به توسعه‌دهندگان اجازه می‌دهد گزارش‌ها، قراردادها، فاکتورها، پیشنهادها و هر نوع سند دیگری را مستقیماً از برنامه‌های Swift با فرمت غنی ایجاد کنند. این سرویس بر روی فضای ذخیره‌سازی ابری GroupDocs کار می‌کند - قالب‌ها و داده‌ها در فضای ابری آپلود می‌شوند، موتور مونتاژ آنها را پردازش می‌کند و سند نهایی بدون نیاز به نصب محلی آفیس به کلاینت بازگردانده می‌شود. این امر سربار نگهداری کتابخانه‌های شخص ثالث را از بین می‌برد، بار پردازش سمت سرور را کاهش می‌دهد و تضمین می‌کند که آخرین پشتیبانی از فرمت (DOCX، PDF، PPTX، XLSX، HTML و غیره) همیشه در دسترس باشد.
با Swift SDK، کل گردش کار به طور طبیعی در چرخه توسعه معمول iOS/macOS قرار می‌گیرد:
{{Customer.Name}}) و قوانین تولید اختیاری نوشته شده به سبک LINQ باشد.۲. ایجاد یک منبع داده - یک فایل JSON یا XML که مقادیر مربوط به متغیرها را فراهم می‌کند. ساختارهای پیچیده مانند آرایه‌ها می‌توانند برای تولید جداول، نمودارها یا بخش‌های تکراری استفاده شوند.
۳. آپلود الگو در GroupDocs Cloud Storage با استفاده از یک فراخوانی API واحد (SDK درخواست چندبخشی را مدیریت می‌کند).
۴. فراخوانی نقطه پایانی Assemble - ارسال مسیر ابری الگو، محتوای منبع داده و فرمت خروجی مورد نظر (فرمت خروجی می‌تواند با فرمت الگو متفاوت باشد، مثلاً از یک قالب DOCX یک PDF تولید کند).
۵. دریافت سند مونتاژ شده - سرویس نتیجه را به صورت استریم برمی‌گرداند؛ SDK می‌تواند آن را به صورت محلی ذخیره کند، از طریق ایمیل ارسال کند یا دوباره در Cloud Storage ذخیره کند.
SDK تمام جزئیات HTTP را خلاصه می‌کند - شما فقط باید App SID و App Key (توکن‌های دسترسی شخصی) خود را ارائه دهید. تمام ارتباطات با SSL/TLS رمزگذاری شده است، مدیریت خطا از کدهای وضعیت استاندارد HTTP پیروی می‌کند و این سرویس با استانداردهای امنیتی درجه یک صنعت مطابقت دارد. از آنجا که پردازش در فضای ابری انجام می‌شود، همان کد Swift روی آیفون، آیپد، مک یا هر پلتفرم دیگری که می‌تواند کد Swift را اجرا کند و درخواست‌های شبکه را انجام دهد، کار می‌کند.
تب‌های زیر مروری مختصر بر ویژگی‌های پشتیبانی شده توسط AssemblyCloud برای Swift، لیست کامل فرمت‌های سند و سیستم عامل‌ها/ابزارهای توسعه سازگار با SDK ارائه می‌دهند.
قابلیت‌های اصلی رابط برنامه‌نویسی کاربردی (API) اسمبلی کلود برای سوئیفت.
فرمت‌های سند پشتیبانی شده توسط رابط برنامه‌نویسی کاربردی اسمبلی کلود
سیستم عامل‌ها و چارچوب‌های توسعه پشتیبانی شده.
قطعه کد زیر نحوه تولید گزارش با استفاده از Assembly Cloud SDK برای Swift را نشان می‌دهد. این SDK یک الگو را آپلود می‌کند، یک فایل داده را می‌خواند، گزینه‌های مونتاژ را پیکربندی می‌کند و API را فراخوانی می‌کند.
مراحل
AssemblyApi را با App SID و App Key خود مقداردهی اولیه کنید.
سند الگو را در Cloud Storage آپلود کنید.
داده‌های گزارش (XML/JSON) را از یک فایل محلی بارگذاری کنید.
TemplateFileInfo را که به الگوی آپلود شده اشاره می‌کند، ایجاد کنید.
فرمت خروجی مورد نظر (مثلاً docx) را تنظیم کنید.
یک شیء 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)