Rapportgenerator til Swift
Swift-bibliotek til at bygge meget tilpassede rapporter ved hjælp af REST API
Swift-bibliotek til at bygge meget tilpassede rapporter ved hjælp af REST API
GroupDocs.AssemblyCloud er en fuldt administreret, REST-baseret dokumentassembleringstjeneste, der giver udviklere mulighed for at oprette rigt formaterede rapporter, kontrakter, fakturaer, tilbud og alle andre typer dokumenter direkte fra Swift-applikationer. Tjenesten fungerer oven på GroupDocs Cloud Storage – skabeloner og data uploades til skyen, assembly-motoren behandler dem, og det færdige dokument returneres til klienten uden behov for lokale Office-installationer. Dette eliminerer overhead ved vedligeholdelse af tredjepartsbiblioteker, reducerer serversidebehandlingsbelastningen og garanterer, at den nyeste formatunderstøttelse (DOCX, PDF, PPTX, XLSX, HTML osv.) altid er tilgængelig.
Med Swift SDK passer hele arbejdsgangen naturligt ind i den typiske iOS/macOS-udviklingscyklus:
Forbered en skabelon – et Word-, Excel-, PowerPoint- eller ethvert understøttet format, der indeholder pladsholdere (f.eks. {{Customer.Name}}) og valgfrie genereringsregler skrevet i LINQ-stilsyntaks.
Opret en datakilde – en JSON- eller XML-fil, der leverer værdierne til pladsholderne. Komplekse strukturer såsom arrays kan bruges til at generere tabeller, diagrammer eller gentagne sektioner.
Upload skabelonen til GroupDocs Cloud Storage ved hjælp af et enkelt API-kald (SDK’et håndterer flerdelsanmodningen).
Kald Assemble-slutpunktet – angiv skabelonens cloud-sti, datakildeindholdet og det ønskede outputformat (outputformatet kan afvige fra skabelonformatet, f.eks. generer en PDF fra en DOCX-skabelon).
Modtag det samlede dokument – tjenesten streamer resultatet tilbage; SDK’et kan gemme det lokalt, sende det via e-mail eller gemme det igen i Cloud Storage.
SDK’et abstraherer alle HTTP-detaljer – du skal kun angive dit App SID og din App Key (personlige adgangstokens). Al kommunikation er krypteret med SSL/TLS, fejlhåndtering følger standard HTTP-statuskoder, og tjenesten overholder sikkerhedsstandarder i branchen. Fordi behandlingen udføres i skyen, fungerer den samme Swift-kode på iPhone, iPad, Mac eller enhver anden platform, der kan udføre Swift-kode og udføre netværksanmodninger.
De følgende faner giver et kort overblik over de funktioner, der understøttes af AssemblyCloud til Swift, den fulde liste over dokumentformater og de operativsystemer/udviklingsværktøjer, der er kompatible med SDK’et.
Kernefunktioner i Assembly Cloud API’en til Swift.
Dokumentformater understøttet af Assembly Cloud API.
Understøttede operativsystemer og udviklingsframeworks.
Uddraget nedenfor demonstrerer, hvordan man genererer en rapport ved hjælp af Assembly Cloud SDK til Swift. Den uploader en skabelon, læser en datafil, konfigurerer assembly-indstillinger og kalder API’en.
Trin
Initialiser AssemblyApi med dit App SID og din App Key.
Upload skabelondokumentet til Cloud Storage.
Indlæs rapportdataene (XML/JSON) fra en lokal fil.
Opret TemplateFileInfo, der peger på den uploadede skabelon.
Indstil det ønskede outputformat (f.eks. docx).
Byg et AssembleOptions-objekt med skabelon, data og format.
Kald assembleDocument og hent den assemblerede fil.
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)