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.

Die folgende Abbildung zeigt statische Registerkarten:

Die folgende Abbildung zeigt die Contoso-Kanalregisterkarten:

Es gibt einige Voraussetzungen, die Sie erfüllen müssen, bevor Sie mit Registerkarten arbeiten.

In Teams stehen zwei Arten von Registerkarten zur Verfügung: "Persönlich" und "Gruppen". Persönliche Registerkarten werden auch als statische Registerkarten bezeichnet. 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 oder Besprechungen mit einer anpassbaren Oberfläche erweitern.

Sie können statische Registerkarten auf verschiedene Bereiche erweitern. Statische 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 vorab angeheftet werden.

Die folgende Abbildung zeigt statische Registerkarten mit anpassbaren Funktionen, die verschiedenen Kontexten in Teams hinzugefügt werden:

  • Die folgende Abbildung zeigt eine statische Registerkarte im persönlichen Kontext im Teams-Desktopclient:

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

  • Die folgende Abbildung zeigt eine statische Registerkarte im persönlichen Kontext im mobilen Teams-Client:

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

Im Folgenden sind einige Vorteile statischer Registerkarten in Chats und Besprechungsregisterkarten aufgeführt:

  • Anheftbar und sofort: Sie können Apps mit statischen Registerkarten über das Symbol "Registerkarte hinzufügen" + in Chats 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- und Besprechungsregisterkarten funktioniert.

  • Optionale Konfiguration: Sie können die Standard-URL in Ihrer Registerkarte instance ä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, die es Benutzern ermöglicht, die Microsoft Teams-App zu konfigurieren und sie zum Konfigurieren einer persönlichen Registerkarte, eines Kanals oder gruppenchats, einer Messagingerweiterung oder eines Connectors Karte für Microsoft 365-Gruppen zu verwenden. 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.
  • Bewusstsein für 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

Die Teams-App erkennt keine Unter-IFrames. Daher wird es nicht geladen, wenn ein IFrame in der Registerkarten-App vorhanden ist.

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.

Für statische Registerkarten können Sie eine contentUrl an Chat- oder Besprechungsregisterkarten anheften. Auf diese Weise können Sie das obligatorische Konfigurationsdialogfeld überspringen und Ihre Benutzer dazu bringen, die App viel 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