テスト用に Office on the web で Office アドインをサイドロードするSideload Office Add-ins in Office on the web for testing

サイドロードを使用することで、最初にアドイン カタログに置かなくても、テスト用に Office アドインをインストールすることができます。You can install an Office Add-in for testing without having to first put it in an add-in catalog by using sideloading. サイドロードは、Office 365 または Office on the web で実行できます。Sideloading can be done in either Office 365 or Office Online. 2 つのプラットフォームで手順が少し異なります。The procedure is slightly different for the two platforms.

アドインをサイドロードするとき、アドイン マニフェストはブラウザーのローカル ストレージに格納されます。そのため、ブラウザーのキャッシュを消去したり、別のブラウザーに切り替えたりする場合、アドインを再びサイドロードする必要があります。When you sideload an add-in, the add-in manifest is stored in the browser's local storage, so if you clear the browser's cache, or switch to a different browser, you have to sideload the add-in again.

注意

この記事で説明したようにサイドロードは、Word、Excel、および PowerPoint でサポートされています。Outlook アドインをサイドロードするには、「テストのために Outlook アドインをサイドロードする」をご参照ください。Sideloading as described in this article is supported on Word, Excel, and PowerPoint. To sideload an Outlook add-in, see Sideload Outlook add-ins for testing.

次のビデオでは、Office on the web またはデスクトップでアドインをサイドロードする手順について説明しています。The following video walks you through the process of sideloading your add-in in Office desktop or Office Online.

Office on the web で Office アドインをサイドロードするSideload an Office Add-in in Office on the web

  1. Microsoft Office on the web を開きます。Open Microsoft Office on the web.

  2. [オンライン アプリを今すぐ開始する] で、 ExcelWord、または PowerPoint を選択して、新しいドキュメントを開きます。In Get started with the online apps now, choose Excel, Word, or PowerPoint; and then open a new document.

  3. リボンの [挿入] タブを開き、 [アドイン] セクションで、 Office [アドイン] を選択します。Open the Insert tab on the ribbon and, in the Add-ins section, choose Office Add-ins.

  4. [Office アドイン] ダイアログ ボックスで、[個人用アドイン] タブ、[個人用アドインの管理][個人用アドインのアップロード] の順に選択します。On the Office Add-ins dialog, select the MY ADD-INS tab, choose Manage My Add-ins, and then Upload My Add-in.

    右上に [個人用アドインの管理] というドロップダウンがあり、その下に [マイ アドインのアップロード] オプションのドロップダウンがある [Office アドイン] ダイアログ

  5. アドイン マニフェスト ファイルを参照して、[アップロード] を選択します。Browse to the add-in manifest file, and then select Upload.

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

  6. アドインがインストールされていることを確認します。たとえば、アドイン コマンドである場合は、リボンまたはコンテキスト メニューのいずれかに表示されます。作業ウィンドウ アドインである場合は、ウィンドウが表示されます。Verify that your add-in is installed. For example, if it is an add-in command, it should appear on either the ribbon or the context menu. If it is a task pane add-in, the pane should appear.

注意

Microsoft Edge で Office アドインをテストするには、次の 2 つの構成手順が必要です。To test your Office Add-in with Edge, two configuration steps are required:

  • Windows コマンド プロンプトで、次のコマンドを実行します: CheckNetIsolation LoopbackExempt -a -n="Microsoft.MicrosoftEdge_8wekyb3d8bbwe"In a Windows Command Prompt, run the following line: CheckNetIsolation LoopbackExempt -a -n="Microsoft.MicrosoftEdge_8wekyb3d8bbwe"

  • Microsoft Edge の検索バーに "about:flags" と入力して開発者向け設定のオプションを表示します。Enter “about:flags” in the Edge search bar to bring up the Developer Settings options. [ローカルホスト ループバックを許可する] オプションをオンにして、Microsoft Edge を再起動します。Check the “Allow localhost loopback” option and restart Edge.

[ローカルホスト ループバックを許可する] オプションがオンになった Microsoft Edge。

Office 365 で Office アドインをサイドロードするSideload an Office Add-in in Office 365

  1. Office 365 アカウントにサインインします。Sign in to your Office 365 account.

  2. ツールバーの左端にあるアプリ起動ツールを開き、ExcelWord、または PowerPoint を選択して、新しいドキュメントを作成します。Open the App Launcher on the left end of the toolbar and select Excel, Word, or PowerPoint, and then create a new document.

  3. 手順 3 から 6 は、前のセクション「Office on the web で Office アドインをサイドロードする」のものと同じです。Steps 3 - 6 are the same as in the preceding section Sideload an Office Add-in in Office Online.

Visual Studio の使用時にアドインをサイドロードするSideload an add-in when using Visual Studio

アドインの開発に Visual Studio を使用している場合、サイドロードするプロセスは似ています。If you're using Visual Studio to develop your add-in, the process to sideload is similar. アドインの開発に Visual Studio を使用している場合、サイドロードするプロセスは似ています。唯一の違いは、マニフェストの SourceURL 要素の値を更新して、アドインが展開されている完全な URL を含める必要がある点です。The only difference is that you must update the value of the SourceURL element in your manifest to include the full URL where the add-in is deployed.

注意

アドインは Visual Studio から Office on the web にサイドロードできますが、Visual Studio からはデバッグできません。Although you can sideload add-ins from Visual Studio to Office Online, you cannot debug them from Visual Studio. デバッグするには、ブラウザー デバッグ ツールを使用する必要があります。To debug you will need to use the browser debugging tools. 詳細については、「Office on the web でアドインをデバッグする」を参照してください。For more information, see Debug add-ins in Office Online.

  1. Visual Studio で、[表示] -> [プロパティ ウィンドウ] の順に選択して [プロパティ] ウィンドウを表示させます。In Visual Studio, show the Properties window by choosing View -> Properties Window.
  2. [ソリューション エクスプローラー] で Web プロジェクトを選択します。In the Solution Explorer, select the web project. プロジェクトのプロパティが [プロパティ] ウィンドウに表示されます。This will display properties for the project in the Properties window.
  3. [プロパティ] ウィンドウで、[SSL URL] をコピーします。In the Properties window, copy the SSL URL.
  4. アドイン プロジェクトで、マニフェスト XML ファイルを開きます。In the add-in project, open the manifest XML file. 編集しているのがソース XML であることを確認します。Be sure you are editing the source XML. 一部の種類のプロジェクトでは、Visual Studio は XML のビジュアル ビューを開きますが、これは次の手順で使用できません。For some project types Visual Studio will open a visual view of the XML which will not work for the next step.
  5. ~remoteAppUrl/ のすべてのインスタンスを検索し、先ほどコピーした SSL URL と置き換えます。Search and replace all instances of ~remoteAppUrl/ with the SSL URL you just copied. プロジェクトの種類に応じていくつかの置換が表示され、新しい URL の表示は https://localhost:44300/Home.html に似たものになりま。You will see several replacements depending on the project type, and the new URLs will appear similar to https://localhost:44300/Home.html.
  6. XML ファイルを保存します。Save the XML file.
  7. Web プロジェクトを右クリックして、[デバッグ] -> [新しいインスタンスを開始] の順に選択します。Right click the web project and choose Debug -> Start new instance. これにより、Office を起動することなく Web プロジェクトが実行されます。This will run the web project without launching Office.
  8. 前述の「Office on the web で Office アドインをサイドロードする」で説明した手順を使用して、Office on the web からアドインをサイドロードします。From Office Online, sideload the add-in using steps previously described in Sideload an Office Add-in in Office Online.