Office ファイルの既定の起動エクスペリエンスを構成する
Office クライアントの起動モードを構成する
Microsoft Graph APIから を取得DriveItem
する場合は、次を使用します。
/graph/api/driveitem-get?view=graph-rest-1.0
応答のプロパティは webUrl
、サポートされている Office ファイルの種類をレンダリングするための Web アプリケーション Open Platform Interface (WOPI) へのリンクにすることができます。 URL は次のようになります。
https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true
これにより webUrl
、既定のモード (action=default
) で WOPI が開きます。 既定のモードをオーバーライドして特定のモードを強制する場合 (たとえば、[読み取り専用の表示] と [エディターの編集] など)、次のように拡張 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 デスクトップ クライアントでファイルを直接開くには、Office URI スキームを作成する必要があります。 形式は次のとおりです。
<scheme-name>:<command-name>"|"<command-argument-descriptor>"|"<command-argument>
前のセグメントを置き換えるには、次の表を使用します。
- scheme-name: アプリケーションの名前 (ms-excel など)
- command-name:
ofv
[ファイル ビューを開く] の場合ofe
[Open File Edit]\(ファイルを開く\) のnft
テンプレートから新規作成
- command-argument-descriptor と command-argument:
|u|{file url}
|s|{save location}
- 新規テンプレートの場合のみ
注:
アクセス許可スキーマが SharePoint サイトと異なるため、保存場所に期待どおりに 新しいテンプレート が機能しない場合があります。
次に、Office URI スキームの使用例を示します。
ms-word:ofv|u|https://contoso.com/document.docx
ms-powerpoint:ofe|u|https://contoso.com/presentation.pptx
プロパティは webUrl
Office Online for Office ドキュメントを指しているため、次の 2 つの手順で実際のリンクを取得する必要があります。
- 親フォルダーの WebUrl の取得
- ファイルの名前の追加
たとえば、次のスキームです。
ms-word:ofe|u|{folder.WebUrl]/{item.Name}
...は、次のスキームになります。
ms-word:ofe|u|https://contoso.sharepoint.com/contentstorage/CSP_1234765465/Document%20Library/MyDocument.docx
Office URI スキームの詳細については、「 Office URI スキーム」を参照してください。
注:
Uri は、空白のウィンドウまたは新しいタブで開く必要があります。