Share via

Verwalten eines einheitlichen Manifests und einer XML-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 nie zwei Kopien der Add-In-Benutzeroberfläche in Outlook angezeigt werden. 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 die richtige Add-In-Ressourcen-ID aktualisieren und das einheitliche Manifest erneut übermitteln.
    • Ein vorhandenes Add-In kann nur durch ein einzelnes einheitliches Manifest ausgeblendet werden. Derzeit können 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 ihr Add-In in früheren Versionen von Office nicht mehr verwendet werden kann.

Verwalten beider Versionen für die unmittelbare Zukunft

Wenn alle Ihre Benutzer mit Office-Versionen arbeiten, die das einheitliche Manifest unterstützen, können Sie die XML-Version aus der Bereitstellung entfernen, aber Sie müssen beide Versionen für die unmittelbare Zukunft beibehalten.

Anfänglich können Add-Ins, die das einheitliche Manifest unterstützen, nur unter Microsoft 365 Version 2307 (Build 16626.20132) und höher installiert werden. Wir arbeiten hart daran, Unterstützung für ältere Versionen von Microsoft 365 zu bieten. In der Zwischenzeit müssen Sie beide Versionen verwalten.

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 XML-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.