Sicherstellen der Kompatibilität Ihres Office-Add-Ins mit einem vorhandenen COM-Add-In

  • Artikel

Wenn Sie über ein vorhandenes COM-Add-In verfügen, können Sie entsprechende Funktionen in Ihrem Office-Add-In erstellen, sodass Ihre Lösung auf anderen Plattformen wie Office im Web oder Mac ausgeführt werden kann. In einigen Fällen kann Ihr Office-Add-In möglicherweise nicht alle Funktionen bereitstellen, die im entsprechenden COM-Add-In verfügbar sind. In diesen Situationen bietet Ihr COM-Add-In möglicherweise eine bessere Benutzererfahrung unter Windows, als das entsprechende Office-Add-In bieten kann.

Wichtig

COM- und VSTO-Add-Ins werden im neuen Outlook unter Windows , das sich derzeit in der Vorschau befindet, nicht unterstützt. Diese Add-Ins werden weiterhin im klassischen Desktopclient von Outlook unter Windows unterstützt. Weitere Informationen finden Sie unter Entwickeln von Outlook-Add-Ins für neues Outlook unter Windows (Vorschauversion).

Sie können Ihr Office-Add-In so konfigurieren, dass Office unter Windows das COM-Add-In anstelle des Office-Add-Ins ausführt, wenn das entsprechende COM-Add-In bereits auf dem Computer eines Benutzers installiert ist. Das COM-Add-In wird als "Äquivalent" bezeichnet, da Office nahtlos zwischen dem COM-Add-In und dem Office-Add-In wechselt, das auf dem Computer eines Benutzers installiert ist.

Wichtig

Das entsprechende Add-In-Feature wird von der folgenden Plattform und den folgenden Anwendungen unterstützt. COM-Add-Ins können nicht auf einer anderen Plattform installiert werden. Daher wird auf diesen Plattformen das Manifestelement ignoriert, EquivalentAddinsdas weiter unten in diesem Artikel erläutert wird.

  • Excel, Word und PowerPoint unter Windows (Version 1904 oder höher)
  • Outlook unter Windows (Version 2102 oder höher) für eine unterstützte Exchange-Serverversion
    • Exchange Online:
    • Exchange 2019 Kumulatives Update 10 oder höher (KB5003612)
    • Exchange 2016 Kumulatives Update 21 oder höher (KB5003611)

Angeben eines entsprechenden COM-Add-Ins

Manifest

Wichtig

Gilt für Excel, Outlook, PowerPoint und Word.

Um die Kompatibilität zwischen Ihrem Office-Add-In und COM-Add-In zu ermöglichen, identifizieren Sie das entsprechende COM-Add-In im Manifest Ihres Office-Add-Ins. Office unter Windows verwendet dann das COM-Add-In anstelle des Office-Add-Ins, wenn beide installiert sind.

Das folgende Beispiel zeigt den Teil des Manifests, der ein COM-Add-In als gleichwertiges Add-In angibt. Der Wert des ProgId Elements identifiziert das COM-Add-In, und das EquivalentAddins-Element muss unmittelbar vor dem schließenden VersionOverrides Tag positioniert werden.

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

Tipp

Informationen zum COM-Add-In und zur XLL-UDF-Kompatibilität finden Sie unter Kompatibilität Ihrer benutzerdefinierten Funktionen mit benutzerdefinierten XLL-Funktionen. Gilt nicht für Outlook.

Gruppenrichtlinie

Wichtig

Gilt nur für Outlook.

Um die Kompatibilität zwischen Ihrem Outlook-Web-Add-In und dem COM/VSTO-Add-In zu deklarieren, identifizieren Sie das entsprechende COM-Add-In in der Gruppenrichtlinie Outlook-Web-Add-Ins deaktivieren, deren entsprechendes COM- oder VSTO-Add-In installiert ist , indem Sie es auf dem Computer des Benutzers konfigurieren. Outlook unter Windows verwendet dann das COM-Add-In anstelle des Web-Add-Ins, wenn beide installiert sind.

  1. Laden Sie das neueste Tool für administrative Vorlagen herunter, und achten Sie dabei auf die Installationsanweisungen des Tools.

  2. Öffnen Sie den Editor für lokale Gruppenrichtlinie (gpedit.msc).

  3. Navigieren Sie zu Benutzerkonfiguration>Administrative Vorlagen>Microsoft Outlook 2016>Miscellaneous.

  4. Wählen Sie die Einstellung Outlook-Web-Add-Ins deaktivieren aus, deren entsprechendes COM- oder VSTO-Add-In installiert ist.

  5. Öffnen Sie den Link, um die Richtlinieneinstellung zu bearbeiten.

  6. Im Dialogfeld Outlook-Web-Add-Ins zum Deaktivieren:

    1. Legen Sie Wertname auf die Id im Manifest des Web-Add-Ins gefundene fest. Wichtig: Fügen Sie dem Eintrag keine geschweiften Klammern {} hinzu.
    2. Legen Sie Value auf die ProgId des entsprechenden COM/VSTO-Add-Ins fest.
    3. Wählen Sie OK aus, um das Update zu aktivieren.

    Das Dialogfeld

Äquivalentes Verhalten für Benutzer

Wenn ein entsprechendes COM-Add-In angegeben ist, zeigt Office unter Windows die Benutzeroberfläche (UI) Ihres Office-Add-Ins nicht an, wenn das entsprechende COM-Add-In installiert ist. Office blendet nur die Menübandschaltflächen des Office-Add-Ins aus und verhindert die Installation nicht. Daher wird Ihr Office-Add-In weiterhin an den folgenden Speicherorten auf der Benutzeroberfläche angezeigt.

  • Klicken Sie unter Meine Add-Ins.
  • Als Eintrag im Menüband-Manager (nur Excel, Word und PowerPoint).

Hinweis

Die Angabe eines entsprechenden COM-Add-Ins im Manifest hat keine Auswirkungen auf andere Plattformen wie Office im Web oder auf Mac.

In den folgenden Szenarien wird beschrieben, was geschieht, je nachdem, wie der Benutzer das Office-Add-In erhält.

AppSource-Erwerb eines Office-Add-Ins

Wenn ein Benutzer das Office-Add-In von AppSource abruft und das entsprechende COM-Add-In bereits installiert ist, führt Office folgendes aus:

  1. Installieren Sie das Office-Add-In.
  2. Blenden Sie die Office-Add-In-Benutzeroberfläche im Menüband aus.
  3. Zeigt einen Aufruf für den Benutzer an, der auf die Schaltfläche des COM-Add-In-Menübands verweist.

Zentrale Bereitstellung des Office-Add-Ins

Wenn ein Administrator das Office-Add-In mithilfe einer zentralisierten Bereitstellung für seinen Mandanten bereitstellt und das entsprechende COM-Add-In bereits installiert ist, muss der Benutzer Office neu starten, bevor änderungen angezeigt werden. Nach dem Neustart von Office wird Folgendes ausgeführt:

  1. Installieren Sie das Office-Add-In.
  2. Blenden Sie die Office-Add-In-Benutzeroberfläche im Menüband aus.
  3. Zeigt einen Aufruf für den Benutzer an, der auf die Schaltfläche des COM-Add-In-Menübands verweist.

Mit eingebettetem Office-Add-In freigegebenes Dokument

Wenn ein Benutzer das COM-Add-In installiert hat und dann ein freigegebenes Dokument mit dem eingebetteten Office-Add-In erhält, führt Office beim Öffnen des Dokuments folgendes aus:

  1. Fordern Sie den Benutzer auf, dem Office-Add-In zu vertrauen.
  2. Wenn sie vertrauenswürdig ist, wird das Office-Add-In installiert.
  3. Blenden Sie die Office-Add-In-Benutzeroberfläche im Menüband aus.

Anderes COM-Add-In-Verhalten

Excel, PowerPoint, Word

Wenn ein Benutzer das entsprechende COM-Add-In deinstalliert, stellt Office unter Windows die Office-Add-In-Benutzeroberfläche wieder her.

Nachdem Sie ein entsprechendes COM-Add-In für Ihr Office-Add-In angegeben haben, beendet Office die Verarbeitung von Updates für Ihr Office-Add-In. Um die neuesten Updates für das Office-Add-In zu erhalten, muss der Benutzer zuerst das COM-Add-In deinstallieren.

Outlook

Das COM/VSTO-Add-In muss beim Starten von Outlook verbunden sein, damit das entsprechende Web-Add-In deaktiviert wird.

Wenn das COM/VSTO-Add-In dann während einer nachfolgenden Outlook-Sitzung getrennt wird, bleibt das Web-Add-In wahrscheinlich deaktiviert, bis Outlook neu gestartet wird.

Siehe auch