Generatore di report per Swift

Libreria Swift per creare report altamente personalizzati utilizzando l’API REST

  • GroupDocs.Assembly Cloud for cURL
  • GroupDocs.Assembly Cloud SDK for .NET
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for Node.js
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Ruby
  • GroupDocs.Assembly Cloud SDK for Swift
Inizia la prova gratuita

GroupDocs.AssemblyCloud è un servizio di assemblaggio di documenti completamente gestito e basato su REST che consente agli sviluppatori di creare report, contratti, fatture, proposte e qualsiasi altro tipo di documento con formattazione avanzata direttamente dalle applicazioni Swift. Il servizio funziona sul Cloud Storage di GroupDocs: modelli e dati vengono caricati sul cloud, il motore di assemblaggio li elabora e il documento finito viene restituito al client senza la necessità di installazioni locali di Office. Questo elimina il sovraccarico dovuto alla manutenzione di librerie di terze parti, riduce il carico di elaborazione lato server e garantisce che il supporto per i formati più recenti (DOCX, PDF, PPTX, XLSX, HTML, ecc.) sia sempre disponibile.

Con Swift SDK, l’intero flusso di lavoro si adatta naturalmente al tipico ciclo di sviluppo iOS/macOS:

  1. Preparare un modello: un formato Word, Excel, PowerPoint o qualsiasi formato supportato che contenga segnaposto (ad esempio, {{Customer.Name}}) e regole di generazione facoltative scritte in sintassi in stile LINQ.
  2. Creare una sorgente dati: un file JSON o XML che fornisce i valori per i segnaposto. Strutture complesse come gli array possono essere utilizzate per generare tabelle, grafici o sezioni ripetute.
  3. Caricare il modello su GroupDocs Cloud Storage utilizzando una singola chiamata API (l’SDK gestisce la richiesta multiparte).
  4. Chiamare l’endpoint Assemble: passare il percorso cloud del modello, il contenuto della sorgente dati e il formato di output desiderato (il formato di output può differire dal formato del modello, ad esempio, generare un PDF da un modello DOCX).
  5. Ricevere il documento assemblato: il servizio invia il risultato in streaming; l’SDK può salvarlo localmente, inviarlo via email o archiviarlo nuovamente in Cloud Storage.

L’SDK astrae tutti i dettagli HTTP: è necessario fornire solo il SID e la chiave dell’app (token di accesso personali). Tutte le comunicazioni sono crittografate con SSL/TLS, la gestione degli errori segue i codici di stato HTTP standard e il servizio è conforme agli standard di sicurezza di settore. Poiché l’elaborazione avviene nel cloud, lo stesso codice Swift funziona su iPhone, iPad, Mac o qualsiasi altra piattaforma in grado di eseguire codice Swift ed eseguire richieste di rete.

Le seguenti schede forniscono una panoramica sintetica delle funzionalità supportate da AssemblyCloud per Swift, l’elenco completo dei formati di documento e i sistemi operativi/strumenti di sviluppo compatibili con l’SDK.

Funzionalità dell’API REST per l’assemblaggio dei documenti

Assemblaggio di documenti basato su cloud tramite API REST

Segnaposto modello per l’inserimento dei dati

Associazione di espressioni in stile LINQ per XML/JSON

Incorpora documenti esterni, immagini, grafici

Elenchi dinamici, tabelle e blocchi condizionali

Formule e calcoli nei fogli di calcolo

Attributi del corpo dell’e-mail e allegati

Generazione di codici a barre (QR, Code128, ecc.)

Stile del colore di sfondo HTML

Stampa unione per lettere personalizzate in batch

Trasferimento dati protetto SSL/TLS

Carica i modelli su Cloud Storage

Generare un documento in Swift

Il frammento di codice seguente mostra come generare un report utilizzando Assembly Cloud SDK per Swift. Carica un modello, legge un file di dati, configura le opzioni di assemblaggio e richiama l’API.

Passaggi

  1. Inizializza AssemblyApi con il SID e la chiave dell’app.
  2. Carica il documento modello su Cloud Storage.
  3. Carica i dati del report (XML/JSON) da un file locale.
  4. Crea TemplateFileInfo che punta al modello caricato.
  5. Imposta il formato di output desiderato (ad esempio, docx).
  6. Crea un oggetto AssembleOptions con modello, dati e formato.
  7. Chiama assembleDocument e ottieni il file assemblato.
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)

Supporto e risorse per l'apprendimento

GroupDocs.Assembly Cloud offre anche SDK di assemblaggio di documenti individuali per altri linguaggi, come elencato di seguito:

  Italiano