Библиотека Java для создания настраиваемых отчетов с использованием REST API
Начать бесплатную пробную версиюGroupDocs.Assembly Cloud — это полностью управляемый сервис на основе REST, позволяющий разработчикам Java создавать документы, отчёты, контракты, счета-фактуры и почтовые рассылки с высокой степенью персонализации прямо из облака. Решение работает с широким набором входных и выходных форматов, позволяя хранить файлы шаблонов в облачном хранилище GroupDocs, привязывать их к источникам данных XML или JSON и получать собранный документ в выбранном вами формате — DOCX, PDF, HTML, PPTX, XLSX и т. д. Поскольку вся обработка происходит на стороне сервера, нет необходимости устанавливать стороннее программное обеспечение или библиотеки на клиентской машине; единственное требование — это среда выполнения Java и Assembly Cloud SDK, предоставляющий тонкие оболочки для конечных точек API.
Типичный рабочий процесс Java состоит из трёх простых шагов. Сначала добавьте зависимость Assembly Cloud SDK в свой проект Maven или Gradle и инициализируйте ApiClient, используя ваши персональные AppSID и AppKey. Во-вторых, загрузите файл шаблона в облачное хранилище GroupDocs с помощью метода uploadFile
. В-третьих, создайте объект AssembleOptions
, укажите путь к шаблону, файлу данных (XML или JSON), желаемый формат вывода и вызовите assembleDocument
. Сервис возвращает собранный документ в виде потока, который можно сохранить локально или обработать дополнительно. SDK также предоставляет вспомогательные методы для предварительного просмотра шаблонов, получения поддерживаемых форматов и обработки ошибок. Этот простой подход позволяет интегрировать генерацию документов в веб-приложения, задания пакетной обработки или микросервисы с минимальным написанием кода.
Все коммуникации шифруются с помощью SSL/TLS, а доступ контролируется персональными ключами. Платформа автоматически масштабируется для обработки больших объемов запросов и поддерживает пакетные операции слияния, когда один вызов API может генерировать тысячи персонализированных писем. Кроме того, SDK поддерживает встраивание изображений, диаграмм, штрихкодов и применение условной логики непосредственно в шаблоне с использованием выражений в стиле LINQ, предоставляя вам полный контроль над конечным макетом документа.
В приведенном ниже фрагменте кода показано, как загрузить шаблон, настроить источник данных и сгенерировать отчёт DOCX с помощью Assembly Cloud API.
Шаги
Инициализируйте клиент API, используя SID и ключ приложения.
Загрузите файл шаблона в облачное хранилище.
Настройте AssembleOptions
— путь к шаблону, формат вывода и файл данных.
Вызовите assembleDocument
для получения результата.
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);