Office クライアントの起動モードを構成する
次を使用して Microsoft Graph APIからDriveItem
を取得する場合:
/graph/api/driveitem-get?view=graph-rest-1.0
応答の webUrl
プロパティには、サポートされている Office ファイルの種類をレンダリングするための Web アプリケーション オープン プラットフォーム インターフェイス (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 は、空白のウィンドウまたは新しいタブで開く必要があります。