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

マニフェストをネットワーク ファイル共有に公開することで、Windows 上で実行されている Office クライアントにテスト用の Office アドインをインストールできます (以下の手順)。You can install an Office Add-in for testing in an Office client running on Windows by using a shared folder catalog to publish the manifest to a network file share.


アドイン プロジェクトを yo office ツールとともにを作成した場合、動作するようにサイドロードする別の方法があります。詳細については、 sideload コマンドを使用するSideload Office アドイン 参照してください。If your add-in project was created with the yo office tool, there is an alternative way of sideloading it that might work for you. For details, see Sideload Office Add-ins using the sideload command.

この資料は、Word、Excel、または PowerPoint のアドインの Windows のテストにのみ適用されます。Outlook のアドインをテストするのには別のプラットフォーム上でテストする場合は、アドインをサイドロードするの 次のトピックのいずれかを参照してください。This article applies only to testing a Word, Excel, or PowerPoint add-ins on Windows. If you want to test on another platform or want to test an Outlook add-in, see one of the following topics to sideload your add-in:

次のビデオでは、共有フォルダ カタログを使用して Office デスクトップまたは Office Online のアドインをサイドロードする手順を説明します。The following video walks you through the process of sideloading your add-in on Office desktop or Office Online.

フォルダーの共有Share a folder

  1. アドインをホストさせようとしている Windows コンピューターで、共有フォルダー カタログとして使用するつもりのフォルダーの親フォルダーまたはドライブ文字に移動します。On the Windows computer where you want to host your add-in, go to the parent folder, or drive letter, of the folder you want to use as your shared folder catalog.

  2. 共有フォルダー (フォルダーを右クリック) カタログとして使用したいフォルダをコンテキスト メニューから開き、 プロパティを選択します。Open the context menu for the folder you want to use as your shared folder catalog (right-click the folder) and choose Properties.

  3. *[プロパティ]* ダイアログ ウィンドウ内で *[共有]* タブを開き、 *[共有]* ボタンを選択します。Within the Properties dialog window, open the Sharing tab and then choose the Share button.

    [フォルダー プロパティ] ダイアログ ボックス、[共有] タブと[共有] ボタンが強調表示されます。

  4. *ネットワーク アクセス* のダイアログ ウィンドウ内で、アドインを共有したい、他のユーザーおよび/またはグループと自分を追加します。Within the Network access dialog window, add yourself and any other users and/or groups with whom you want to share your add-in. 少なくとも、フォルダーへの読み取り/書き込みアクセス許可が必要です。You will need at least Read/Write permission to the folder. 共有するユーザーを選択したら、 [共有] ボタンを選択します。After you have finished choosing people to share with, choose the Share button.

  5. *フォルダーが共有されました*の確認が表示されたら、フォルダー名の直後に表示される完全なネットワーク パスのメモを作成します。When you see confirmation that Your folder is shared, make note of the full network path that's displayed immediately following the folder name. (この資料の次のセクションで説明されているように 、この値を入力する必要とする 信頼できるカタログとして共有フォルダーを指定する場合、カタログの Url としてこの値を入力する必要があります。) ネットワーク アクセス のダイアログ ウィンドウを閉じるには、[ 完了 ] を選択します。(You will need to enter this value as the Catalog Url when you specify the shared folder as a trusted catalog, as described in the next section of this article.) Choose the Done button to close the Network access dialog window.

    強調表示されている共有パスを使用するネットワーク アクセスのダイアログ

  6. *[プロパティ* ] ダイアログ ウィンドウを閉じるには、 [ *閉じる* ] ボタンを選択します。Choose the Close button to close the Workbook Connections dialog box.

信頼できるカタログとしてその共有フォルダーを指定します。Specify the shared folder as a trusted catalog

  1. Excel、Word、または PowerPoint で新しいドキュメントを開きます。Open a new document in Excel, Word, or PowerPoint.

  2. [ファイル] タブを選択して、[オプション] を選択します。Choose the File tab, and then choose Options.

  3. [セキュリティ センター] を選択し、[セキュリティ センターの設定] ボタンを選択します。Choose Trust Center, and then choose the Trust Center Settings button.

  4. [信頼されているアドイン カタログ] を選びます。Choose Trusted Add-in Catalogs.

  5. *[カタログの Url]* ボックスで、以前に共有 したフォルダーの完全なネットワーク パスを入力します。In the Catalog Url box, enter the full network path to the folder that you shared previously. フォルダーを共有するときにフォルダーの完全なネットワーク パスをメモしていなかった場合に、フォルダーの [プロパティ] ダイアログ ウィンドウで、次のスクリーン ショットが示すように操作して得ることができます。If you failed to note the folder's full network path when you shared the folder, you can get it from the folder's Properties dialog window, as shown in the following screenshot.

    強調表示されている共有 タブと ネットワーク パスを持つフォルダーのプロパティ ダイアログ ボックス

  6. *カタログの Url* ] ボックスに、フォルダーの完全なネットワーク パスを入力した後に、 *[カタログの追加]* ボタンを選択します。After you've entered the full network path of the folder into the Catalog Url box, choose the Add catalog button.

  7. 新しく追加した項目の [メニューに表示する] ]チェック ボックスを選択し、 [ OK ] ボタンを選択して、[ セキュリティ センター ] ダイアログ ウィンドウを閉じます。Select the Show in Menu check box for the newly-added item, and then choose the OK button to close the Trust Center dialog window.

    カタログが選択されている[トラスト センター] ダイアログ ボックス

  8. [ OK ] ボタンを選択して、[ Word のオプション ] ダイアログ ウィンドウを閉じますChoose the OK button to close the Internet Options dialog box.

  9. Office アプリケーションを閉じるて再度開くと、変更内容が有効になります。Close the Office application so your changes will take effect.

アドインのサイドロードSideload your add-in

  1. テストするアドインのマニフェスト XMLファイルを共有フォルダー カタログに置きます。Put the manifest file of any add-in that you are testing in the shared folder catalog. Web サーバーに web application自体を展開することに注意してください。Note that you deploy the web application itself to a web server. *SourceLocation* 要素マニフェスト ファイルの URL を指定することを確認します。Deploy the web application itself to a web server and specify the URL in the SourceLocation element of the manifest file.


    すべてのアドインのシナリオで厳密に求められるわけではないものの、アドインに対して HTTPS エンドポイントを使用することを強くお勧めします。While not strictly required in all add-in scenarios, using an HTTPS endpoint for your add-in is strongly recommended. SSL で保護されている (HTTPS) のではないアドインは、使用中に、保護されていないコンテンツの警告やエラーを生成します。Add-ins that are not SSL-secured (HTTPS) generate unsecure content warnings and errors during use. Office Online でアドインを実行するか、AppSource にアドインを発行する場合は、アドインを SSL でセキュリティ保護する必要があります。If you plan to run your add-in in Office Online or publish your add-in to AppSource, it must be SSL-secured. アドインが外部データやサービスにアクセスする場合、アドインを SSL で保護して送信中のデータを保護する必要があります。If your add-in accesses external data and services, it should be SSL-secured to protect data in transit. 自己署名証明書がローカル マシンで信頼されている限り、この証明書は開発とテストに使用できます。Self-signed certificates can be used for development and testing, so long as the certificate is trusted on the local machine.

  2. Excel、Word、または PowerPoint で、リボンの [挿入] タブにある [個人用アドイン] を選びます。In Excel, Word, or PowerPoint, select My Add-ins on the Insert tab of the ribbon.

  3. [Office アドイン] ダイアログ ボックスの上部にある [共有フォルダー] を選びます。Choose SHARED FOLDER at the top of the Office Add-ins dialog box.

  4. アドインの名前を選び、[OK] を選択して、アドインを挿入します。Select the name of the add-in and choose OK to insert the add-in.

関連項目See also