Настройка интерфейса запуска по умолчанию для файлов Office
Настройка режима запуска клиентов Office
При получении DriveItem
из microsoft API Graph с помощью:
/graph/api/driveitem-get?view=graph-rest-1.0
Свойство webUrl
в ответе может быть ссылкой на интерфейс веб-приложения с открытой платформой (WOPI) для отрисовки поддерживаемых типов файлов Office. URL-адрес будет выглядеть следующим образом:
https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true
Откроется webUrl
WOPI в режиме по умолчанию (action=default
). Если вы хотите переопределить режим по умолчанию для принудительного применения определенного режима (например, view for read-only and Edit for editor), можно дополнить следующее webUrl
:
string webUrl = https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true;
System.UriBuilder builder = new System.UriBuilder(webUrl);
System.Collections.Specialized.NameValueCollection queryDictionary = System.Web.HttpUtility.ParseQueryString(builder.Query);
queryDictionary["action"] = "view";
//queryDictionary["action"] = "edit";
builder.Query = queryDictionary.ToString();
string modifiedWebUrl = builder.ToString();
Совет
Дополнительные сведения о действиях WOPI см. в статье Обнаружение WOPI — действия WOPI.
Открытие файлов Office непосредственно в классических клиентах
Чтобы открыть файлы непосредственно в классических клиентах Office, необходимо создать схему URI Office. Формат выглядит следующим образом:
<scheme-name>:<command-name>"|"<command-argument-descriptor>"|"<command-argument>
Используйте следующую таблицу, чтобы заменить предыдущие сегменты:
- scheme-name: имя приложения, например ms-excel
-
command-name:
-
ofv
для представления "Открыть файл" -
ofe
Для редактирования открытого файла -
nft
для нового из шаблона
-
-
command-argument-descriptor и command-argument:
|u|{file url}
|s|{save location}
- Только для нового шаблона
Примечание.
Новый шаблон может работать не так, как ожидалось бы для расположения сохранения, так как схема разрешений отличается от схемы сайтов SharePoint.
Ниже приведен пример использования схемы URI Office.
ms-word:ofv|u|https://contoso.com/document.docx
ms-powerpoint:ofe|u|https://contoso.com/presentation.pptx
webUrl
Так как свойство указывает на документы Office Online для Office, фактическую ссылку необходимо получить в два этапа:
- Получение WebUrl родительской папки
- Добавление имени файла
Например, следующая схема:
ms-word:ofe|u|{folder.WebUrl]/{item.Name}
... результатом будет следующая схема:
ms-word:ofe|u|https://contoso.sharepoint.com/contentstorage/CSP_1234765465/Document%20Library/MyDocument.docx
Дополнительные сведения о схемах URI Office см. в статье Схемы URI Office.
Примечание.
Универсальный код ресурса (URI) должен быть открыт в пустом окне или на новой вкладке.