ネットワーク共有からテストするための Office アドインをサイドロードする
ネットワーク ファイル共有にマニフェストを発行することで、Windows 上にある Office クライアントで Office アドインをテストできます (手順に従います)。 このデプロイ オプションは、localhost での開発とテストを完了し、ローカル以外のサーバーまたはクラウド アカウントからアドインをテストする場合に使用することを目的としています。
重要
ネットワーク共有によるデプロイは、運用アドインではサポートされていません。このメソッドには、次の制限があります。
- アドインは Windows コンピューターにのみインストールできます。
- Microsoft 365 の統合マニフェストを使用するアドインは、ネットワーク共有に発行される場合はサポートされません。
- カスタム タブやカスタム ボタンを追加するなどして、新しいバージョンのアドインがリボンを変更した場合、各ユーザーはアドインを再インストールする必要があります。
注:
アドイン プロジェクトが十分に新しい Office 用の Yeoman ジェネレーター バージョンで作成されている場合、アドインは npm start
を実行すると自動的に Office デスクトップ クライアントにサイドロードします。
この記事は、Word、Excel、PowerPoint、および Project アドインのテストにのみ適用され、Windows でのみ適用されます。 別のプラットフォームでテストする場合、または Outlook アドインをテストする場合は、次のいずれかのトピックを参照してアドインをサイドロードします。
- テスト用に Office on the web で Office アドインをサイドロードする
- テスト用に Mac で Office アドインをサイドロードする
- テスト用に iPad に Office アドインをサイドロードする
- テスト用に Outlook アドインをサイドロードする
次のビデオでは、共有フォルダー カタログを使用して Office on the web またはデスクトップでアドインをサイドロードする手順について説明します。
フォルダーの共有
アドインをホストさせようとしている Windows コンピューターで、共有フォルダー カタログとして使用するつもりのフォルダーの親フォルダーまたはドライブ文字に移動します。
共有フォルダー カタログとして使用するフォルダーのコンテキスト メニューを開き (フォルダーを右クリックするなど)、[プロパティ] を選択 します。
[プロパティ] ダイアログ ボックス内で [共有] タブを選択し、[共有] ボタンを選択します。
[ネットワーク アクセス] ダイアログ ウィンドウで自分自身とアドインを共有する相手のユーザーまたはグループを追加します。 フォルダーに対する 読み取り/書き込み アクセス許可が少なくとも必要です。 共有するユーザーの選択が完了したら、[ 共有 ] ボタンを選択します。
[フォルダーが共有されている] 確認が表示されたら、フォルダー名の直後に表示される完全なネットワーク パスを書き留めます。 (この記事の次のセクションで説明するように、共有フォルダーを信頼されたカタログとして指定する場合は、この値をカタログ URL として入力する必要があります)。[完了] ボタンを選択して、[ネットワーク アクセス] ダイアログ ウィンドウを閉じます。
[閉じる] を選択して、[プロパティ] ダイアログ ウィンドウを閉じます。
共有フォルダーを信頼できるカタログとして指定する
この信頼を指定する方法には、2 つのオプションがあります。 セットアップに適したオプションの手順に従います。
信頼を手動で構成する
Excel、Word、PowerPoint、または Project で新しいドキュメントを開きます。
[ファイル] タブを選択し、[オプション] を選択します。
[セキュリティ センター] を選択し、[セキュリティ センターの設定] ボタンを選択します。
[信頼されているアドイン カタログ] を選びます。
[カタログの URL] ボックスで、先ほど共有したフォルダーの完全なネットワーク パスを入力します。 フォルダーを共有した際に完全なネットワーク パスを書き留めておかなかった場合は、次のスクリーン ショットに示されるように、フォルダーの [プロパティ] ダイアログ ウィンドウから取得できます。
[カタロ URL] ボックスにフォルダーの完全なネットワーク パスを入力したら、[カタログの追加] を選択します。
新しく追加されたアイテムの [メニューに表示する] チェック ボックスをオンにし、[OK] を選択して [セキュリティ センター ] ダイアログ ウィンドウを閉じます。
[ OK ] ボタンを選択して 、[オプション] ダイアログ ウィンドウを閉じます。
Office アプリケーションを閉じてからもう一度開くと変更内容が有効になります。
レジストリ スクリプトを使用して信頼を構成する
テキスト エディターで、 TrustNetworkShareCatalog.reg という名前のファイルを作成します。
ファイルに次の内容を追加します。
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{-random-GUID-here-}] "Id"="{-random-GUID-here-}" "Url"="\\\\-share-\\-folder-" "Flags"=dword:00000001
GUID ジェネレーターなど、多数のオンライン GUID 生成ツールのいずれかを使用してランダムな GUID を生成し、TrustNetworkShareCatalog.reg ファイル内で両方の場所の文字列「-random-GUID-here-」を GUID に置き換えます。 (引用符
{}
記号は残しておく必要があります)。Url
値を、以前共有したフォルダーへの完全なネットワーク パスに置き換えます。 (URL の\
文字は 2 倍にする必要があります。) フォルダーを共有した際に完全なネットワーク パスを書き留めておかなかった場合は、次のスクリーン ショットに示されるように、フォルダーの [プロパティ] ダイアログ ウィンドウから取得できます。ファイルは、次のようになります。 ファイルを保存します。
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{01234567-89ab-cedf-0123-456789abcedf}] "Id"="{01234567-89ab-cedf-0123-456789abcedf}" "Url"="\\\\TestServer\\OfficeAddinManifests" "Flags"=dword:00000001
すべての Office アプリケーションを閉じます。
ダブルクリックするなど、実行可能ファイルと同様に TrustNetworkShareCatalog.reg 実行します。
アドインのサイドロード
テストするアドインのマニフェスト XML ファイルを共有フォルダー カタログに配置します。 なお、Web アプリケーション自体を Web サーバーに展開します。 マニフェスト ファイルの <SourceLocation> 要素に URL を指定してください。
重要
すべてのアドインのシナリオで厳密に求められるわけではないものの、アドインに対して HTTPS エンドポイントを使用することを強くお勧めします。 SSL で保護されている (HTTPS) のではないアドインは、使用中に、保護されていないコンテンツの警告やエラーを生成します。 Office on the web でアドインを実行する場合、またはアドインを AppSource に発行する場合は、SSL で保護されている必要があります。 アドインが外部データやサービスにアクセスする場合、アドインを SSL で保護して送信中のデータを保護する必要があります。 自己署名証明書がローカル マシンで信頼されている限り、この証明書は開発とテストに使用できます。
注:
Visual Studio プロジェクトの場合は、
{projectfolder}\bin\Debug\OfficeAppManifests
フォルダー内のプロジェクトによってビルドされたマニフェストを使用します。Excel、Word、またはPowerPointで、リボンから [ホーム>アドイン] を選択し、[その他のアドイン] を選択します。[プロジェクト] で、リボンの [プロジェクト] タブで [マイ アドイン] を選択します。
[Office アドイン] ダイアログ ボックスの上部にある [共有フォルダー] を選びます。
アドインの名前を選び、[追加] を選択して、アドインを挿入します。
サイドロードされたアドインを削除する
以前にサイドロードされたアドインを削除するには、コンピューター上の Office キャッシュをクリアします。 Windows でキャッシュをクリアする方法の詳細については、 Office キャッシュのクリアに関する記事を参照してください。
関連項目
Office Add-ins