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

  • [アーティクル]

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

Web でアドインをサイドロードする場合、アドインのマニフェストはブラウザーのローカル ストレージに格納されるため、ブラウザーのキャッシュをクリアするか、別のブラウザーに切り替える場合は、もう一度アドインをサイドロードする必要があります。

Web 上でアドインをサイドロードする手順は、次の要因によって異なります。

  • ホスト アプリケーション (Excel、Word、Outlook など)
  • アドイン プロジェクトを作成したツール (たとえば、Visual Studio、Office アドイン用 Yeoman ジェネレーター、またはどちらも作成しません)
  • Microsoft アカウントを使用してOffice on the webにサイドローディングする場合も、Microsoft 365 テナント内のアカウントを使用する場合も

次の一覧で、シナリオに一致するセクションまたは記事に移動します。 一覧の最初のシナリオは Outlook アドインに適用されることに注意してください。残りのシナリオは、Outlook 以外のアドインに適用されます。

Yeoman で作成されたアドインをOffice on the webにサイドロードする

このプロセスは、Excel、OneNote、PowerPoint、Wordでのみサポートされています。 このプロジェクト例では、 Office アドイン用 Yeoman ジェネレーターで作成されたプロジェクトを使用していることを前提としています。

  1. Office on the web または OneDrive を開きます。 [作成] オプションを使用して、Excel、OneNote、PowerPoint、またはWordでドキュメントを作成します。 この新しいドキュメントで、[ 共有] を選択し、[ リンクのコピー] を選択し、URL をコピーします。

  2. 管理者としてコマンド プロンプトを開きます。 プロジェクトのルート ディレクトリから始まるコマンド ラインで、次のコマンドを実行します。 "{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する」の手順に従って手動でサイドロードします。

  3. このメソッドを初めて使用して Web 上のアドインをサイドロードすると、開発者モードを有効にするように求めるダイアログが表示されます。 [ 今すぐ開発者モードを有効にする] のチェック ボックスをオンにし、[ OK] を選択します。

  4. コンピューターから Office アドイン マニフェストを登録するかどうかを確認する 2 つ目のダイアログ ボックスが表示されます。 [はい] を選択します。

  5. アドインがインストールされています。 アドイン コマンドがある場合は、リボンまたはコンテキスト メニューに表示されます。 アドイン コマンドのない作業ウィンドウ アドインの場合は、作業ウィンドウが表示されます。

Visual Studio を使用するときにアドインを Web にサイドロードする

Visual Studio を使用してアドインを開発している場合は、 F5 キーを押して デスクトップ Office で Office ドキュメントを開き、空白のドキュメントを作成し、アドインをサイドロードします。 Office on the webにサイドロードする場合、サイドロードするプロセスは、Web への手動サイドローディングに似ています。 唯一の違いは、マニフェスト内の SourceURL 要素と場合によっては他の要素の値を更新して、アドインがデプロイされる完全な URL を含める必要があるということです。

  1. Visual Studio で、[プロパティ ウィンドウの表示>] を選択します。

  2. [ソリューション エクスプローラー] で Web プロジェクトを選択します。 プロジェクトのプロパティが [ プロパティ ] ウィンドウに表示されます。

  3. [プロパティ] ウィンドウで、[SSL URL] をコピーします。

  4. アドイン プロジェクトで、マニフェスト XML ファイルを開きます。 ソース XML を編集していることを確認します。 一部のプロジェクトの種類では、次の手順では機能しない XML のビジュアル ビューが Visual Studio によって開きます。

  5. ~remoteAppUrl/ のすべてのインスタンスを検索し、先ほどコピーした SSL URL と置き換えます。 プロジェクトの種類に応じていくつかの置換が表示され、新しい URL は に https://localhost:44300/Home.html似ています。

  6. XML ファイルを保存します。

  7. ソリューション エクスプローラーで、Web プロジェクトのコンテキスト メニュー (右クリックなど) を開き、[デバッグ>] [新しいインスタンスの開始] の順に選択します。 これにより、Office を起動せずに Web プロジェクトが実行されます。

  8. Office on the webから、「手動でアドインをOffice on the webにサイドロードする」で説明されている手順を使用してアドインをサイドロードします。

アドインを手動でサイドロードしてOffice on the web

このメソッドはコマンド ラインを使用せず、ホスト アプリケーション (Excel など) 内でのみコマンドを使用して実行できます。

  1. Office on the webを開きます。 Excel、OneNote、PowerPoint、またはWordでドキュメントを開きます。

  2. [ ホーム>アドイン] を選択し、[ その他のアドイン] を選択します。

  3. [ Office アドイン ] ダイアログで、[ MY ADD-INS ] タブを選択し、[ マイ アドインの管理] を選択し、[ マイ アドインのアップロード] を選択します。

    右上にある [アドインの管理] というドロップダウンと、[マイ アドインのアップロード] オプションが表示されたドロップダウンが表示された [Office アドイン] ダイアログ。

  4. アドイン マニフェスト ファイルを参照して、[アップロード] を選択します。

    [参照]、[アップロード]、[キャンセル] のボタンがある [アドインのアップロード] ダイアログ。

  5. アドインがインストールされていることを確認します。 たとえば、アドイン コマンドがある場合は、リボンまたはコンテキスト メニューに表示されます。 アドイン コマンドがない作業ウィンドウ アドインの場合は、作業ウィンドウが表示されます。

注:

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 にサイドロードする

  1. Microsoft 365 アカウントにサインインします。

  2. ツール バーの左端にあるアプリ起動ツールを開き、[Excel]、[OneNote]、[PowerPoint]、または [Word] を選択し、新しいドキュメントを作成します。

  3. 「手動でアドインをOffice on the webにサイドロードする」セクションの手順 2 から 5 に従います。

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

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

関連項目