מחולל דוחות עבור סוויפט
ספריית Swift לבניית דוחות מותאמים אישית מאוד באמצעות REST API
ספריית Swift לבניית דוחות מותאמים אישית מאוד באמצעות REST API
GroupDocs.AssemblyCloud הוא שירות הרכבת מסמכים מנוהל במלואו, מבוסס REST, המאפשר למפתחים ליצור דוחות, חוזים, חשבוניות, הצעות וכל סוג אחר של מסמך בפורמט עשיר ישירות מיישומי Swift. השירות פועל על גבי אחסון הענן של GroupDocs - תבניות ונתונים מועלים לענן, מנוע ההרכבה מעבד אותם, והמסמך המוגמר מוחזר ללקוח ללא צורך בהתקנות מקומיות של Office. זה מבטל את התקורה של תחזוקת ספריות של צד שלישי, מפחית את עומס העיבוד בצד השרת ומבטיח שתמיכת הפורמטים העדכנית ביותר (DOCX, PDF, PPTX, XLSX, HTML וכו’) זמינה תמיד.
עם ערכת פיתוח התוכנה Swift, כל זרימת העבודה משתלבת באופן טבעי במחזור הפיתוח הטיפוסי של iOS/macOS:
הכן תבנית - Word, Excel, PowerPoint או כל פורמט נתמך המכיל מצייני מיקום (למשל, {{Customer.Name}}) וכללי יצירה אופציונליים שנכתבו בתחביר בסגנון LINQ.
צור מקור נתונים - קובץ JSON או XML המספק את הערכים עבור מצייני המיקום. ניתן להשתמש במבנים מורכבים כמו מערכים כדי ליצור טבלאות, תרשימים או מקטעים חוזרים.
העלה את התבנית ל-GroupDocs Cloud Storage באמצעות קריאה אחת ל-API (ה-SDK מטפל בבקשה מרובת החלקים).
קריאה לנקודת הקצה של Assemble – העבר את נתיב הענן של התבנית, תוכן מקור הנתונים ופורמט הפלט הרצוי (פורמט הפלט יכול להיות שונה מפורמט התבנית, לדוגמה, יצירת PDF מתבנית DOCX).
קבלת המסמך המורכב – השירות מזרים את התוצאה בחזרה; ה-SDK יכול לשמור אותה באופן מקומי, לשלוח אותה בדוא"ל או לאחסן אותה שוב ב-Cloud Storage.
ה-SDK מסכם את כל פרטי ה-HTTP – עליך לספק רק את SID האפליקציה ואת מפתח האפליקציה שלך (אסימוני גישה אישיים). כל התקשורת מוצפנת באמצעות SSL/TLS, טיפול בשגיאות עוקב אחר קודי סטטוס HTTP סטנדרטיים, והשירות עומד בתקני אבטחה ברמת התעשייה. מכיוון שהעיבוד מתבצע בענן, אותו קוד Swift עובד באייפון, אייפד, מק או כל פלטפורמה אחרת שיכולה לבצע קוד Swift ולבצע בקשות רשת.
הכרטיסיות הבאות מספקות סקירה תמציתית של התכונות הנתמכות על ידי AssemblyCloud עבור Swift, רשימה מלאה של פורמטי מסמכים ומערכות הפעלה / כלי פיתוח התואמים ל-SDK.
יכולות ליבה של Assembly Cloud API עבור Swift.
פורמטים של מסמכים הנתמכים על ידי Assembly Cloud API.
מערכות הפעלה ומסגרות פיתוח נתמכות.
הקטע למטה מדגים כיצד ליצור דוח באמצעות ה-SDK של Assembly Cloud עבור Swift. הוא מעלה תבנית, קורא קובץ נתונים, מגדיר אפשרויות אסמבלי ומפעיל את ה-API.
שלבים
אתחול ה-AssemblyApi עם ה-SID של האפליקציה ומפתח האפליקציה שלך.
העלאת מסמך התבנית לאחסון ענן.
טעינת נתוני הדוח (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)