Office アドインに既存の COM アドインとの互換性をもたせる

既存の COM アドインがある場合は、Office アドインで同等の機能を構築できるため、ソリューションを Office on the web や Mac などの他のプラットフォームで実行できます。 場合によっては、Office アドインが対応する COM アドインで使用できる機能をすべて提供できない場合があります。 このような状況では、COM アドインは、対応する Office アドインよりも Windows でのユーザー エクスペリエンスが向上する可能性があります。

重要

COM アドインと VSTO アドインは、現在プレビュー段階の 新しい Outlook on Windows ではサポートされていません。 これらのアドインは、従来の Outlook on Windows デスクトップ クライアントで引き続きサポートされています。 詳細については、「 新しい Outlook on Windows 用 Outlook アドインの開発 (プレビュー)」を参照してください。

Office アドインを構成して、同等の COM アドインが既にユーザーのコンピューターにインストールされている場合、Office on Windows では Office アドインではなく COM アドインを実行できます。 COM アドインは、ユーザーのコンピューターにインストールされているアドインに従って、COM アドインと Office アドインの間でシームレスに切り替わるため、"同等" と呼ばれます。

重要

同等のアドイン機能は、次のプラットフォームとアプリケーションでサポートされています。 COM アドインは他のどのプラットフォームにもインストールできないため、これらのプラットフォームでは、 EquivalentAddinsこの記事で後述するマニフェスト要素は無視されます。

• Excel、Word、PowerPoint on Windows (バージョン 1904 以降)
• サポートされている Exchange サーバーのバージョンに対する Outlook on Windows (バージョン 2102 以降)
  • Exchange Online
  • Exchange 2019 累積的な更新プログラム 10 以降 (KB5003612)
  • Exchange 2016 累積的な更新プログラム 21 以降 (KB5003611)

同等の COM アドインを指定する

マニフェスト

重要

Excel、Outlook、PowerPoint、Wordに適用されます。

Office アドインと COM アドインの互換性を有効にするには、Office アドインの マニフェスト で同等の COM アドインを特定します。 次に、Office on Windows では、両方がインストールされている場合、Office アドインの代わりに COM アドインが使用されます。

次の例は、COM アドインを同等のアドインとして指定するマニフェストの部分を示しています。 要素の ProgId 値は COM アドインを識別し、 EquivalentAddins 要素は終了 VersionOverrides タグの直前に配置する必要があります。

<VersionOverrides>
  ...
  <EquivalentAddins>
    <EquivalentAddin>
      <ProgId>ContosoCOMAddin</ProgId>
      <Type>COM</Type>
    </EquivalentAddin>
  </EquivalentAddins>
</VersionOverrides>

ヒント

COM アドインと XLL UDF の互換性については、「 カスタム関数を XLL ユーザー定義関数と互換性のあるものにする」を参照してください。 Outlook には適用されません。

グループ ポリシー

重要

Outlook にのみ適用されます。

Outlook Web アドインと COM/VSTO アドインの間の互換性を宣言するには、グループ ポリシーで同等の COM アドインを特定します。同等の COM アドインまたは VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化 するには、ユーザーのコンピューターで構成します。 次に、Outlook on Windows では、Web アドインの代わりに COM アドインが使用されます (両方がインストールされている場合)。

1. ツールのインストール手順に注意して、最新の管理用テンプレート ツールをダウンロードします。

2. ローカル グループ ポリシー エディター (gpedit.msc) を開きます。

3. [ユーザー構成>管理テンプレート>] [Microsoft Outlook 2016>Miscellaneous] に移動します。

4. [同等の COM または VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化する] 設定を選択します。

5. リンクを開いてポリシー設定を編集します。

6. Outlook Web アドインを非アクティブ化するダイアログで、次の手順を実行します。

   1. [値の名前]Id を Web アドインのマニフェストで見つかった に設定します。 重要: エントリの周囲に中かっこを{}追加しないでください。
   2. [値] をProgId同等の COM/VSTO アドインの に設定します。
   3. [ OK] を選択 して、更新プログラムを有効にします。

   

ユーザーに対する同等の動作

同等の COM アドインが指定されている場合、同等の COM アドインがインストールされている場合、Office on Windows では Office アドインのユーザー インターフェイス (UI) は表示されません。 Office は Office アドインのリボン ボタンのみを非表示にし、インストールを妨げるわけではありません。 そのため、Office アドインは UI 内の次の場所に引き続き表示されます。

• [マイ アドイン] の下。
• リボン マネージャーのエントリとして (Excel、Word、PowerPoint のみ)。

注:

マニフェストで同等の COM アドインを指定しても、Office on the webや Mac などの他のプラットフォームには影響しません。

次のシナリオでは、ユーザーが Office アドインを取得する方法に応じてどうなるかについて説明します。

Office アドインの AppSource の取得

ユーザーが AppSource から Office アドインを取得し、同等の COM アドインが既にインストールされている場合、Office は次の手順を実行します。

1. Office アドインをインストールします。
2. リボンの Office アドイン UI を非表示にします。
3. COM アドイン リボン ボタンをポイントするユーザーのコールアウトを表示します。

Office アドインの一元展開

管理者が一元展開を使用して Office アドインをテナントに展開し、同等の COM アドインが既にインストールされている場合、ユーザーは変更を表示する前に Office を再起動する必要があります。 Office を再起動すると、次のようになります。

1. Office アドインをインストールします。
2. リボンの Office アドイン UI を非表示にします。
3. COM アドイン リボン ボタンをポイントするユーザーのコールアウトを表示します。

埋め込み Office アドインと共有されるドキュメント

ユーザーが COM アドインをインストールした後、埋め込み Office アドインを含む共有ドキュメントを取得した場合、ドキュメントを開くと、Office は次の操作を行います。

1. Office アドインを信頼するようにユーザーに求めるメッセージを表示します。
2. 信頼されている場合は、Office アドインがインストールされます。
3. リボンの Office アドイン UI を非表示にします。

その他の COM アドインの動作

Excel、PowerPoint、Word

ユーザーが同等の COM アドインをアンインストールした場合、Office on Windows は Office アドイン UI を復元します。

Office アドインに同等の COM アドインを指定すると、Office アドインの更新プログラムの処理が停止されます。 Office アドインの最新の更新プログラムを取得するには、まず COM アドインをアンインストールする必要があります。

Outlook

対応する Web アドインを無効にするには、Outlook の起動時に COM/VSTO アドインを接続する必要があります。

以降の Outlook セッション中に COM/VSTO アドインが切断された場合、Outlook が再起動されるまで Web アドインは無効のままになる可能性があります。

関連項目

• カスタム関数を XLL ユーザー定義関数と互換性のあるものにする