Office アドインをOffice on the webにサイドロードする
アドインをサイドロードする場合は、まずアドイン カタログにアドインを配置せずにアドインをインストールできます。 これは、アドインの表示方法と機能を確認できるため、アドインのテストと開発に役立ちます。
Web でアドインをサイドロードする場合、アドインのマニフェストはブラウザーのローカル ストレージに格納されるため、ブラウザーのキャッシュをクリアするか、別のブラウザーに切り替える場合は、もう一度アドインをサイドロードする必要があります。
Web 上でアドインをサイドロードする手順は、次の要因によって異なります。
- ホスト アプリケーション (Excel、Word、Outlook など)
- アドイン プロジェクトを作成したツール (たとえば、Visual Studio、Office アドイン用 Yeoman ジェネレーター、またはどちらも作成しません)
- Microsoft アカウントを使用してOffice on the webにサイドローディングする場合も、Microsoft 365 テナント内のアカウントを使用する場合も
次の一覧で、シナリオに一致するセクションまたは記事に移動します。 一覧の最初のシナリオは Outlook アドインに適用されることに注意してください。残りのシナリオは、Outlook 以外のアドインに適用されます。
Outlook アドインをサイドロードする場合は、「 テスト用の Outlook アドインをサイドロードする」の記事を参照してください。
Office アドイン用 Yeoman ジェネレーターを使用してアドインを作成した場合は、「Yeoman で作成されたアドインをOffice on the webにサイドロードする」を参照してください。
Visual Studio を使用してアドインを作成した場合は、「Visual Studio を 使用するときに Web でアドインをサイドロードする」を参照してください。
その他のすべてのケースについては、次のセクションのいずれかを参照してください。
- Microsoft アカウントを使用してOffice on the webにサイドローディングする場合は、「アドインを手動でOffice on the webにサイドロードする」を参照してください。
- Microsoft 365 テナント内のアカウントを使用してOffice on the webにサイドローディングする場合は、「Microsoft 365 へのアドインのサイドロード」を参照してください。
Yeoman で作成されたアドインをOffice on the webにサイドロードする
このプロセスは、 Excel、 OneNote、 PowerPoint、 Word でのみサポートされています。 このプロジェクト例では、 Office アドイン用 Yeoman ジェネレーターで作成されたプロジェクトを使用していることを前提としています。
Office on the web または OneDrive を開きます。 [作成] オプションを使用して、Excel、OneNote、PowerPoint、または Word でドキュメントを作成します。 この新しいドキュメントで、[ 共有] を選択し、[ リンクのコピー] を選択し、URL をコピーします。
プロジェクトのルート ディレクトリから始まるコマンド ラインで、次のコマンドを実行します。 "{url}" をコピーした URL に置き換えます。
npm run start:web -- --document {url}
次に例を示します。
npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R
npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp
npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP
注:
Mac で開発している場合は、 を
{url}
単一引用符で囲みます。 Windows ではこれを行 わないでください 。ドキュメントにアドインがサイドロードされない場合は、「アドインを手動でサイドロードしてOffice on the webする」の手順に従って手動でサイドロードします。
このメソッドを初めて使用して Web 上のアドインをサイドロードすると、開発者モードを有効にするように求めるダイアログが表示されます。 [ 今すぐ開発者モードを有効にする] のチェック ボックスをオンにし、[ OK] を選択します。
コンピューターから Office アドイン マニフェストを登録するかどうかを確認する 2 つ目のダイアログ ボックスが表示されます。 [はい] を選択します。
アドインがインストールされています。 アドイン コマンドがある場合は、リボンまたはコンテキスト メニューに表示されます。 アドイン コマンドのない作業ウィンドウ アドインの場合は、作業ウィンドウが表示されます。
Visual Studio を使用するときにアドインを Web にサイドロードする
Visual Studio を使用してアドインを開発している場合は、 F5 キーを押して デスクトップ Office で Office ドキュメントを開き、空白のドキュメントを作成し、アドインをサイドロードします。 Office on the webにサイドロードする場合、サイドロードするプロセスは、Web への手動サイドローディングに似ています。 唯一の違いは、マニフェスト内の SourceURL 要素と場合によっては他の要素の値を更新して、アドインがデプロイされる完全な URL を含める必要があるということです。
Visual Studio で、[プロパティ ウィンドウの表示>] を選択します。
[ソリューション エクスプローラー] で Web プロジェクトを選択します。 プロジェクトのプロパティが [ プロパティ ] ウィンドウに表示されます。
[プロパティ] ウィンドウで、[SSL URL] をコピーします。
アドイン プロジェクトで、マニフェスト XML ファイルを開きます。 ソース XML を編集していることを確認します。 一部のプロジェクトの種類では、次の手順では機能しない XML のビジュアル ビューが Visual Studio によって開きます。
~remoteAppUrl/ のすべてのインスタンスを検索し、先ほどコピーした SSL URL と置き換えます。 プロジェクトの種類に応じていくつかの置換が表示され、新しい URL は のように
https://localhost:44300/Home.html
表示されます。XML ファイルを保存します。
ソリューション エクスプローラーで、Web プロジェクトのコンテキスト メニュー (右クリックなど) を開き、[デバッグ>] [新しいインスタンスの開始] の順に選択します。 これにより、Office を起動せずに Web プロジェクトが実行されます。
Office on the webから、「手動でアドインをOffice on the webにサイドロードする」で説明されている手順を使用してアドインをサイドロードします。
アドインを手動でサイドロードしてOffice on the web
このメソッドはコマンド ラインを使用せず、ホスト アプリケーション (Excel など) 内でのみコマンドを使用して実行できます。
Office on the webを開きます。 Excel、OneNote、PowerPoint、または Word でドキュメントを開きます。
[ 挿入 ] タブの [アドイン] セクション で 、[ Office アドイン] を選択します。
[ Office アドイン ] ダイアログで、[ MY ADD-INS ] タブを選択し、[ マイ アドインの管理] を選択し、[ マイ アドインのアップロード] を選択します。
アドイン マニフェスト ファイルを参照して、[アップロード] を選択します。
アドインがインストールされていることを確認します。 たとえば、アドイン コマンドがある場合は、リボンまたはコンテキスト メニューに表示されます。 アドイン コマンドがない作業ウィンドウ アドインの場合は、作業ウィンドウが表示されます。
注:
元の WebView (EdgeHTML) を使用して Microsoft Edge で Office アドインをテストするには、追加の構成手順が必要です。 Windows コマンド プロンプトで、次の行を実行します。 npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes
これは、Office が Chromium ベースの Edge WebView2 を使用している場合は必要ありません。 詳細については、「Office アドインによって使用されるブラウザー」を参照してください。
重要
Office-addin-dev-settings ツールは Mac ではサポートされていません。
アドインを Microsoft 365 にサイドロードする
Microsoft 365 アカウントにサインインします。
ツール バーの左端にあるアプリ起動ツールを開き、[ Excel]、[ OneNote]、[ PowerPoint]、または [Word] を選択し、新しいドキュメントを作成します。
[ 挿入 ] タブ で、[アドイン ] ボタンを選択します。
「手動でアドインをOffice on the webにサイドロードする」セクションの手順 3 から 5 に従います。
サイドロードされたアドインを削除する
Office on the webにサイドロードされたアドインを削除するには、ブラウザーのキャッシュをクリアするだけです。 アドインのマニフェストを変更する場合 (たとえば、アイコンのファイル名の更新やアドイン コマンドのテキストの更新)、 ブラウザーのキャッシュをクリア してから、更新されたマニフェストを使用してアドインを再サイドロードする必要がある場合があります。 これにより、更新されたマニフェストで説明されているように、Office on the webアドインをレンダリングできます。