Teilen über

Kompatibilität Ihres Office-Add-Ins mit einem vorhandenen COM- oder VSTO-Add-In

Wenn Sie über ein vorhandenes COM-Add-In oder VSTO-Add-In verfügen, können Sie nahezu gleichwertige Funktionen in Ihrem Office-Web-Add-In erstellen, sodass Ihre Lösung auf anderen Plattformen wie in Office im Web oder auf Mac ausgeführt werden kann. In diesem Szenario werden die beiden Add-Ins als "äquivalent" bezeichnet, und Sie können das Manifest des Office Web-Add-Ins verwenden, um zu steuern, welches Add-In für Benutzer auf Windows-Computern verfügbar ist (oder Benutzern die Wahl geben).

Hinweis

Da COM- und VSTO-Add-Ins nur unter Windows installiert werden können, bezieht sich dieser Artikel auf COM- und VSTO-Add-Ins zusammen als "nur Windows"-Add-Ins.

In der Regel sollten Add-Ins nur dann als gleichwertig behandelt werden, wenn die folgenden Bedingungen erfüllt sind. Es kann jedoch außergewöhnliche Szenarien geben, in denen Add-Ins sind, die diese Bedingungen nicht erfüllen, als gleichwertig behandelt werden können.

  • Sie werden beide vom gleichen Entwickler erstellt, in der Regel die Entität, die in der "developer" Eigenschaft des einheitlichen Manifests oder das ProviderName-Element im reinen Add-In-Manifest angegeben ist.
  • Beide sind so konzipiert, dass sie in derselben Office-Anwendung oder -Anwendungen installiert werden, und sie decken dieselbe Workload mit hauptsächlich überlappenden Funktionen ab.
  • Sie verfügen über identische oder sehr ähnliche öffentliche Namen und Benutzeroberflächen, einschließlich Steuerelementnamen und Symbolen.

Wichtig

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

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

Wichtig

COM- und VSTO-Add-Ins werden im neuen Outlook unter Windows 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.

Da das reine Windows-Add-In und das Office-Add-In möglicherweise nicht genau die gleichen Features aufweisen, müssen Sie drei Szenarien berücksichtigen.

Abrufen des Namens des reinen Windows-Add-Ins

Bevor Sie das Manifest des Office-Add-Ins konfigurieren können, müssen Sie zunächst den Namen des reinen Windows-Add-Ins in der Windows-Registrierung mit den folgenden Schritten identifizieren:

  1. Öffnen Sie den Windows-Registrierungs-Editor auf jedem Computer, auf dem das reine Windows-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 nur für Windows benötigten Add-In zugeordnet ist. Beachten Sie, dass bei den Namen die Groß-/Kleinschreibung beachtet wird.

Ausblenden des Office-Add-Ins

Sie können Ihr Office-Add-In so konfigurieren, dass Office unter Windows anstelle des Office-Add-Ins das reine Windows-Add-In ausführt, wenn das entsprechende reine Windows-Add-In bereits auf dem Computer eines Benutzers installiert ist. Wenn das reine Windows-Add-In jemals deinstalliert wird, aktiviert Office das Office-Add-In automatisch, wenn die Host-Office-Anwendung das nächste Mal gestartet wird. Wenn das reine Windows-Add-In nach dem Office-Add-In installiert wird, wird das Office-Add-In ausgeblendet, wenn die Office-Anwendung neu gestartet wird. Weitere Informationen finden Sie unter Verhalten für Benutzer, wenn das Office-Add-In ausgeblendet ist.

Konfigurieren des Manifests

Wichtig

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

Um die Kompatibilität zwischen Ihrem Office-Add-In und dem reinen Windows-Add-In zu ermöglichen, identifizieren Sie das entsprechende Reine Windows-Add-In im Manifest Ihres Office-Add-Ins mithilfe des Namens, den Sie im Abschnitt Abrufen des Namens des reinen Windows-Add-Ins erhalten haben. Office unter Windows verwendet dann das reine Windows-Add-In anstelle des Office-Add-Ins, wenn beide installiert sind. Die Konfiguration hängt vom Typ des verwendeten Manifests ab.

Das folgende Beispiel zeigt den Teil des Manifests, der ein reines Windows-Add-In als entsprechendes Add-In angibt. Der Wert der "alternates.prefer.comAddin.progId" -Eigenschaft identifiziert das reine Windows-Add-In.

Hinweis

Obwohl die Eigenschaft "comAddin" heißt, bezieht sie sich tatsächlich auf jedes reine Windows-Add-In, unabhängig davon, ob es sich bei dem Add-In um COM oder VSTO handelt. Ebenso wird der Begriff "progId" normalerweise nur com-Add-Ins zugeordnet, aber im Manifest bezieht er sich auf den Namen des reinen Windows-Add-Ins.

"extensions" [
  ...
  "alternates" [
    {
      "prefer": {
        "comAddin": {
          "progId": "ContosoAddin"
        }
      }
    }
  ]
]

Tipp

Wenn Sie die alternates.prefer Eigenschaft im Manifest Ihres Outlook-Web-Add-Ins nicht angeben können, müssen Sie stattdessen Gruppenrichtlinie konfigurieren. Dies gilt nur für Outlook. Eine Anleitung finden Sie unter Konfigurieren der Gruppenrichtlinie-Einstellung für Outlook-Add-Ins.

Tipp

Konfigurieren der Gruppenrichtlinie-Einstellung für Outlook-Add-Ins

Ein Benutzer mit Administratorberechtigungen auf dem Computer kann ein reines Windows-Add-In als Äquivalent zu einem Outlook-Add-In konfigurieren, indem er das Deaktivieren von Outlook-Web-Add-Ins verwendet, deren entsprechendes COM- oder VSTO-Add-In Gruppenrichtlinie Einstellung auf dem Computer installiert ist. Dies kann auch dann erreicht werden, wenn das Manifest des Outlook-Add-Ins nicht über das entsprechende Add-In-Markup verfügt. Dann verwendet das klassische Outlook unter Windows das reine Windows-Add-In anstelle des Outlook-Add-Ins, wenn beide installiert sind. Im Folgenden werden die Schritte zum Konfigurieren der Richtlinie beschrieben.

  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 des Outlook-Add-In-Manifests fest. Verwenden Sie im reinen Add-In-Manifest den Wert des <ID> -Elements. Verwenden Sie im einheitlichen Manifest den Wert der id -Eigenschaft im Stammverzeichnis des Manifests. Fügen Sie dem Eintrag keine geschweiften Klammern {} hinzu.
    2. Legen Sie Value auf den Namen des entsprechenden reinen Windows-Add-Ins fest. Weitere Informationen finden Sie im Abschnitt Abrufen des Namens des reinen Windows-Add-Ins.
    3. Wählen Sie OK aus, um das Update zu aktivieren.

    Das Dialogfeld

Verhalten für Benutzer, wenn das Office-Add-In ausgeblendet ist

Wenn ein entsprechendes reines Windows-Add-In angegeben ist, zeigt Office unter Windows die Benutzeroberfläche (UI) Ihres Office-Add-Ins nicht an, wenn das entsprechende reine Windows-Add-In installiert ist. Office blendet jedoch 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

Das Angeben eines äquivalenten reinen Windows-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.

Microsoft Marketplace-Erwerb des Office-Add-Ins

Wenn ein Benutzer das Office-Add-In vom Microsoft Marketplace abruft und das entsprechende reine Windows-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 Menübands für das reine Windows-Add-In 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 reine Windows-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 Menübands für das reine Windows-Add-In verweist.

Dokument, das mit dem eingebetteten Office-Add-In freigegeben wurde

Wenn ein Benutzer das reine Windows-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 Verhalten des reinen Windows-Add-Ins

Excel, PowerPoint, Word

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

Nachdem Sie ein entsprechendes reines Windows-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 reine Windows-Add-In deinstallieren.

Outlook

Das reine Windows-Add-In muss beim Starten von Outlook verbunden sein, damit das entsprechende Outlook-Add-In deaktiviert wird.

Wenn das reine Windows-Add-In dann während einer nachfolgenden Outlook-Sitzung getrennt wird, bleibt das Outlook-Add-In wahrscheinlich deaktiviert, bis Outlook neu gestartet wird.

Ausblenden des reinen Windows-Add-Ins

Hinweis

Die in diesem Abschnitt beschriebene Option weist die folgenden Einschränkungen auf.

  • Sie wird nur für Excel, PowerPoint und Word unterstützt.
  • Die Office-Mindestversion, die das Feature unterstützt, ist Office-Abonnement unter Windows Version 2506 (Build 19029.20004).

Konfigurieren des Manifests

Die Details zum Konfigurieren dieses Features hängen davon ab, welcher Manifesttyp vom Office-Add-In verwendet wird.

Führen Sie die folgenden Schritte aus, um das reine Windows-Add-In zu deaktivieren.

  1. Wenn sie noch nicht vorhanden ist, erstellen Sie eine "extensions.alternates.hide.windowsExtensions" Eigenschaft.
  2. Fügen Sie der windowsExtensions Eigenschaft eine untergeordnete effect Eigenschaft hinzu, und legen Sie ihren Wert auf disableWithNotification fest.
  3. Fügen Sie der windowsExtensions Eigenschaft eine untergeordnete "comAddin" Eigenschaft hinzu.
  4. Fügen Sie der comAddin Eigenschaft eine untergeordnete progIds Arrayeigenschaft hinzu.
  5. Fügen Sie die Namen aller reinen Windows-Add-Ins hinzu, die Sie dem progIds Array ausblenden möchten. Informationen zum Abrufen dieser Namen finden Sie unter Abrufen des Namens des reinen Windows-Add-Ins.

Hinweis

Die Zeichenfolge "com" ist aus historischen Gründen im Namen comAddin enthalten. Im Manifest verweist die -Eigenschaft auf COM- oder VSTO-Add-Ins. Ebenso wird der Begriff "progIds" normalerweise nur com-Add-Ins zugeordnet, aber Namen von VSTO-Add-Ins können auch in das progIds Array eingeschlossen werden.

Das folgende Beispiel zeigt, wie der JSON-Code aussehen sollte.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "disableWithNotification",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Verhalten für Benutzer, wenn das reine Windows-Add-In ausgeblendet ist

Wenn ein reines Windows-Add-In ausgeblendet ist, zeigt Office unter Windows seine Benutzeroberfläche (UI) nicht an, wenn das entsprechende Office-Add-In installiert ist. Ein Popupdialogfeld benachrichtigt den Benutzer darüber, dass dies geschieht. Office blendet jedoch nur das reine Windows-Add-In aus und verhindert die Installation nicht.

Dem Benutzer die Wahl geben, welches Add-In verwendet werden soll

Hinweis

Die in diesem Abschnitt beschriebene Option weist die folgenden Einschränkungen auf.

  • Sie wird nur für Excel, PowerPoint und Word unterstützt.
  • Die Office-Mindestversion, die das Feature unterstützt, ist Office-Abonnement unter Windows Version 2506 (Build 19029.20004).

Konfigurieren des Manifests

Die Details zum Konfigurieren dieses Features hängen davon ab, welcher Manifesttyp vom Office-Add-In verwendet wird.

Führen Sie die folgenden Schritte aus, um dem Benutzer die Wahl zu geben, welches Add-In ausgeblendet werden soll.

  1. Wenn sie noch nicht vorhanden ist, erstellen Sie eine "extensions.alternates.hide.windowsExtensions" Eigenschaft.
  2. Fügen Sie der windowsExtensions Eigenschaft eine untergeordnete effect Eigenschaft hinzu, und legen Sie deren Wert auf userOptionToDisable fest.
  3. Fügen Sie der windowsExtensions Eigenschaft eine untergeordnete "comAddin" Eigenschaft hinzu.
  4. Fügen Sie der comAddin Eigenschaft eine untergeordnete progIds Arrayeigenschaft hinzu.
  5. Fügen Sie dem Array die Namen aller entsprechenden reinen Windows-Add-Ins hinzu progIds . Informationen zum Abrufen dieser Namen finden Sie unter Abrufen des Namens des reinen Windows-Add-Ins.

Hinweis

Die Zeichenfolge "com" ist aus historischen Gründen im Namen comAddin enthalten. Im Manifest verweist die -Eigenschaft auf COM- oder VSTO-Add-Ins. Ebenso wird der Begriff "progIds" normalerweise nur com-Add-Ins zugeordnet, aber Namen von VSTO-Add-Ins können auch in das progIds Array eingeschlossen werden.

Das folgende Beispiel zeigt, wie der JSON-Code aussehen sollte.

"extensions" [
  {   
    ...
    "alternates": [
      {
        "hide": {
          "windowsExtensions": {
            "effect": "userOptionToDisable",
            "comAddin": {
              "progIds": [
                "ContosoAddin"
              ]
            }
          }
        }
      }
    ]
  }
]

Verhalten für Benutzer, wenn sie auswählen können, welches Add-In ausgeblendet ist

Wenn Sie das Manifest so konfigurieren, dass der Benutzer die Wahl hat, wird dem Benutzer bei der Installation des Office-Add-Ins ein Dialogfeld ähnlich dem folgenden angezeigt. Der Link Weitere Informationen im Dialogfeld verweist auf die folgende Hilfeseite, die Informationen enthält, die dem Benutzer bei der Entscheidung helfen: Beheben von Versionskonflikten für Office-Add-Ins.

Ein Dialogfeld mit dem Titel

Wenn der Benutzer Ja auswähnt und Office das reine Windows-Add-In erfolgreich deaktiviert und ausblendet, wird ein Dialogfeld ähnlich dem folgenden geöffnet, in dem der Benutzer aufgefordert wird, die Office-Anwendung neu zu starten.

Ein Dialogfeld mit dem Titel

Wenn der Benutzer Ja auswählt, aber Office kann das reine Windows-Add-In aus irgendeinem Grund nicht deaktivieren, wird ein Dialogfeld ähnlich dem folgenden geöffnet, in dem der Benutzer aufgefordert wird, das reine Windows-Add-In manuell zu deaktivieren.

Ein Dialogfeld mit dem Titel

Siehe auch

  • Last updated on