Freigeben über

Verwalten eines einheitlichen Manifests und einer reinen Add-In-Manifestversion Ihres Office-Add-Ins

  • Artikel

Microsoft nimmt eine Reihe von Verbesserungen an der Microsoft 365 Entwicklerplattform vor. Diese Verbesserungen bieten mehr Konsistenz bei der Entwicklung, Bereitstellung, Installation und Verwaltung aller Arten von Erweiterungen von Microsoft 365, einschließlich Office-Add-Ins.

Eine wichtige Verbesserung, an der wir arbeiten, ist die Möglichkeit, eine einzelne Verteilungseinheit für alle Microsoft 365-Erweiterungen zu erstellen, indem Sie dasselbe Manifestformat verwenden: das JSON-formatierte einheitliche Manifest für Microsoft 365.

Tipp

Informationen zum Konvertieren eines vorhandenen Add-Ins zur Verwendung des einheitlichen Manifests finden Sie unter Konvertieren eines Add-Ins zur Verwendung des einheitlichen Manifests für Microsoft 365.

Nachdem Sie eine Version Ihres Add-Ins erstellt haben, die das einheitliche Manifest verwendet, müssen Sie das vorhandene Add-In und die app verknüpfen, die mithilfe des einheitlichen Manifests erstellt wurde, um sicherzustellen, dass Benutzern nicht zwei Kopien der Add-In-Benutzeroberfläche in Outlook angezeigt werden.

Hinweis

Die unten beschriebene Konfiguration wird erst 24 Stunden nach der Installation der neuen Version auf dem Computer eines Benutzers wirksam. Während dieses Zeitraums ist die Benutzeroberfläche beider Versionen sichtbar. Wenn beide Versionen beispielsweise über eine benutzerdefinierte Menübandschaltfläche verfügen, werden beide Schaltflächen im Menüband angezeigt.

Führen Sie die folgenden Schritte aus.

  1. Öffnen Sie das Erweiterungsobjekt im Array "extensions".

  2. Erstellen Sie eine Arrayeigenschaft "alternativen", falls noch keine vorhanden ist.

  3. Erstellen Sie im Array "alternatives" ein "alternate"-Objekt, das über die Eigenschaft "hide" verfügt.

  4. Wenn das vorhandene Add-In über AppSource vermarktet wird, weisen Sie dem "hide"-Objekt eine "storeOfficeAddin"-Eigenschaft zu. Setzen Sie den Vorgang andernfalls mit Schritt 6 fort.

  5. Weisen Sie dem Objekt "storeOfficeAddin" zwei Eigenschaften zu:

    • Eine "officeAddinId" mit der GUID des alten Add-Ins als Wert.
    • Eine "assetId" mit der AppSource-Ressourcen-ID als Wert.

    Es folgt ein Beispiel:

    "extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "storeOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4",
                        "assetId": "WA999999999"
                    }
                }
            }
        ]
    }
]

    Hinweis

    • Die Objekt-ID des Add-Ins in Ihrem einheitlichen Manifest muss mit einem vorhandenen Add-In übereinstimmen, das von Ihrem Verkäuferkonto im Partner Center veröffentlicht wurde. Wenn die Objekt-ID des Add-Ins, das Sie in Ihrem einheitlichen Manifest verknüpft haben, nicht mit einem vorhandenen Angebot übereinstimmt, das von Ihrem Verkäuferkonto veröffentlicht wurde, schlägt die übermittlung des einheitlichen Manifests fehl. Sie müssen das Manifest aktualisieren, um die richtige Add-In-Ressourcen-ID zu verwenden und das einheitliche Manifest erneut zu übermitteln.
    • Ein vorhandenes Add-In kann nur durch ein einzelnes einheitliches Manifest ausgeblendet werden. Derzeit dürfen Sie nicht mehrere einheitliche Manifeste verwenden, um dasselbe Add-In auszublenden. Wenn Sie versuchen, ein bereits verknüpftes Add-In mithilfe eines anderen einheitlichen Manifests auszublenden, schlägt die Übermittlung fehl. Sie müssen die Verknüpfung entfernen und das einheitliche Manifest erneut übermitteln.

  6. Wenn das alte Add-In nicht über AppSource verteilt wird, weisen Sie dem Hide-Objekt eine "customOfficeAddin"-Eigenschaft zu.

  7. Weisen Sie dem "customOfficeAddin"-Objekt eine "officeAddinId"-Eigenschaft mit der GUID des alten Add-Ins als Wert zu. Es folgt ein Beispiel.

    "extensions": [
    ...
    {
        ...
        "alternates": [
            ...
            {
                ...
                "hide": {
                    "customOfficeAddin": {
                        "officeAddinId": "b5a2794d-4aa5-4023-a84b-c60a3cbd33d4"
                    }
                }
            }
        ]
    }
]

Entfernen Sie das vorhandene Add-In nicht aus AppSource oder dem Microsoft 365 Admin Center, da frühere Versionen von Office Ihr Add-In nicht mehr verwenden können.

Verwalten beider Versionen für die unmittelbare Zukunft

Im Allgemeinen können Add-Ins, die das einheitliche Manifest verwenden, nur unter Microsoft 365 Version 2307 (Build 16626.20132) und höher installiert werden. Es gibt jedoch zwei Ausnahmen, die es ermöglichen, dass diese Add-Ins in älteren Versionen von Microsoft 365 und in unbefristeten Lizenzversionen von Office installiert werden können.

  • Der Microsoft 365-Administrator des Benutzers stellt das Add-In für alle Benutzer bereit.
  • Der Benutzer installiert das Add-In in einer anderen Microsoft 365-Client-App mit Version 2307 (Build 16626.20132) und höher. Dadurch wird das Add-In auf den anderen Office-Clients desselben Benutzers verfügbar, einschließlich einer älteren oder unbefristeten Lizenz.

Wenn Sie über Benutzer mit älteren oder unbefristeten Lizenzversionen verfügen, für die diese Ausnahmen nicht gelten, müssen Sie beide Versionen des Add-Ins verwalten. Wenn alle Ihre Benutzer mit Office-Versionen arbeiten, die das einheitliche Manifest unterstützen, können Sie die XML-Version aus der Bereitstellung entfernen.

Es gibt auch einige Szenarien, in denen Sie beide Versionen des Add-Ins für einen längeren Zeitraum verwalten möchten. Beispielsweise gibt es zwei Features von Add-Ins, die mit dem einheitlichen Manifest nicht unterstützt werden, da sie wenig verwendet oder veraltet sind. Sie können eine Version Ihres Add-Ins verwalten, die diese Features verwendet. Im Folgenden finden Sie die Features, die im einheitlichen Manifest nicht unterstützt werden.

Die wichtige Voraussetzung für die Bereitstellung von zwei Versionen besteht darin, sicherzustellen, dass die beiden auf der Outlook-Benutzeroberfläche unterschiedlich erscheinen.

  • Geben Sie der neuen Version einen anderen Namen als das vorhandene Add-In.
  • Erstellen und verwenden Sie verschiedene Symbole für die neue Version.
  • Stellen Sie sicher, dass die Eigenschaft "id" des einheitlichen Manifests in der neuen Version eine andere GUID als das <Id-Element> im reinen Add-In-Manifest des vorhandenen Add-Ins ist.

Hinweis

Wenn Sie denselben Namen und das gleiche Symbol verwenden, werden die alten und neuen Projektmappen in der Outlook-Benutzeroberfläche für die Add-In-Installation nicht unterschieden.