Freigeben über

Allgemeine Anleitung zum Kombinieren eines Office-Add-Ins und einer Teams-App

  • Artikel

Wenn Sie über eine vorhandene Teams-App und ein Office-Add-In verfügen, die eng miteinander verknüpfte oder sich überschneidende Funktionen und Workloads verfügen, wird empfohlen, diese in einer einzigen App zu kombinieren. Dadurch können Benutzer und Microsoft 365-Mandantenadministratoren sowohl das Add-In als auch die Teams-App als Einheit erwerben und genehmigen. Ein Beispiel für eine App, die ein Add-In und eine Teams-App kombiniert, finden Sie unter Beispiel für Rabattangebote.

Hinweis

Outlook-Add-Ins sind die einzige Art von Office-Add-In, die mit einer Teams-App kombiniert werden kann. Wir arbeiten hart daran, dieses Feature auch für Excel-, PowerPoint- und Word-Add-Ins zu unterstützen.

Es kann aus folgenden Gründen kein algorithmisches Verfahren zum Zusammenführen eines Add-Ins und einer Teams-App geben:

  • Ein Algorithmus muss Annahmen über die Ordner- und Dateistruktur der vorhandenen Teams-App treffen. Diese Strukturen variieren jedoch je nachdem, welches Tool zum Erstellen des App-Projekts verwendet wurde und welche Version dieses Tools verwendet wurde. Und natürlich hat der Entwickler der App möglicherweise die Struktur geändert, nachdem das Projekt erstellt wurde.
  • Das vorangehende Aufzählungszeichen gilt auch für das Add-In-Projekt.
  • Ein Algorithmus muss Annahmen über die Einstellungen in verschiedenen Konfigurationsdateien treffen. Diese Einstellungen variieren jedoch auch abhängig davon, wie das Projekt erstellt wurde und welche Änderungen an der Konfiguration seit der Erstellung vorgenommen wurden.
  • Ein Algorithmus muss davon ausgehen, welche Sprache , TypeScript oder JavaScript, für den clientseitigen Quellcode der Webanwendung verwendet wurde.

Hinweis

Beachten Sie zusätzlich zu diesen Aufzählungszeichen auch, dass es zwei grundlegende Familien von Webanwendungsframeworks gibt, auf denen entweder das Add-In oder die Teams-App erstellt wurde.

  • IIS/.NET:

    • Add-In-Projekte können in Visual Studio mit den Office-Entwicklertools erstellt werden. In diesem Fall basiert der Webanwendungsteil auf ASP.NET und Internetinformationsserver (IIS).
    • Teams-App-Projekte können in Visual Studio mit dem Teams-Toolkit für Visual Studio erstellt werden. In diesem Fall handelt es sich bei dem Webanwendungsteil um eine Blazor/C#-Anwendung.

  • Node.js Server/JavaScript oder TypeScript:

Visual Studio unterstützt das einheitliche Manifest derzeit nicht in Add-In-Projekten. Daher wird in diesem Artikel davon ausgegangen, dass sowohl das Add-In als auch das Teams-App-Projekt Node.js-basiert sind und nicht mit Visual Studio erstellt werden.

Wir können jedoch einige allgemeine Empfehlungen zum Kombinieren eines Add-Ins mit einer Teams-App geben.

Erfahren Sie mehr über das Manifest und die Struktur einer kombinierten Teams-App und eines Office-Add-Ins.

Bevor Sie mit dem Zusammenführen Ihrer beiden vorhandenen Erweiterungen beginnen, erhalten Sie einen Eindruck davon, wie Sie die beiden Arten von Erweiterungen zusammenführen, indem Sie eine neue Teams-App und ein neues Add-In im Teams-Toolkit erstellen und dann die Anweisungen unter Hinzufügen eines Outlook-Add-Ins zu einer Teams-App befolgen, um sie zu kombinieren. Achten Sie genau auf Folgendes:

  • So wird das einzelne einheitliche Manifest erstellt.
  • Die Unterschiede in der Weise, wie das Add-In und die Teams-App quergeladen und gedebuggt werden.

Befolgen Sie die richtigen Prinzipien für die Kombination von Teams-Apps und Add-Ins.

Wenn Sie bereit sind, Ihr vorhandenes Add-In und Ihre Teams-App zusammenzuführen, befolgen Sie die folgenden Prinzipien:

  • Wenn das Add-In ein XML-Manifest verwendet, konvertieren Sie es, um das einheitliche Manifest für Microsoft 365 zu verwenden, wie unter Konvertieren eines Add-Ins zur Verwendung des einheitlichen Manifests für Microsoft 365 beschrieben, bevor Sie es mit einer Teams-App kombinieren.
  • Verwenden Sie das Teams-App-Projekt als Basisprojekt für die zusammengeführte Anwendung.
  • Behalten Sie Konfigurationsdateien, die sowohl für das Add-In als auch für die Teams-App gelten, im Stammverzeichnis des Projekts bei.
  • Verschieben Sie Quell- und Konfigurationsdateien, die nur für die Teams-App gelten, in einen Unterordner aus dem Stammverzeichnis des Projekts. Ebenso können Sie Quell- und Konfigurationsdateien, die nur vom Add-In verwendet werden, aus dem vorhandenen Add-In in einen anderen Unterordner außerhalb des Stammverzeichnisses des kombinierten Projekts kopieren.
  • Verwenden Sie dieselbe Basisdomäne für die erstellten Dateien des Add-Ins und der Teams-App. beispiel: contoso.com.
  • Führen Sie die beiden Manifeste in einem einzelnen Manifest zusammen. Verwenden Sie den Prozess, den Sie in Schritt 1 durchlaufen haben, als Leitfaden.
  • Die id-Eigenschaft im neuen Manifest sollte denselben Wert wie die Eigenschaft "id" im ursprünglichen Teams-App-Manifest aufweisen.
  • Erhöhen Sie den Wert der Versionseigenschaft ; Erhöhen Sie beispielsweise "1.0.0" auf "1.1.0".
  • Fügen Sie dem Manifest eine extensions.alternates-Eigenschaft hinzu, und konfigurieren Sie sie so, dass das ursprüngliche Office-Add-In in Versionen von Office ausgeblendet wird, die das Kombinieren eines Add-Ins und einer Teams-App unterstützen. Weitere Informationen finden Sie unter Verwalten neuer und alter Versionen eines Add-Ins.

Veröffentlichen der kombinierten Teams-App und des Office-Add-Ins

Um die kombinierte App zu veröffentlichen, behandeln Sie sie wie ein Update für die Teams-App. Weitere Informationen finden Sie unter Veröffentlichen von Updates für Ihre App.

Wenn das Update veröffentlicht wurde, variiert, wie das Update für Endbenutzer verfügbar wird. Im Folgenden sind die allgemeinen Prinzipien aufgeführt.

Hinweis

Um klar zu machen, was "verfügbar" bedeutet, beachten Sie, dass Outlook und die Microsoft 365-Anwendung genau wie Teams über eine App-Leiste verfügen. Grundsätzlich kann eine "Teams-App" über die Schaltfläche Apps oder Weitere Apps auf einer dieser drei App-Leisten installiert werden. Die installierte "Teams-App" kann über eine der App-Leisten einer der drei Anwendungen gestartet (oder separat an) angeheftet werden. Ein eigenständiges Outlook-Add-In wird hingegen über die Schaltfläche Alle Apps im Outlook-Menüband installiert. Und unabhängig davon, ob es eigenständig oder in einer Teams-App kombiniert ist, wird ein Add-In über das Outlook-Menüband gestartet oder automatisch als Reaktion auf ein Ereignis in der geöffneten Outlook-Nachricht oder dem Besprechungselement gestartet. Diese Tatsachen werden im restlichen Teil dieses Abschnitts angenommen.

  • Wenn der Microsoft 365-Administrator dem Update zustimmt, dann:

    • Die aktualisierte Version der Teams-App ist sofort über Apps oder Weitere Apps in Outlook und die Microsoft 365-Anwendung verfügbar, aber nicht über die Teams-Apps für Benutzer, die zuvor die Teams-App erworben hatten.
    • Das Outlook-Add-In ist auch sofort für Benutzer verfügbar, die zuvor die Teams-App erworben haben, unabhängig davon, ob sie zuvor auch das Add-In erworben haben.
    • Wenn ein Teams-Administrator das Update zulässt, können Benutzer es einzeln über die Teams-Apps in Teams installieren.

  • Wenn der Administrator nicht zustimmt, muss jeder Benutzer, der die Teams-App zuvor erworben hat, dem Update zustimmen, und es kann in Teams nur verfügbar gemacht werden, wenn der Teams-Administrator es zugelassen hat.

  • Benutzer, die zuvor nur das Office-Add-In erworben haben, müssen die neue kombinierte App aus dem Teams Store erwerben. Sie kann nicht über die Schaltfläche Alle Apps im Outlook-Menüband abgerufen werden.

Wichtig

Benutzern mit bestimmten älteren Versionen von Office wird möglicherweise die alte Version des Add-Ins angezeigt, auch nachdem die neue kombinierte App erworben wurde. Im Allgemeinen können Add-Ins, die das einheitliche App-Manifest für Microsoft 365 (früher Teams-App-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 Outlook im Web, in neuem Outlook für Windows oder in einer anderen Microsoft 365-Desktopclient-App mit Version 2307 (Build 16626.20132) oder höher. Dadurch wird das Add-In auf den anderen Office-Clients desselben Benutzers verfügbar, einschließlich älterer oder unbefristeter Lizenzclients.

In Zukunft müssen Sie nur noch die neue Version der App aktualisieren.

Siehe auch