Облачный API автоматизации документов

Просмотрите наши продукты

Are you looking for an evaluation version of a product?

If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.

Are you having troubles in downloading?

If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.

Установка
Пакет доступен на PyPI и может быть установлен через pip следующей командой:
pip install groupdocs-assembly-cloud

Требования

Python 3.4+
менеджер пакетов pip
Учётные данные GroupDocs Cloud — Client ID и Client Secret из панели управления

Зависимости

SDK автоматически устанавливает следующие пакеты:

Пакет	Ограничение
urllib3	>= 1.16
six	>= 1.10
certifi	—
python-dateutil	—

Быстрый старт

Получите учётные данные API

Чтобы использовать GroupDocs.Assembly Cloud, зарегистрируйтесь на панели управления GroupDocs.Cloud и получите Client ID и Client Secret.

Инициализация API

Используйте следующий код для начала работы с облачным SDK GroupDocs.Assembly для Python:

import groupdocsassemblycloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create instance of the Assembly API
assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

Сборка документа из шаблона и данных JSON

После инициализации используйте этот базовый пример для генерации документа из шаблона и источника данных JSON:

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

# Upload the template file to cloud storage
with open("template.docx", "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, path="template.docx")
    assembly_api.upload_file(upload_request)

# Read JSON data source
with open("data.json") as f:
    data = f.read()

template_file_info = groupdocsassemblycloud.TemplateFileInfo("template.docx")
options = groupdocsassemblycloud.AssembleOptions(template_file_info, save_format="docx", report_data=data)
request = requests.AssembleDocumentRequest(options)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

С этим кратким руководством вы готовы начать автоматизировать генерацию документов с помощью GroupDocs.Assembly Cloud в ваших Python-приложениях. Подробнее см. в документации.

Сборка документа в PDF

Сгенерируйте PDF-отчёт из шаблона OpenDocument и данных JSON.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

filename = "TableFeatures.odt"
remote_name = "GroupDocs.Assembly/TableFeatures.odt"

with open("TableData.json") as f:
    data = f.read()

with open(filename, "rb") as template_file:
    upload_request = requests.UploadFileRequest(template_file, remote_name)
    assembly_api.upload_file(upload_request)

template_file_info = groupdocsassemblycloud.TemplateFileInfo(remote_name)
assemble_data = groupdocsassemblycloud.AssembleOptions(template_file_info, "pdf", data)
request = requests.AssembleDocumentRequest(assemble_data)
result = assembly_api.assemble_document(request)

print("Generated document size = " + str(len(result)))

Получение поддерживаемых форматов файлов

Получите полный список поддерживаемых форматов файлов, доступных через Assembly API.

import groupdocsassemblycloud
from groupdocsassemblycloud.models import requests

client_id = "YourClientId"
client_secret = "YourClientSecret"

assembly_api = groupdocsassemblycloud.AssemblyApi(client_id, client_secret)
assembly_api.api_client.configuration.host = "https://api.groupdocs.cloud"

result = assembly_api.get_supported_file_formats(requests.GetSupportedFileFormatsRequest())

for fmt in result.formats:
    print(fmt.file_format)

Примеры проектов на GitHub

Репозиторий облачного Python SDK GroupDocs.Assembly содержит готовые к запуску модульные тесты и примеры:

Категория	Примеры
Сборка документов	Сборка документа из шаблона и данных JSON, генерация PDF
Операции с файлами	Загрузка файлов шаблонов в облачное хранилище
Информация	Поддерживаемые форматы файлов

Как запустить примеры

Клонируйте или скачайте репозиторий SDK
Отредактируйте Settings/servercreds.json и укажите AppSid и AppKey
Установите зависимости: pip install groupdocs-assembly-cloud -U
Запустите тесты из корня репозитория: python -m unittest discover -s test

Подробнее см. в разделе Начало работы.