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 アドイン ] ダイアログで、[ マイ アドインのアップロード] を選択します。

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

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

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

重要

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

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

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

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

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

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

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

それ以外の場合は、サイドロードされたアドインを削除するには、「 開発中のアドインをアンインストールする」を参照してください。

関連項目