WOPI обнаружение — это процесс, который помогает серверу WOPI обнаруживать клиента WOPI, запрашивая XML-файл обнаружения из онлайн-офиса. Хосты WOPI используют XML для обнаружения, чтобы указать, как взаимодействовать с онлайн-офисом. Запросы отправляются на адрес https://documentserver/hosting/discovery, где documentserver — это имя сервера с установленным Р7 Document Server.
Действия по обнаружению WOPI
Элемент действия XML-файла обнаружения обеспечивает важные характеристики онлайн-офиса. Этот элемент представляет:
- доступные операции с документами в онлайн-кабинете,
- поддерживаемые форматы файлов (расширения).
Название | Описание |
view | Отображает нередактируемый вид документа. |
edit | Позволяет пользователям редактировать документ. |
editnew | Создает новый документ, используя пустой шаблон файла, соответствующий типу файла, и открывает этот файл для редактирования в онлайн-офисе. |
embedview | Отображает нередактируемый вид документа, оптимизированный для встраивания в веб-страницу. Это действие доступно начиная с версии 7.2. |
Название | Описание |
requires | Endpoints WOPI REST, необходимые для использования действий. |
urlsrc | URL-адрес, по которому вы переходите, чтобы вызвать действие для определенного файла. |
<action name="edit" ext="docx" requires="locks,update"
urlsrc="https://word-edit.officeapps.live.com/we/wordeditorframe.aspx?
ui=en-us&thm=1&"/>
Discovery query parameters — это параметры, которые могут быть представлены файловым хранилищем в атрибуте url src для настройки поведения редактора. Например, изменить язык, тему или чат.
Стандарт WOPI
Название | Описание | Пример |
ui | Указывает, что сервер WOPI включает предпочитаемый язык пользовательского интерфейса (UI) в формате, описанном в [RFC1766]. | en-us |
rs | Указывает, что сервер WOPI включает предпочтительный язык данных в формате, описанном в [RFC1766], для случаев, когда язык может повлиять на вычисление данных (в редакторе электронных таблиц). | en-us |
thm | Указывает, что сервер WOPI включает значение для обозначения используемой темы. Текущие значения: «1» для обозначения светлой темы и «2» для обозначения темной темы. | 1 |
dchat | Указывает, что сервер WOPI включает значение «1» для загрузки представления документа, которое не создает сеанс чата и не присоединяется к нему. | 1 |
embed | Указывает, что результат действия будет встроен в веб-страницу (true). | true |
Collabora specific
Обратите внимание на структуру discovery.xml коннекторов Collabora. Они открывают редактор через MIME-тип, который входит в элемент приложения следующей структуры:
<app name="application/msword">
<action default="true" ext="" name="edit" urlsrc="http://159.89.20.129:9980/loleaflet/ba528af/loleaflet.html?"/>
</app>
Элемент приложения, подобный этому:
<app name="Word" favIconUrl="http://localhost:8000/web-apps/apps/documenteditor/main/resources/img/favicon.ico">
игнорируется коннекторами Collabora.