Server SDK
Подготовка сервисов документов, хранилища и прав доступа для приложения.
Univer Server SDK предоставляет набор комбинируемых модулей. Подключите нужные модули к своему backend и разверните приложение. Аутентификация, права, принадлежность документов, хранение файлов и эксплуатация остаются ответственностью приложения.
Эта страница описывает настройку сервера, хранилища и прав. Интеграция совместного редактирования подключает редактор к общим документам. Интеграция обмена файлами охватывает загрузку, преобразование и скачивание. Выберите руководство нужной функции. Для лицензируемых функций начните с настройки лицензии. Редактирование только в браузере не требует сервиса совместной работы.
Последовательность интеграции
- Quick Start: проверить двустороннее редактирование в двух независимых браузерных контекстах.
- Постоянное хранение: перезапустить SQLite и проверить значение.
- Идентификация и права: проверить editor и viewer.
- Frontend приложения: заменить демонстрационную идентификацию, создание документов и URL.
- Расширения: после базового сценария добавить историю, комментарии, Worktree или Exchange. Для одной конвертации начать с Exchange.
Выбор сервисов
| Потребность | Подготовка сервера | Руководство |
|---|---|---|
| Редактирование общих документов | Collaboration SDK, хранение документов и права | Быстрый старт совместного редактирования |
| Импорт и экспорт файлов Office | Преобразование, загрузки, опрос задач и скачивание | Преобразование файлов и пример Exchange |
| История или общие комментарии | Соответствующие сервисы, хранение и права | Модули расширений |
Выбирайте только нужные возможности. Преобразование файлов само по себе не требует совместного редактирования. Подготовьте среду SDK и обеспечьте совместимость версий пакетов Univer.
Подключение приложения и хранилища
Запустите пример выбранного сервиса и подключите его к своему серверу. Для совместных документов приложение создаёт документ, записывает владельца и возвращает ID браузеру. API создания описаны в разделе Границы модулей. Приложение продолжает управлять пользователями, проектами и папками.
Пример совместного редактирования использует память и теряет данные при перезапуске. Подключите базу данных по разделу Адаптеры баз данных и проверьте сохранность документов после перезапуска.
Преобразование файлов также требует хранения и очистки загрузок, задач и скачиваемых результатов. Следуйте примеру Exchange.
Подключение входа и прав доступа
Следуйте разделу Идентификация и авторизация, чтобы проверять существующие учётные данные и право пользователя читать или изменять документ. Замените фиксированных пользователей и разрешающие всё правила примера.
Защитите чтение документов, подключения совместного редактирования, отправку изменений и включённые функции истории, комментариев и скачивания. Режим только для чтения в браузере не заменяет проверки прав на сервере.
Развёртывание и подключение клиента
Разместите интерфейсы на домене приложения. Для совместного редактирования прокси должны передавать HTTP и WebSocket; HTTPS-страницы должны использовать WSS. Ограничьте загрузку файлов, обрабатывайте ошибки и тайм-ауты преобразования. Чтобы перейти от одной машины к отдельному узлу импорта и экспорта и к нескольким узлам совместного редактирования, следуйте Руководству по развертыванию.
После подготовки сервера завершите нужную интеграцию:
- Совместное редактирование: подключение редактора, создание и открытие общих документов, проверка синхронизации.
- Обмен файлами: подключение загрузки, преобразования и скачивания с проверкой на реальных файлах.
Насколько полезно это руководство?