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