Office アドインに既存の COM アドインとの互換性をもたせる
既存の COM アドインがある場合は、Office アドインで同等の機能を構築できるため、ソリューションを Office on the web や Mac などの他のプラットフォームで実行できます。 場合によっては、Office アドインが対応する COM アドインで使用できる機能をすべて提供できない場合があります。 このような状況では、COM アドインは、対応する Office アドインよりも Windows でのユーザー エクスペリエンスが向上する可能性があります。
重要
COM アドインと VSTO アドインは、現在プレビュー段階の 新しい Outlook on Windows ではサポートされていません。 これらのアドインは、従来の Outlook on Windows デスクトップ クライアントで引き続きサポートされています。 詳細については、「 Windows 上の新しい Outlook 用 Outlook アドインを開発する」を参照してください。
Office アドインを構成して、同等の COM アドインが既にユーザーのコンピューターにインストールされている場合、Office on Windows では Office アドインではなく COM アドインを実行できます。 COM アドインは、ユーザーのコンピューターにインストールされているアドインに従って、COM アドインと Office アドインの間でシームレスに切り替わるため、"同等" と呼ばれます。
重要
同等のアドイン機能は、次のプラットフォームとアプリケーションでサポートされています。 COM アドインは他のどのプラットフォームにもインストールできないため、これらのプラットフォームでは、この記事の後半で説明するマニフェスト要素 EquivalentAddins
は無視されます。
同等の COM アドインを指定する
COM アドインの ProgId を取得する
同等の COM アドインを指定する前に、まずその ProgId
を特定する必要があります。 COM アドインの ProgId
を取得するには:
- COM アドインがインストールされているコンピューターで Windows レジストリ エディターを開きます。
- <Office アプリケーション>\Addins またはHKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<Office アプリケーション>\Addins のHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\に移動します。ここで<Office アプリケーション>は Excel、Outlook、PowerPoint、Word です。 たとえば、 をHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addinsします。
- 必要な 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 アドインの互換性を宣言するには、同等の COM アドインまたは VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化グループ ポリシー設定で同等の COM アドイン を特定します。 これはユーザーのマシンで構成する必要があります。 その後、従来の Outlook on Windows では、Web アドインの代わりに COM アドインが使用されます (両方がインストールされている場合)。
ツールのインストール手順に注意して、最新の管理用テンプレート ツールをダウンロードします。
ローカル グループ ポリシー エディター (gpedit.msc) を開きます。
[ユーザーの構成>管理用テンプレート>Microsoft Outlook 2016>Miscellaneous] に移動します。
[同等の COM または VSTO アドインがインストールされている Outlook Web アドインを非アクティブ化する] 設定を選択します。
リンクを開いてポリシー設定を編集します。
Outlook Web アドインを非アクティブ化するダイアログで、次の手順を実行します。
-
[値名] を、Web アドインのマニフェストにある
Id
に設定します。 重要: エントリの周囲に中かっこ{}
を追加しないでください。 -
[値] を同等の COM アドインの
ProgId
に設定します。 - [ OK] を選択 して、更新プログラムを有効にします。
-
[値名] を、Web アドインのマニフェストにある
ユーザーに対する同等の動作
同等の 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 は次の手順を実行します。
- Office アドインをインストールします。
- リボンの Office アドイン UI を非表示にします。
- COM アドイン リボン ボタンをポイントするユーザーのコールアウトを表示します。
Office アドインの一元展開
管理者が一元展開を使用して Office アドインをテナントに展開し、同等の COM アドインが既にインストールされている場合、ユーザーは変更を表示する前に Office を再起動する必要があります。 Office を再起動すると、次のようになります。
- Office アドインをインストールします。
- リボンの Office アドイン UI を非表示にします。
- COM アドイン リボン ボタンをポイントするユーザーのコールアウトを表示します。
埋め込み Office アドインと共有されるドキュメント
ユーザーが COM アドインをインストールした後、埋め込み Office アドインを含む共有ドキュメントを取得した場合、ドキュメントを開くと、Office は次の操作を行います。
- Office アドインを信頼するようにユーザーに求めるメッセージを表示します。
- 信頼されている場合は、Office アドインがインストールされます。
- リボンの Office アドイン UI を非表示にします。
その他の COM アドインの動作
Excel、PowerPoint、Word
ユーザーが同等の COM アドインをアンインストールした場合、Office on Windows は Office アドイン UI を復元します。
Office アドインに同等の COM アドインを指定すると、Office アドインの更新プログラムの処理が停止されます。 Office アドインの最新の更新プログラムを取得するには、まず COM アドインをアンインストールする必要があります。
Outlook
対応する Web アドインを無効にするには、Outlook の起動時に COM アドインを接続する必要があります。
以降の Outlook セッション中に COM アドインが切断された場合、Outlook が再起動されるまで Web アドインは無効のままになる可能性があります。
関連項目
Office Add-ins