Office アドインをOffice on the webにサイドロードする

[アーティクル]
09/01/2024

アドインをサイドロードすると、アドインカタログに最初に配置しなくてもアドインをインストールできます。これは、アドインの表示方法と機能を確認できるため、アドインのテストと開発に役立ちます。

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 に置き換えます。

注:

Mac で開発している場合は、 {url} を単一引用符で囲みます。 Windows ではこれを行 わないでください 。
```
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
ドキュメントにアドインがサイドロードされない場合は、「アドインを手動でサイドロードして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 アドイン ] ダイアログで、[ MY ADD-INS ] タブを選択し、[ マイアドインの管理] を選択し、[ マイアドインのアップロード] を選択します。
アドインマニフェストファイルを参照して、[アップロード] を選択します。
アドインがインストールされていることを確認します。たとえば、アドインコマンドがある場合は、リボンまたはコンテキストメニューに表示されます。アドインコマンドがない作業ウィンドウアドインの場合は、作業ウィンドウが表示されます。

注:

EdgeHTML (Microsoft Edge 従来版) で Office アドインをテストするには、追加の構成手順が必要です。 Windows コマンドプロンプトで、次の行を実行します: npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes。これは、Office が Chromium ベースの Edge WebView2 を使用している場合は必要ありません。詳細については、「 Office アドインで使用されるブラウザーと Webview コントロール」を参照してください。

重要

Office-addin-dev-settings ツールは Mac ではサポートされていません。

アドインを Microsoft 365 にサイドロードする

Microsoft 365 アカウントにサインインします。
ツールバーの左端にあるアプリ起動ツールを開き、[Excel]、[OneNote]、[PowerPoint]、または [Word] を選択し、新しいドキュメントを作成します。
「手動でアドインをOffice on the webにサイドロードする」セクションの手順 2 から 5 に従います。

サイドロードされたアドインを削除する

npm start コマンドを実行し、アドインが自動的にサイドロードされた場合は、開発サーバーを停止してアドインをアンインストールする準備ができたら、npm stopを実行します。

それ以外の場合は、Office on the webにサイドロードされたアドインを削除するには、ブラウザーのキャッシュをクリアするだけです。アドインのマニフェストを変更する場合 (たとえば、アイコンのファイル名の更新やアドインコマンドのテキストの更新)、ブラウザーのキャッシュをクリアしてから、更新されたマニフェストを使用してアドインを再サイドロードする必要がある場合があります。これにより、更新されたマニフェストで説明されているように、Office on the webアドインをレンダリングできます。

次の方法で共有