Bibliothèque Java pour créer des rapports hautement personnalisés avec REST API
Commencer l'essai gratuitGroupDocs.Assembly Cloud est un service entièrement géré, basé sur REST, qui permet aux développeurs Java de créer des documents, rapports, contrats, factures et lettres de publipostage hautement personnalisés directement depuis le cloud. La solution fonctionne avec un large éventail de formats d’entrée et de sortie, vous permettant de stocker les fichiers de modèle dans GroupDocs Cloud Storage, de les lier aux sources de données XML ou JSON, et de recevoir le document assemblé dans le format de votre choix – DOCX, PDF, HTML, PPTX, XLSX, etc. Parce que tout le traitement s’effectue côté serveur, il n’est pas nécessaire d’installer un logiciel ou des bibliothèques tierces sur la machine cliente ; la seule exigence est un runtime Java et l’Assembly Cloud SDK, qui fournit de légers wrappers autour des points de terminaison API.
Le flux de travail typique Java se compose de trois étapes simples. Premièrement, ajoutez la dépendance Assembly Cloud SDK à votre projet Maven ou Gradle et initialisez le ApiClient avec votre SID d’application personnel et votre clé d’application. Deuxièmement, téléversez le fichier de modèle vers GroupDocs Cloud Storage en utilisant la méthode uploadFile. Troisièmement, créez un objet AssembleOptions, spécifiez le chemin du modèle, le fichier de données (XML ou JSON), le format de sortie souhaité, et invoquez assembleDocument. Le service renvoie le document assemblé sous forme de flux qui peut être enregistré localement ou traité davantage. Le SDK expose également des méthodes d’aide pour prévisualiser les modèles, récupérer les formats pris en charge et gérer les erreurs. Cette approche directe vous permet d’intégrer la génération de documents dans des applications web, des travaux de traitement par lots ou des micro‑services avec un minimum de code.
Toutes les communications sont chiffrées avec SSL/TLS, et l’accès est contrôlé par des clés personnelles. La plateforme s’ajuste automatiquement pour gérer de gros volumes de requêtes et prend en charge les opérations de publipostage par lots où un appel unique API peut générer des milliers de lettres personnalisées. De plus, le SDK prend en charge l’insertion d’images, de graphiques, de codes-barres et l’application de logique conditionnelle directement dans le modèle à l’aide d’expressions de style LINQ, vous offrant un contrôle total sur la mise en page finale du document.
L’extrait ci-dessous montre comment téléverser un modèle, définir la source de données et générer un rapport DOCX à l’aide de l’Assembly Cloud API. Étapes
AssembleOptions – chemin du modèle, format de sortie et fichier de données.assembleDocument pour obtenir le résultat.import com.groupdocs.assembly.*;
AssemblyApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("####################").setAppSid("####-####-####-####-####");
String fileName = "Input1.docx";
String dataFile = "Input2.docx";
File requestFileContent = new File(fileName);
UploadFileRequest uploadDocumentRequest =
new UploadFileRequest(requestFileContent, fileName, null);
assemblyApi.uploadFile(uploadDocumentRequest);
AssembleOptions assembleOptions = new AssembleOptions();
assembleOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assembleOptions.setSaveFormat("docx");
assembleOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest request = new AssembleDocumentRequest(assembleOptions);
assemblyApi.assembleDocument(request);