Registerkarten für Microsoft Teams erstellen

Registerkarten sind Teams-fähige Webseiten, die in Microsoft Teams 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 JavaScript-Client-SDK für Teams.

Wichtig

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

Es wird empfohlen, das Teams-Client-SDK über npm-Paket zu verwenden und es mit Ihrer App zu bündeln, da derzeit Teams Client-SDK in Government Cloud CDN nicht verfügbar ist.

Die folgende Abbildung zeigt persönliche Registerkarten:

Registerkarte „Persönlich“

Die folgende Abbildung zeigt die Contoso-Kanalregisterkarten:

Kanal- oder Gruppenregisterkarten

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

Es gibt zwei Arten von Registerkarten in Teams: persönliche und Kanal oder Gruppe. Persönliche Registerkarten sind zusammen mit auf eine Person bezogene Bots Bestandteile persönlicher Apps und auf einen einzelnen Benutzer beschränkt. Sie können für den einfachen Zugriff an die linke Navigationsleiste angeheftet werden. Kanal-- oder Gruppenregisterkarten übermitteln Inhalte an Kanäle und Gruppenchats und sind eine hervorragende Möglichkeit zum Erstellen von Bereichen für die Zusammenarbeit rund um dedizierte webbasierte Inhalte.

Sie können als Teil einer persönlichen Registerkarte, einer Kanal- oder Gruppenregisterkarte oder eines Aufgabenmoduls eine Inhaltsseite erstellen. Sie können eine Konfigurationsseite erstellen, die es den Benutzern ermöglicht, die Microsoft Teams-App zu konfigurieren und sie zur Konfiguration eines Kanals oder einer Gruppenchat-Registerkarte, einer Nachrichtenerweiterung oder eines Office 365-Connectors 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 subEntityId Kontext erhalten, der identifiziert, was sich in der Registerkarte befindet.

Sie können Registerkarten mit adaptiven Karten erstellen und alle Teams-App-Funktionen zentralisieren, indem Sie die Notwendigkeit für ein anderes Back-End für Ihre Bots und Registerkarten eliminieren. Bühnenansicht ist eine neue Benutzeroberflächenkomponente, die es Ihnen ermöglicht, den in Teams im Vollbildmodus geöffneten und als Registerkarte angehefteten Inhalt zu rendern. Der bestehende Dienst zum Aufklappen von Verknüpfungen wird aktualisiert, sodass URLs mithilfe einer adaptiven Karte und Chatdiensten in eine Registerkarte umgewandelt werden können. Sie können Unterhaltungsregisterkarten erstellen indem Sie Unterentitäten von Unterhaltungen verwenden, mit denen Benutzer Unterhaltungen über Unterentitäten auf Ihrer Registerkarte führen können, z. B. über bestimmte Aufgaben, Patienten und Verkaufschancen, anstatt die gesamte Registerkarte zu diskutieren. Sie können Änderungen an Registerkartenrändern vornehmen, um die Erfahrung des Entwicklers beim Erstellen von Apps zu verbessern. Sie können die Registerkarte ziehen und an der gewünschten Position platzieren, um die Registerkartenpositionen in Ihren persönlichen Apps und in Kanal- oder Gruppenchats auszutauschen.

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 Azure Active Directory-ID (Azure AD) 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 zum Verwenden von Bots oder App-Benachrichtigungen zum Deep-Link zur Registerkarte oder zu einer Unterentität innerhalb des Diensts, z. B. zu einem einzelnen Arbeitselement.
  • Die Möglichkeit, ein Aufgabenmodul ü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 persönliche Registerkarte in Ihrer Teams-App, die Benutzern eine informative Unternehmenswebsite anzeigt.

Szenario: Hinzufügen von Supportseiten zu einem Teams-Bot oder einer Nachrichtenerweiterung.
Beispiel: Sie erstellen persönliche Registerkarten, die Webseiteninhalte für Info und Hilfe für Benutzer bereitstellen.

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 die JavaScript-Client-SDK von Teams zu Ihrer Seite hinzufügen und microsoftTeams.initialize() nach dem Laden Ihrer Seite aufrufen. 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, der Gruppe oder des persönlichen Bereichs verfügbar machen möchten, müssen Sie eine <iframe>HTML-Inhaltsseite auf Ihrer Registerkarte präsentieren. Bei persönlichen Registerkarten wird die Inhalts-URL direkt in Ihrem Teams-App-Manifest durch die contentUrl-Eigenschaft in der staticTabs-Matrix festgelegt. Der Inhalt Ihrer Registerkarten ist für alle Benutzer gleich.

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 zusätzliche Parameter bei. 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 von der configurationUrl-Eigenschaft in der configurableTabs-Matrix in Ihrem App-Manifest angegeben.

Sie können mehrere Kanäle oder Gruppenregisterkarten und bis zu 16 persönliche Registerkarten pro App haben.

Tools zum Erstellen von Registerkarten

Nächster Schritt

Siehe auch