Visual Studio を使用して Microsoft Azure で Office アドインをステージングする
最も簡単な Office アドインは、マニフェスト ファイルと HTML ページで構成されています。 マニフェスト ファイルには、アドインの名前、実行できる Office デスクトップ クライアント、アドインの HTML ページの URL など、アドインの特性が記述されています。 HTML ページには、ユーザーが Office クライアント アプリケーションにアドインをインストールして実行したときに操作する、Web アプリが含まれています。 Office アドインの Web アプリは、Azure を含む、あらゆる Web ホスティング プラットフォームでホストできます。
この記事では、アドイン Web アプリを Azure に展開して、Office クライアント アプリケーションでテストのためにアドインをサイドロードする方法について説明します。
重要
この記事で説明するプロセスは、Outlook アドインには適用されません。Azure 上の Outlook 用のアドインのステージング手順については、「 Visual Studio を使用して Microsoft Azure で Outlook アドインをステージングする」を参照してください。
前提条件
Visual Studio 2022 をインストールし、Azure 開発ワークロードを含めるかどうかを選択します。
注:
以前に Visual Studio 2022 をインストールしたことがある場合は、Visual Studio インストーラーを使用して、Azure 開発ワークロードがインストールされていることを確認します。
Office をインストールする。
注:
まだ Office を所持していない場合は、1 か月間無料試用版の登録が可能です。
Azure サブスクリプションを取得します。
注:
まだ Azure サブスクリプションを所持していない場合、このサブスクリプションは Visual Studio サブスクリプションの一部として取得できます。また、無料試用版の登録も可能です。
手順 1: アドイン マニフェスト ファイルをホストする共有フォルダーを作成する
開発用のコンピューターでエクスプローラーを開きます。
C:\ ドライブを右クリック (または長押し) し、[ 新規>Folder] を選択します。
新規フォルダーに「AddinManifests」という名前を付けます。
AddinManifests フォルダーを右クリック (または長押し) し、[共有相手>特定のユーザー] を選択します。
[ファイル共有] で、ドロップダウンの矢印をクリックして、[すべてのユーザー]>[追加]>[共有] をクリックします。
注:
このチュートリアルでは、アドイン マニフェスト ファイルを格納する信頼できるカタログとしてローカル ファイル共有を使用します。 実際のシナリオでは、代わりにマニフェスト ファイルを SharePoint カタログに展開するか、アドインを AppSource に発行するかを選択できます。
手順 2: 信頼できるアドイン カタログにファイル共有を追加する
Word を起動してドキュメントを作成します。
注:
この例ではWordを使用していますが、Excel、PowerPoint、Project などの Office アドインをサポートする任意の Office アプリケーションを使用できます。
[ファイル]>[オプション] を選択します。
[Word オプション] ダイアログ ボックスで、[セキュリティ センター] をクリックして、[セキュリティ センターの設定] をクリックします。
[ セキュリティ センター ] ダイアログ ボックスで、[ 信頼されたアドイン カタログ] を選択します。 前に作成したファイル共有の汎用名前付け規則 (UNC) パスを カタログ URL (たとえば、\YourMachineName\AddinManifests) として入力し、[ カタログの追加] を選択します。
[メニューに表示する] チェック ボックスをオンにします。
注:
信頼できる Web アドイン カタログとして指定された共有にアドイン マニフェスト ファイルを格納すると、アドインは、[ホーム]、[アドイン]、[アドインの取得] から起動する [Office アドイン] ダイアログ ボックスの [共有フォルダー] の下に表示されます>>アドインを取得します。
Word を終了します。
手順 3: Visual Studio で Office アドインを作成する
管理者として Visual Studio を起動します。
[新規プロジェクトの作成] を選択します。
検索ボックスを使用して、アドインと入力します。
プロジェクト タイプとして Word Web アドインを選択し、[次へ] を選択して規定の設定を使用します。
Visual Studio は、Web プロジェクトに変更を加えることなくそのまま発行できる、基本的な Word アドインを作成します。 Excel などの別の Office アプリケーションのアドインを作成するには、手順を繰り返し、目的の Office アプリケーションでプロジェクトの種類を選択します。
手順 4: Office アドイン Web アプリを Azure に発行する
Visual Studio でアドイン プロジェクトを開いた状態で、Web プロジェクトを右クリック (または長押し) し、[発行] を選択 します。
「 Web アプリを発行する」の手順に従います。 「 Web アプリを発行する」の前の記事セクションをスキップしますが、ページの上部にある [Visual Studio ] ボタンが選択されていることを確認してください。
Visual Studio により、Office アドインの Web プロジェクトが Azure Web アプリに発行されます。 Visual Studio で Web プロジェクトの発行が完了すると、ブラウザーが開き、"Web アプリが実行され、コンテンツを待機しています" というテキストが表示された Web ページが表示されます。これは、Web アプリの現在の既定のページです。
ルート URL (例:
https://YourDomain.azurewebsites.net) をコピーします。この記事の後半でアドイン マニフェスト ファイルを編集するときに必要になります。
手順 5: アドイン マニフェスト ファイルを編集してデプロイする
Visual Studio の [ソリューション エクスプローラー] でサンプルの Office アドインを開いて、ソリューションを展開し、両方のプロジェクトが表示されるようにします。
Office アドイン プロジェクト (WordWebAddIn など) を展開し、マニフェスト フォルダーを右クリック (または選択して長押し) し、[ 開く] を選択します。 アドイン マニフェスト ファイルが開きます。
マニフェスト ファイルで、"~remoteAppUrl" のすべてのインスタンスを Azure 上のアドイン Web アプリのルート URL に見つけて置き換えます。 これは、アドイン Web アプリを Azure に発行した後にコピーした URL です (例:
https://YourDomain.azurewebsites.net)。[ファイル] をクリックして、[すべてを保存] をクリックします。 次に、アドイン マニフェスト ファイル (たとえば、WordWebAddIn.xml) をコピーします。
ファイル エクスプローラー プログラムを使用して、「手順 1: 共有フォルダーを作成する」で作成したネットワーク ファイル共有を参照し、マニフェスト ファイルをそのフォルダー内に貼り付けます。
手順 6: Office クライアント アプリケーションでアドインを挿入して実行する
Word を起動してドキュメントを作成します。
[ ホーム>アドイン] を選択し、[ アドインの取得] を選択します。
[Office アドイン] ダイアログ ボックスで、[共有フォルダー] をクリックします。 Word により、信頼できるアドイン カタログとしてリストしたフォルダー (「手順 2: 信頼できるアドイン カタログにファイル共有を追加する」で指定したもの) がスキャンされ、アドインがダイアログ ボックスに表示されます。 サンプル アドインのアイコンが表示されます。
アドインを選択して、[追加] をクリックします。 リボンに、そのアドインの [作業ウィンドウの表示] ボタンが追加されます。
[ホーム] タブのリボンで、[作業ウィンドウの表示] ボタンをクリックします。 現在のドキュメントの右側の作業ウィンドウ内でアドインが開きます。
アドインが動作していることを確認するために、ドキュメント内のテキストを選択して、作業ウィンド内の [Highlight!] ボタンをクリックします。
更新プログラムの展開
前に説明したのと同じ方法で、Web アプリケーションに更新プログラムをデプロイします。 マニフェストを変更するには、マニフェストをユーザーに再配布する必要があります。 これを行うプロセスは、 発行方法によって異なります。 アドインの更新の詳細については、「 Office アドインを管理する」を参照してください。
関連項目
Office Add-ins