iOS アプリケーションからの Office との統合
Office for iOS は、サード パーティ アプリケーションとの統合を可能にする拡張可能なソリューションを提供します。 この記事では、アプリケーションから Office にユーザーを渡し、その後アプリケーションに戻すことによって、iOS アプリケーションから Office と統合する方法について説明します。
iOS デバイス上で Office を実行しているユーザーが、SharePoint または OneDrive に保存されているファイルを、任意のアプリケーションから開いて編集し、編集が完了したらすばやく元のアプリケーションに戻れるようにできます。 そうするには、プロトコル ハンドラーを介してファイルを Office に渡し、Office で認識されるよう Office が確実に呼び出されるようにします。
Office アプリケーションの起動時に特定の情報を渡しておけば、ユーザーが編集を完了した際、Office アプリケーションの [戻る] 矢印を使ってドキュメントを閉じて元のストレージ アプリケーションに戻るようにすることができます。
Office がインストールされていることを確認する
参照元のアプリケーションは、最初に特定の Office アプリケーションがインストールされていることを確認する必要があります。 次の Office アプリケーションは、ドキュメントを表示および編集するために iOS デバイスにインストールできます。
Excel
OneNote
PowerPoint
Word
canOpenURL メソッドを使用して、アプリケーションがリソースを開くことができるかどうかを確認します。 このメソッドは、リソースの URL をパラメーターとして認識し、その URL を受け付けるアプリケーションを使用できない場合は No を返します。 canOpenURL が No を返す場合は、Office をインストールするようユーザーに要求する必要があります。
Office をインストールするようユーザーに求める
特定の Office アプリケーションがインストールされていない場合は、SKProductViewController オブジェクトを使用して iTunes アプリ ストアをアプリケーション内でレンダリングし、ユーザーにインストールする Office アプリケーションを示します。 次の表に、ストア キット製品ビュー コントローラー内でそれぞれの Office アプリケーションを呼び出すための iTunes 識別子を一覧表示します。
Office を呼び出す
Office アプリケーションがインストールされている場合、参照元のアプリケーションは次の情報を渡すことで Office を呼び出すことができます。
Office プロトコル
オープン モード
URL
Passback プロトコル
ドキュメントのコンテキスト
スキーマ形式:
<Office protocol><open mode>|u|<URL>|p|<passback protocol>|c|<document context>
次の例は、編集用に Word ファイルを呼び出すための要求を示します。
ms-word:ofe|u|https://contoso/Q4/budget.docx|p|clouddrive|c|folderviewQ4
Office プロトコル
次の表に、各 Office アプリケーションのプロトコルを一覧表示します。
| アプリケーション | プロトコル |
|---|---|
| Excel |
ms-excel: |
| OneNote |
onenote: |
| PowerPoint |
ms-powerpoint: |
| Word |
ms-word: |
オープン モード
Office アプリケーションは、ファイルを表示 (ofv) モードまたは編集 (ofe) モードで直接開くことができます。 既定は編集モードです。
スキーマ形式:
<ofv or ofe>
URL
URL は 3 つの部分で構成されます。
編集用 (ofe) にファイルを開くための宣言
URL 記述子 (|u|)
URL
URL は、エンコードされる必要があり、ファイルへの直接リンク (リダイレクトではない) でなければなりません。 URL が Office で扱うことのできない形式か、または単純にダウンロードに失敗した場合、Office は、呼び出し元のアプリケーションにユーザーを戻すことができません。
スキーマ形式:
|u|<document URL>
Passback プロトコル (省略可能)
[戻る] 矢印をクリックしたときに Office がユーザーを iOS アプリケーションに戻るようにする場合、呼び出し元のアプリケーションは、Passback プロトコル (記述子 '|p|' (コロンなし) にアプリのプロトコルを続けたものを含む) を使用する必要があります。 アプリケーションが Office からの応答を適切に処理できることを確認する必要があります。
スキーマ形式:
|p|<passback protocol>
ドキュメントのコンテキスト (省略可能)
Office はドキュメント コンテキストを使用しませんが、Office がユーザーを引き渡すときに参照元のアプリケーションで必要になる場合があります。 ドキュメント コンテキストをアプリケーションに返す場合は、記述子 '|c|' の後に文字列として必要なコンテキストを使用します。 Office では、オペレーティング システムによって課される制限を超えて、文字列の長さを制限しません。
スキーマ形式:
|c|<document context>
参照元のアプリケーションにユーザーを返す
セキュリティ上の理由から、ファイルが正常に開いた場合、Office は参照元のアプリケーションにユーザーのみを返します。 ユーザーが [戻る] 矢印をクリックすると、参照元のアプリケーションに対して Office は、Passback プロトコル、オープン モード、URL、アップロード保留中の状態、およびドキュメントのコンテキストで応答します。 アップロード保留中の状態は、記述子 |z| を使用し、"yes" または "no" のいずれかです。
スキーマ形式:
<app protocol>:ofe|u|<URL>|z|<yes or no>|c|<doc context> Example: clouddrive:ofe|u|https://contoso/Q4/budget.docx|z|no|c|folderviewQ4