Установка

Пакет доступен в PyPI, и его можно установить через pip, выполнив следующую команду:

pip install groupdocs-viewer-cloud

Требования

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

Зависимости

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

Python Cloud REST API для рендеринга документов

GroupDocs.Viewer Cloud SDK для Python предлагает мощное решение для рендеринга документов, которое поддерживает более 190 форматов, таких как Word, Excel, PDF-файлы, САПР, электронная почта и другие. Разработчики могут легко конвертировать и отображать документы в форматы HTML, PDF и изображения, сохраняя структуру и макет исходного документа. Благодаря расширенным функциям, таким как потоковый вывод, настраиваемые параметры просмотра, многостраничная отрисовка и поддержка различных типов файлов, GroupDocs.Viewer Cloud API обеспечивает плавную интеграцию для просмотра документов в любом веб-приложении Python, скрипте или рабочем процессе автоматизации. Зарегистрируйтесь бесплатно, чтобы начать использовать гибкость и возможности этого надежного облачного API.

Основное использование

Простая настройка средства просмотра - Руководство по быстрой настройке GroupDocs.Viewer с минимальной настройкой.
Загрузить документ из облака - Инструкция по загрузке документов прямо из облачного хранилища для просмотра.
Пользовательские параметры просмотра - Шаги по настройке параметров средства просмотра, таких как масштабирование, макет и навигация.
Поддерживаемые форматы файлов - Подробный список поддерживаемых форматов файлов, которые можно просмотреть без конвертации.

Просмотрщик HTML

Преобразование документов в HTML - Процесс преобразования документов в формат HTML для удобного просмотра в браузере.
Потоковое HTML-вывод - Руководство по потоковой передаче HTML-контента для рендеринга документов в режиме реального времени.
Сохранение структуры документа в HTML - Инструкции по сохранению исходного макета и структуры при преобразовании в HTML.
Пользовательские параметры просмотра HTML - Функции для настройки внешнего вида документов, просматриваемых в формате HTML, включая стили и шрифты.

Просмотр изображений

Преобразование документов в изображения - Действия по преобразованию документов в форматы изображений, такие как PNG и JPEG, для просмотра.
Вывод потокового изображения - Руководство по потоковой передаче форматов изображений из средства просмотра документов.
Настройка разрешения изображения - Параметры настройки определенного разрешения изображения при просмотре документов в виде изображений.
Рендеринг изображений многостраничных документов - Инструкция по рендерингу многостраничных документов в виде отдельных изображений.

Просмотрщик PDF-файлов

Конвертируйте документы в PDF - Преобразуйте любой поддерживаемый формат документа в PDF для просмотра.
Потоковое PDF-вывод - Руководство по потоковой передаче содержимого PDF для оптимизированного просмотра в браузерах или приложениях.
Встроить программу просмотра PDF - Инструкции по встраиванию настраиваемого средства просмотра PDF-файлов в ваше приложение.
Поддержка просмотра PDF-файлов - Функции просмотра и взаимодействия с PDF-документами.

Рендеринг документа

Преобразование документа в HTML, изображение или PDF - Параметры преобразования документов в форматы HTML, изображения или PDF для просмотра.
Потоковый рендеринг - Потоковая передача обработанного вывода документа для доступа в реальном времени в вашем приложении.
Рендеринг многостраничных документов - Поддержка рендеринга многостраничных документов в несколько файлов HTML, изображений или PDF.

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

Специализированная обработка типов файлов - Пользовательские параметры рендеринга, адаптированные для различных типов документов, таких как Word, Excel, PDF и других.
Сохранить функции документа - Убедитесь, что исходные функции документа, такие как макет, текст и форматирование, сохраняются во время рендеринга.

Рендеринг архивных файлов

Рендеринг файлов ZIP, RAR и TAR - Преобразуйте форматы архивных файлов, такие как ZIP, RAR и TAR, в доступный для просмотра контент.
Извлечение и рендеринг определенных файлов - Извлекайте определенные файлы из архивов и визуализируйте их, не загружая весь архив.

Рендеринг чертежей САПР

Визуализация форматов САПР (DWG, DXF и т. д.) - Конвертируйте и отображайте файлы САПР, такие как DWG и DXF, для детального просмотра.
Настройка параметров рендеринга САПР - Установите определенные параметры для рендеринга САПР, такие как уровень масштабирования, видимость слоев и макет.

Рендеринг сообщений электронной почты

Визуализация форматов MSG, EML и MHTML - Просматривайте сообщения электронной почты в таких форматах, как MSG, EML и MHTML, непосредственно в средстве просмотра.
Просмотр вложений - Автоматически визуализируйте и отображайте вложения электронной почты для быстрого доступа.

Отображение сообщений базы данных Lotus Notes

Рендеринг сообщений базы данных NSF - Преобразование и просмотр сообщений базы данных Lotus Notes (NSF) в поддерживаемых форматах.
Доступ к встроенным элементам - Отображение и просмотр встроенных изображений, файлов и ссылок в сообщениях базы данных Lotus Notes.

Рендеринг документов MS Project

Рендеринг файлов проекта MS (MPP) - Конвертируйте файлы MS Project (MPP) в HTML, изображения или PDF для удобного просмотра.
Просмотр данных проекта - Отрисовка представлений задач, ресурсов и диаграмм Ганта из файлов MS Project.

Рендеринг файлов данных Outlook

Рендеринг файлов PST и OST - Преобразуйте файлы данных Outlook PST и OST в форматы HTML, изображения или PDF для просмотра.
Просмотр электронной почты, календарей и контактов - Отображение отдельных сообщений электронной почты, событий календаря и контактных данных из файлов данных Outlook.

Рендеринг PDF-документов

Конвертируйте PDF в HTML, изображения или другие форматы - Преобразование PDF-документов в HTML, изображения или другие поддерживаемые форматы для просмотра через Интернет или приложение.
Аннотации и закладки в формате PDF - Поддержка рендеринга PDF-документов с аннотациями, закладками и другими встроенными элементами.

Рендеринг электронных таблиц

Рендеринг файлов Excel (XLS, XLSX) - Преобразуйте файлы электронных таблиц, такие как XLS и XLSX, в форматы HTML, изображения или PDF.
Просмотр диаграмм и формул - Рендеринг электронных таблиц, формул и сложных форматов ячеек для точного просмотра.

Рендеринг текстовых файлов

Рендеринг обычного текста и файлов CSV - Преобразуйте обычный текст и файлы CSV в HTML, изображения или PDF для упрощения просмотра.
Сохранить форматирование текста - Сохраняйте исходное расположение и форматирование текста во время рендеринга.

Рендеринг документов Visio

Рендеринг файлов Visio (VSD, VSDX) - Конвертируйте и отображайте файлы схем Visio в форматах HTML, изображения или PDF.
Просмотр диаграмм и блок-схем - Отрисовывайте диаграммы, блок-схемы и фигуры из файлов Visio для наглядности.

Рендеринг текстовых документов

Рендеринг файлов Word (DOC, DOCX, ODT) - Преобразуйте файлы обработки текста, такие как DOC, DOCX и ODT, в форматы HTML, изображения или PDF.
Сохранить структуру документа - Обеспечьте точную визуализацию структуры документа, включая верхние и нижние колонтитулы и форматирование.

Работа со страницами документа

Извлечение страниц из документов - Извлекайте определенные страницы из документов для индивидуального рендеринга.
Настройка просмотра страниц - Управляйте параметрами нумерации страниц и отображения страниц для просмотра документов.

Рендеринг страниц документа

Рендеринг страниц в HTML, изображения или PDF - Преобразуйте отдельные страницы документа в форматы HTML, изображения или PDF для просмотра.
Вывод страницы потока - Потоковая передача отдельных страниц документа для ускорения загрузки и просмотра в реальном времени.

Минимизация HTML и SVG

Минимизировать HTML-контент - Уменьшите размер отображаемого HTML-содержимого для более быстрой загрузки страниц.
Оптимизация вывода SVG - Минимизируйте и оптимизируйте вывод SVG, чтобы повысить производительность без потери качества.

Рендеринг документа в адаптивный HTML

Преобразование в адаптивный HTML - Отображайте документы в виде адаптивного HTML, который адаптируется к различным размерам экрана и устройствам.
Просмотр на мобильных устройствах - Убедитесь, что документы оптимизированы для мобильных и планшетных устройств с помощью адаптивного рендеринга HTML.

Работа с вложениями

Извлечение и рендеринг вложений - Извлекайте и визуализируйте вложения из документов или сообщений электронной почты для удобства просмотра.
Просмотр типов вложений - Поддержка просмотра различных типов вложений, таких как изображения, документы и архивы.

Лицензирование и аутентификация

Режим оценки - Отображение документов с водяными знаками во время судебного разбирательства.
Безопасная аутентификация - Используйте идентификатор клиента и секрет клиента для безопасного доступа к API.
Лицензия MIT - Python SDK лицензируется по Лицензии MIT.

Поддерживаемые форматы документов

GroupDocs.Viewer Cloud поддерживает более 190 форматов файлов в следующих категориях:

• Обработка текста: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT, ODT, OTT
• Таблицы: XLS, XLSX, XLSB, XLSM, CSV, ODS, OTS, TSV
• Презентации: PPT, PPTX, PPTM, PPS, PPSX, PPSM, ODP, OTP, POTX, POTM
• PDF и макет страницы: PDF, XPS, TEX
• Изображения: BMP, GIF, JPEG, PNG, TIFF, SVG, PSD, WEBP, ICO, EMF, WMF, and more
• САПР и диаграммы: DWG, DXF, DWF, DGN, IFC, STL; VSD, VSDX, VSS, VST, and related Visio formats
• Электронная почта и Outlook: MSG, EML, EMLX, MHT, PST, OST
• Интернет: HTML, HTM, MHT, MHTML
• Архивы: ZIP, RAR, TAR, and other archive formats
• Управление проектом: MPP, MPT
• электронные книги: EPUB, MOBI
• Примечания: ONE (Microsoft OneNote)
• Заметки Лотоса: NSF database messages

Все поддерживаемые форматы могут отображаться как HTML, PNG/JPG или PDF. Полную матрицу форматов см. в документации.

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

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

Чтобы использовать GroupDocs.Viewer Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.

Инициализируйте API

Используйте следующий код, чтобы начать использовать Cloud SDK GroupDocs.Viewer для Python:

import groupdocs_viewer_cloud

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

# Create API configuration
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the View API
view_api = groupdocs_viewer_cloud.ViewApi.from_config(configuration)

Преобразовать документ в HTML

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

import groupdocs_viewer_cloud

client_id = "YourClientId"
client_secret = "YourClientSecret"

view_api = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered: " + str(len(response.pages)) + " pages")

Благодаря этому краткому руководству вы можете приступить к рендерингу документов с помощью GroupDocs.Viewer Cloud в своих приложениях Python. Для получения более подробной информации посетите документацию.

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

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

import groupdocs_viewer_cloud

info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

try:
    response = info_api.get_supported_file_formats()

    print("Supported file-formats:")
    for fmt in response.formats:
        print("{0} ({1})".format(fmt.file_format, fmt.extension))
except groupdocs_viewer_cloud.ApiException as e:
    print("Exception when calling get_supported_file_formats: {0}".format(e.message))

Отобразить документ в формате PDF

В этом примере показано, как преобразовать документ Word в формат PDF с помощью GroupDocs.Viewer Cloud API.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "PDF"
view_options.render_options = groupdocs_viewer_cloud.PdfOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Document rendered to PDF: " + response.file.path)

Отобразить электронную таблицу как HTML

Этот пример кода преобразует электронную таблицу Excel в HTML с помощью GroupDocs.Viewer Cloud API.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Spreadsheet rendered to HTML: " + str(len(response.pages)) + " pages")

Рендеринг документа с адаптивным HTML-макетом

Отобразите документ в виде адаптивного HTML-кода, который адаптируется к различным размерам экрана и устройствам.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.is_responsive = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Responsive HTML rendered: " + str(len(response.pages)) + " pages")

Рендеринг выбранных страниц

Конвертируйте только определенные страницы документа, экономя время обработки, когда требуется только часть документа.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.pages_to_render = [2, 3]

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Selected pages rendered: " + str(len(response.pages)) + " pages")

Рендеринг документа Word с отслеживаемыми изменениями

Отобразите документ Word, включая отслеживаемые изменения в выходном HTML.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/with_tracked_changes.docx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.word_processing_options = groupdocs_viewer_cloud.WordProcessingOptions()
view_options.render_options.word_processing_options.render_tracked_changes = True

request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = view_api.create_view(request)

print("Tracked changes rendered: " + str(len(response.pages)) + " pages")

Получить информацию о документе

Получите метаданные документа, такие как количество страниц, перед рендерингом.

import groupdocs_viewer_cloud

info_api = groupdocs_viewer_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "SampleFiles/sample.docx"

request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
result = info_api.get_info(request)

print("Document pages: " + str(len(result.pages)))

Конвертируйте и загружайте без облачного хранилища

Отрисуйте локальный документ напрямую и получите выходной файл без предварительной загрузки в облачное хранилище.

import groupdocs_viewer_cloud

view_api = groupdocs_viewer_cloud.ViewApi.from_keys("YourClientId", "YourClientSecret")

with open("sample.docx", "rb") as file:
    request = groupdocs_viewer_cloud.ConvertAndDownloadRequest("jpg", file)
    output_path = view_api.convert_and_download(request)

print("Convert and download completed: " + output_path)

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

Репозиторий GroupDocs.Viewer Cloud Python Samples включает готовые примеры, охватывающие:

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

1. Клонируйте или загрузите репозиторий образцов.
2. Перейдите в каталог «Примеры».
3. Отредактируйте RunExamples.py и установите client_id и client_secret.
4. Запустите pip install groupdocs-viewer-cloud -U
5. Выполните python RunExamples.py

Для получения более подробной информации посетите Начало работы.

Теги

API рендеринга документов | Python Cloud API | GroupDocs.Viewer Cloud | REST API | HTML-рендеринг | Преобразование PDF | Рендеринг изображения | Просмотр документа | Многостраничный рендеринг | Потоковая передача документов | CAD-рендеринг | Визуализация сообщений электронной почты | Visio Rendering | Рендеринг MS Project | Рендеринг данных Outlook | Рендеринг электронных таблиц | Рендеринг текстовой обработки | Параметры пользовательского просмотра | Адаптивный HTML | Визуализация вложений | Безопасный доступ к API | Интеграция облачного хранилища