テスト用に Outlook アドインを展開してインストールする

  • [アーティクル]

Outlook アドインを開発するプロセスの一環として、テスト用にアドインの展開およびインストールを繰り返し行うことが多くあります。その場合は、以下の手順が必要です。

  1. アドインを記述したマニフェスト ファイルを作成します。
  2. アドインの UI ファイルを Web サーバーに展開します。
  3. アドインをメールボックスにインストールします。
  4. アドインをテストし、UI ファイルまたはマニフェスト ファイルを適切に変更します。さらに、手順 2 および 3 を繰り返して、変更箇所をテストします。

注:

カスタム ウィンドウは廃止されたため、サポートされているアドイン拡張点を使用していることを確認してください。

アドイン用のマニフェスト ファイルを作成する

各アドインはマニフェストによって記述されます。これは、アドインに関するサーバー情報を提供し、ユーザーのアドインに関する説明情報を提供し、アドイン UI HTML ファイルの場所を識別するドキュメントです。 テストで使用するメールボックスの Exchange サーバーがアクセスできるローカル フォルダーまたはサーバーである限り、マニフェストはどの場所にでも格納できます。 ここでは、マニフェストをローカル フォルダーに格納することを前提とします。 マニフェスト ファイルを作成する方法については、「 Office アドイン マニフェスト」を参照してください。

Web サーバーへのアドインを展開する

HTML と JavaScript を使用してアドインを作成できます。 結果のソース ファイルは、アドインをホストする Exchange サーバーからアクセスできる Web サーバーに格納されます。 アドインのソース ファイルを最初にデプロイした後、Web サーバーに格納されている HTML ファイルまたは JavaScript ファイルを新しいバージョンの HTML ファイルに置き換えることで、アドインの UI と動作を更新できます。

アドインをインストールする

アドイン マニフェスト ファイルを準備して、アクセス可能な Web サーバーにアドイン UI を展開した後は、Outlook クライアントを使用するか、または Windows PowerShell コマンドレットをリモートで実行しアドインをインストールすることで、アドインを Exchange サーバーのメールボックスにサイドロードできます。

アドインをサイドロードする

メールボックスが Exchange 上にある場合は、アドインをインストールできます。 サイドローディング アドインには、少なくとも、Exchange Serverの [マイ カスタム アプリ] ロールが必要です。 アドイン マニフェストの URL またはファイル名を指定してアドインをテストしたり、一般のアドインをインストールしたりする場合は、Exchange 管理者に連絡して、必要なアクセス許可を得る必要があります。

Exchange 管理者は、次のような PowerShell コマンドレットを実行して、必要なアクセス許可を単一ユーザーに割り当てることができます。 この例では、 wendyri はユーザーのメール エイリアスです。

New-ManagementRoleAssignment -Role "My Custom Apps" -User "wendyri"

必要な場合、管理者は次のようなコマンドレットを実行して、必要となる同様のアクセス許可を複数のユーザーに割り当てることができます。

$users = Get-Mailbox *$users | ForEach-Object { New-ManagementRoleAssignment -Role "My Custom Apps" -User $_.Alias}

自分のカスタム アドインの役割の詳細については、「"My Custom Apps/自分のカスタム アプリ" 役割」をご覧ください。

Microsoft 365 や Visual Studio を使用してアドインを開発すると、組織の管理者の役割が割り当てられ、EAC のファイルや URL を使用するか、Powershell コマンドレットを使用してアドインをインストールできるようになります。

リモート PowerShell を使用してアドインをインストールする

Exchange サーバー上に Windows PowerShell のリモート セッションを作成した後、次の PowerShell コマンドによって New-App コマンドレットを使用して Outlook アドインをインストールできます。

New-App -URL:"http://<fully-qualified URL">

完全修飾 URL は、アドイン用に準備したアドイン マニフェスト ファイルの場所です。

さらに、次の PowerShell コマンドレットを使用して、メールボックス用のアドインを管理します。

  • Get-App - メールボックスに対して有効になっているアドインを一覧表示します。
  • Set-App - メールボックスに対してアドインを有効または無効にします。
  • Remove-App - 現在インストールされているアドインを Exchange サーバーから削除します。

クライアント バージョン

どのバージョンの Outlook クライアントをテストするかは、開発要件によって決まります。

  • プライベート向けのアドインを開発する場合、またはorganizationのメンバー専用に開発する場合は、会社が使用する Outlook のバージョンをテストすることが重要です。 一部のユーザーはOutlook on the webを使用する可能性があるため、会社の標準ブラウザー バージョンのテストも重要であることに注意してください。

  • AppSource に一覧表示するアドインを開発する場合は、Commercial marketplace の認定ポリシー 1120.3 で指定されている必要なバージョンをテストする必要があります。 これには、次のものが含まれます。

    • Windows 用 Outlook の最新バージョンと最新の直前のバージョン。
    • Mac 用 Outlook の最新バージョン。
    • iOS および Android 用の Outlook の最新バージョン (アドインがモバイル フォーム ファクターをサポートしている場合)。
    • Commercial marketplace の検証ポリシー 1120.3 で指定されたブラウザーのバージョン。

注:

クライアントがサポートしていない API 要件セットを要求しているために、アドインが上記のクライアントのいずれかをサポートしない場合は、そのクライアントが必要なクライアントのリストから削除されます。

Outlook on the web および Exchange サーバーのバージョン

顧客および Microsoft 365 アカウントのユーザーは、Outlook on the web にアクセスすると最新の UI バージョンを表示し、廃止されたクラシック バージョンを表示しなくなります。 ただし、オンプレミスの Exchange サーバーは、従来の Outlook on the web を引き続きサポートします。 したがって、検証プロセス中に、提出物はアドインが従来の Outlook on the web と互換性がないという警告を受け取る場合があります。 その場合は、オンプレミスの Exchange 環境でアドインをテストすることを検討する必要があります。 この警告によって AppSource への送信がブロックされることはありませんが、顧客がオンプレミスの Exchange 環境で Outlook on the web を使用すると、次善のエクスペリエンスが発生する可能性があります。

これを軽減するために、独自のプライベート オンプレミス Exchange 環境に接続された Outlook on the web でアドインをテストすることをお勧めします。 詳細については、Exchange 2016 または Exchange 2019 テスト環境を確立する方法と、Exchange Server で Outlook on the web を管理する方法に関するガイダンスを参照してください。

または、オンプレミスの Exchange サーバーをホストおよび管理するサービスの料金を支払い、使用することもできます。 いくつかのオプションがあります:

さらに、オンプレミスの Exchange に接続しているユーザーがアドインを使用できないようにする場合は、アドイン マニフェストの要件セットを 1.6 以上に設定できます。 このようなアドインは、従来の Outlook on the Web UI ではテストまたは検証されません。

関連項目