Freigeben über

Erstellen von Registerkarten für Teams

  • Artikel

Registerkarten sind clientfähige Webseiten, die in Microsoft Teams, Outlook und Microsoft 365 eingebettet sind. Es handelt sich um einfache HTML-<iframe/>-Tags, die auf im App-Manifest deklarierte Domänen verweisen und als Teil eines Kanals innerhalb eines Teams, Gruppenchats oder einer persönlichen App für einen einzelnen Benutzer hinzugefügt werden können. Sie können benutzerdefinierte Registerkarten in Ihre App einschließen, um Ihre eigenen Webinhalte in Teams einzubetten oder Ihren Webinhalten Teams-spezifische Funktionen hinzuzufügen. Weitere Informationen finden Sie unter Teams JavaScript-Clientbibliothek.

Wichtig

Benutzerdefinierte Registerkarten sind in Government Community Cloud (GCC), GCC-High und Department of Defense (DOD) verfügbar.

Es gibt zwei Arten von Registerkarten: statische und konfigurierbare Registerkarten. Diese Registerkarten können in drei unterschiedlichen Bereichen verwendet werden: personal, groupchatund teams. Persönliche (statische) Registerkarten sind zusammen mit persönlichen Bots Teil der persönlichen Apps, die für einen einzelnen Benutzer gelten und für den einfachen Zugriff an die linke Navigationsleiste angeheftet sind. Persönliche (statische) Registerkarten im persönlichen Bereich funktionieren weiterhin auf die gleiche Weise. Sie können statische Registerkarten jetzt jedoch auf Gruppenchats, Kanäle oder Besprechungen mit einer anpassbaren Oberfläche erweitern.

Registerkarten in Chats, Kanälen oder Besprechungen verhalten sich eher wie Apps, da Sie nur eine Registerkarte pro App anheften können. Beispielsweise können Sie nur eine einzelne YouTube-App-Registerkarte in einer Besprechung anheften. Statische Registerkarten in Besprechungen können auch von IT-Administratoren in Besprechungen vorangestellt werden.

Die folgenden Abbildungen zeigen Registerkarten, die verschiedenen Kontexten in Teams hinzugefügt wurden:

Teams Desktop

Screenshot: Registerkarte, die einem persönlichen Bereich hinzugefügt wurde

Teams für Mobilgeräte

Das Beispiel zeigt, dass eine mobile Registerkarte in einem persönlichen Kontext hinzugefügt wird.

Im Folgenden finden Sie einige Vorteile statischer Registerkarten in Chats, Kanälen und Besprechungen:

  • Anheftbar und sofort: Sie können Apps mit statischen Registerkarten über das Symbol "Registerkarte hinzufügen" + in Chats, Kanälen und Besprechungen anheften. Diese Registerkarten können entpinnt werden und verfügen nicht über das obligatorische Konfigurationsdialogfeld, mit dem Sie Registerkarten erstellen können, die eher wie Apps funktionieren.

  • Vereinheitlicht: Sie können eine statische Registerkarte erstellen, die in persönlichen und Gruppenbereichen wie Chat-, Kanal- und Besprechungsregisterkarten funktioniert.

  • Optionale Konfiguration: Sie können die Standard-URL in Ihrer Registerkarteninstanz ändern, indem Sie die contentUrl Eigenschaft Ihrer App ändern, nachdem sie in Teams angeheftet wurde.

Kanal- oder Gruppenregisterkarten , die auch als konfigurierbare Registerkarten bezeichnet werden, stellen Inhalte für Kanäle und Gruppenchats bereit und sind eine Möglichkeit, Bereiche für die Zusammenarbeit um dedizierte webbasierte Inhalte zu erstellen.

Die folgende Tabelle hilft Ihnen, die beste Eignung für Ihre App zu bestimmen:

  Personal Kanäle Gruppen-Chat Besprechungen
Statische Registerkarten ✔️ ✔️ ✔️ ✔️
Konfigurierbare Registerkarten ❌ ✔️ ✔️ ✔️

Hinweis

Wenn Sie sowohl eine konfigurierbare Registerkarte als auch eine statische Registerkarte in Ihrem App-Manifest für einen bestimmten Bereich definiert haben, heftet Teams die statische Registerkarte standardmäßig an.

Sie können eine Inhaltsseite als Teil einer persönlichen statischen Registerkarte, einer Kanal- oder Gruppenregisterkarte oder eines Dialogs (in TeamsJS v1.x als Aufgabenmodul bezeichnet) erstellen. Sie können eine Konfigurationsseite erstellen , auf der Benutzer die Microsoft Teams-App konfigurieren und diese zum Konfigurieren einer persönlichen Registerkarte, eines Kanals oder gruppenchats, einer Messagingerweiterung oder einer Connectorkarte für Microsoft 365-Gruppen verwenden können. Sie können Benutzern erlauben, Ihre Registerkarte nach der Installation neu zu konfigurieren und für Ihre Anwendung eine Seite zum Entfernen von Registerkarten zu erstellen. Wenn Sie eine Teams-App erstellen, die eine Registerkarte enthält, müssen Sie testen, wie Ihre Registerkarte auf den Android- und iOS Teams-Clients funktioniert. Ihre Registerkarte muss durch grundlegende Informationen, Gebietsschema- und Designinformationen sowie entityId oder subEntityIdKontext erhalten, der identifiziert, was sich in der Registerkarte befindet.

Hinweis

Beiträge und Dateien können nicht von ihren Positionen verschoben werden.

Registerkartenfeatures

Die Registerkartenfeatures sind wie folgt:

  • Wenn eine Registerkarte zu einer App hinzugefügt wird, die auch über einen Bot verfügt, wird der Bot ebenfalls zum Team hinzugefügt.
  • Kenntnis der Microsoft Entra-ID des aktuellen Benutzers.
  • Gebietsschemakenntnis für den Benutzer, um die Sprache anzugeben, die en-us ist.
  • SSO-Funktion (Single Sign-On), falls unterstützt.
  • Möglichkeit, Bots oder App-Benachrichtigungen zu verwenden, um einen Deep-Link zur Registerkarte oder zu einer untergeordneten Eigenschaft innerhalb des Diensts zu erstellen, z. B. einem einzelnen Arbeitselement.
  • Die Möglichkeit, ein modales Dialogfeld über Links innerhalb einer Registerkarte zu öffnen.
  • Wiederverwenden von SharePoint-Webparts innerhalb der Registerkarte.

Benutzerszenarien für Registerkarten

Scenario: Fügen Sie eine vorhandene webbasierte Ressource in Teams ein. Beispiel: Sie erstellen eine statische Registerkarte in Ihrer Teams-App, die Benutzern eine informationsbezogene Unternehmenswebsite darstellt.

Scenario: Fügen Sie einem Teams-Bot oder einer Messaging-Erweiterung Supportseiten hinzu. Beispiel: Sie erstellen statische Registerkarten, die Webseiteninhalte für Benutzer bereitstellen undihnen helfen .

Scenario: Bieten Sie Zugriff auf Elemente, mit denen Ihre Benutzer regelmäßig für kooperative Dialoge und Zusammenarbeit interagieren. Beispiel: Sie erstellen eine Kanal- oder Gruppenregisterkarte mit Deep Linking zu einzelnen Elementen.

Grundlegendes zur Funktionsweise von Registerkarten

Sie können eine der folgenden Methoden verwenden, um Registerkarten zu erstellen:

Benutzerdefinierte Registerkarte im App-Manifest deklarieren

Eine benutzerdefinierte Registerkarte wird im App-Manifest Ihres App-Pakets deklariert. Für jede Webseite, die Sie als Registerkarte in Ihrer App hinzufügen möchten, definieren Sie eine URL und einen Bereich. Darüber hinaus können Sie ihrer Seite die Teams JavaScript-Clientbibliothek hinzufügen und microsoftTeams.initialize() aufrufen, nachdem die Seite geladen wurde. Teams zeigt Ihre Seite an und bietet Zugriff auf Teams-spezifische Informationen, z. B. dass der Teams-Client das dunkle Design ausführt.

Unabhängig davon, ob Sie Ihre Registerkarte innerhalb des Kanals oder der Gruppe oder im persönlichen Bereich verfügbar machen möchten, müssen Sie eine <HTML-Inhaltsseite von iframe> auf Der Registerkarte präsentieren. Bei statischen Registerkarten wird die Inhalts-URL direkt in Ihrem Teams-App-Manifest durch die contentUrl -Eigenschaft im staticTabs Array festgelegt. Der Inhalt Ihrer Registerkarte ist für alle Benutzer identisch.

Hinweis

Teams-Apps können keine nativen Plug-Ins verwenden, da sie in IFrames mit Sandkasten ausgeführt werden.

Für Kanal- oder Gruppenregisterkarten können Sie auch eine zusätzliche Konfigurationsseite erstellen. Auf dieser Seite können Sie die URL der Inhaltsseite konfigurieren, in der Regel mithilfe von URL-Abfragezeichenfolgenparametern, um den entsprechenden Inhalt für diesen Kontext zu laden. Dies liegt daran, dass Ihre Kanal- oder Gruppenregisterkarte mehreren Teams oder Gruppenchats hinzugefügt werden kann. Bei jeder nachfolgenden Installation können Ihre Benutzer die Registerkarte konfigurieren, sodass Sie die Benutzeroberfläche nach Bedarf anpassen können. Wenn Benutzer eine Registerkarte hinzufügen oder konfigurieren, wird der Registerkarte, die auf der Benutzeroberfläche (User Interface, UI) von Teams angezeigt wird, eine URL zugeordnet. Das Konfigurieren einer Registerkarte fügt dieser URL einfach weitere Parameter hinzu. Wenn Sie beispielsweise die Registerkarte „Azure Boards“ hinzufügen, können Sie auf der Konfigurationsseite auswählen, welches Board die Registerkarte lädt. Die URL der Konfigurationsseite wird durch die configurationUrl -Eigenschaft im configurableTabs Array in Ihrem App-Manifest angegeben.

Bei statischen Registerkarten können Sie eine contentUrl an Chat-, Kanal- oder Besprechungsregisterkarten anheften. Auf diese Weise können Sie das obligatorische Konfigurationsdialogfeld überspringen und Ihre Benutzer dazu bringen, die App schneller zu verwenden. Sie können auch zur contentUrl Laufzeit ändern. Auf diese Weise können Sie ein Registerkartenobjekt erstellen, das in allen Oberflächenbereichen von Teams funktioniert. Weitere Informationen finden Sie unter Migrieren der konfigurierbaren Registerkarte zur statischen Registerkarte.

Sie können über mehrere Kanäle oder Gruppenregisterkarten und bis zu 16 statische Registerkarten pro App verfügen.

Tools zum Erstellen von Registerkarten

Nächster Schritt

Voraussetzungen

Siehe auch