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

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.

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.

Angeben eines entsprechenden COM-Add-Ins

Abrufen der ProgId eines COM-Add-Ins

Bevor Sie ein entsprechendes COM-Add-In angeben können, müssen Sie zuerst dessen ProgIdangeben. So rufen Sie die ProgId eines COM-Add-Ins ab:

1. Öffnen Sie den Windows-Registrierungs-Editor auf dem Computer, auf dem das COM-Add-In installiert ist.
2. Wechseln Sie zuHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\<Office-Anwendung>\Addins oder HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<Office-Anwendung>\Addins, wobei <Office-Anwendung> Excel, Outlook, PowerPoint oder Word ist. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Excel\Addinsz. B . .
3. Kopieren Sie den Namen des Registrierungsschlüssels, der dem benötigten COM-Add-In zugeordnet ist. Beachten Sie, dass bei den Namen die Groß-/Kleinschreibung beachtet wird.

Konfigurieren des Manifests

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>

Konfigurieren der Gruppenrichtlinieneinstellung

Um die Kompatibilität zwischen Ihrem Outlook-Web-Add-In und dem COM-Add-In zu deklarieren, identifizieren Sie das entsprechende COM-Add-In in der Gruppenrichtlinieneinstellung Outlook-Web-Add-Ins deaktivieren, deren entsprechendes COM- oder VSTO-Add-In installiert ist . Dies muss auf dem Computer des Benutzers konfiguriert werden. Dann verwendet das klassische Outlook unter Windows 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 Gruppenrichtlinien (gpedit.msc).

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

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-Add-Ins fest.
   3. Wählen Sie OK aus, um das Update zu aktivieren.

   

Ä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).

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-Add-In muss beim Starten von Outlook verbunden sein, damit das entsprechende Web-Add-In deaktiviert wird.

Wenn das COM-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

• Kompatibilität Ihrer benutzerdefinierten Funktionen mit benutzerdefinierten XLL-Funktionen