Описание
Десктопные редакторы Р7 позволяют пользователям получать доступ к документам из облака и совместно работать над ними со своими коллегами по команде. В этом случае требуется подключение к Интернету.
В настоящее время пользователи могут подключить приложение к Р7 Workspace (SaaS или локально), Nextcloud, ownCloud или Seafile, но вы можете расширить этот список, добавив собственную DMS.
Последовательность
Выполните следующие действия, чтобы добавить собственную систему управления документами (DMS) в список подключений.
Шаг 1
Создайте папку, используя в качестве имени провайдер DMS (например, Р7) в каталоге провайдеров. Путь к папке зависит от используемой операционной системы:
- Для Linux —
/opt/Р7/desktopeditors/providers/ - Для Windows —
%ProgramFiles%\Р7\DesktopEditors\providers\ - Для Mac OS —
/Applications/Р7.app/Contents/Resources/providers/
Шаг 2
Создайте файл config.json, чтобы указать параметры интеграции.
Параметры
| Название | Описание | Тип | Пример |
|---|---|---|---|
| provider | Определяет идентификатор провайдера, используемый для ссылки на десктопные приложение в командах JavaScript | строковый | «Р7» |
| name | Определяет имя, отображаемое в разделе выбора провайдера при добавлении облака. | строковый | «Р7» |
| check | Определяет параметры проверки доступа к порталу:
Отправляется GET-запрос, после чего ожидается HTTP_STATUS_CODE=200. Ответ должен быть возвращен в формате JSON. | объект | |
| entryPage | Определяет URL для подключения к провайдеру. Он используется вместо адреса провайдера и позволяет десктопному приложению не отправлять запрос на проверку ↗. | строковый | «https://url-to-connect-provider.com» |
| extraLogout | Определяет URL-адрес для выхода из облака. Используется вместо адреса провайдера. | строковый или массив строк | «https://url-for-logout.com» |
| editorPage | Определяет относительный URL-адрес, указывающий, что тип открываемого файла является документом. | строковый | «/apps/Р7/» |
| Вы можете использовать регулярные выражения для этого параметра. Например: regex:\/lib\/(?:[\w-]{32,})\/file\/ | |||
| startPage | Определяет относительный URL, добавляемый к введенному IP или домену при создании нового соединения. | строковый | «/» |
| icons | Определяет значки для порталов:
Вы можете добавить значки для каждого типа темы пользовательского интерфейса (светлая и темная), указав объекты themeLight и themeDark с соответствующими значками. | объект | |
Пример
{
"provider": "Р7",
"name" : "Р7",
"check": {
"url": "status.php",
"headers": {
"OCS-APIREQUEST": true
}
},
"entryPage" : "https://url-to-connect-provider.com",
"extraLogout" : "https://url-for-logout.com",
"editorPage" : "/apps/Р7/",
"startPage" : "/",
"icons" : {
"themeLight": {
"connectionsList": "./assets/listicon.svg",
"buttonLogo": "./assets/buttonlogo.svg"
},
"themeDark": {
"connectionsList": "./assets/listicon_dark.svg",
"buttonLogo": "./assets/buttonlogo_dark.svg"
}
}
}
Шаг 3
Создайте две иконки для страницы приложения и поместите в папку, указанную в файле config.json:
- Значок для списка соединений. Требуемый размер значка — 36×36:
- Иконка для кнопки провайдера на странице подключения, когда список соединенных облак пуст. Требуемый размер значка — 148×38:
Поддерживаемые форматы изображений: .png, .jpeg, .svg. Мы рекомендуем использовать файл .svg для корректного отображения на мониторах HiDPI с масштабом 200% в системе.
Вы также можете добавить иконки для каждого типа темы пользовательского интерфейса (UI) (светлого и темного). В этом случае создайте четыре иконки (по две для каждой темы) и добавьте их все в файл config.json.
Шаг 4
Запустите Р7 Desktop Editors или перезапустите его при необходимости и перейдите в раздел Соединённые облака, чтобы проверить, правильно ли работает подключение.
