Поделиться через

Настройка интерфейса запуска по умолчанию для файлов 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, фактическую ссылку необходимо получить в два этапа:

  1. Получение WebUrl родительской папки
  2. Добавление имени файла

Например, следующая схема:

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) должен быть открыт в пустом окне или на новой вкладке.