Hinzufügen von Funktionen von Teams Toolkit v4 zur Microsoft Teams-App

  • Artikel

Wichtig

Wir haben die Erweiterung Teams Toolkit v5 in Visual Studio Code eingeführt. Diese Version wird mit vielen neuen App-Entwicklungsfeatures bereitgestellt. Es wird empfohlen, teams Toolkit v5 zum Erstellen Ihrer Teams-App zu verwenden. Die Teams Toolkit v4-Erweiterung wird bald veraltet sein. Dieser Artikel gilt nur für Teams Toolkit Version 4.

Durch das Hinzufügen von Funktionen mit dem Teams Toolkit können Sie die Funktionalität Ihrer vorhandenen Microsoft Teams-App erweitern. Der Vorteil des Hinzufügens weiterer Funktionen besteht darin, dass Sie Ihrer App weitere Funktionen hinzufügen können, indem Sie teams Toolkit verwenden, um automatisch erforderlichen Code und Projektdateien hinzuzufügen. Sie können verschiedene Funktionen basierend auf dem App-Projekt auswählen, das Sie für Ihre Teams-App erstellt haben. In der folgenden Tabelle sind die Funktionen der Teams-App aufgeführt:

Funktion Beschreibung Andere unterstützte Funktionen
Einfache Teams-App    
Tab Einfache Registerkarten sind einfache HTML-Tags, die auf im App-Manifest deklarierte Domänen verweisen. Sie können Registerkarten als Teil des Kanals innerhalb eines Team-, Gruppenchats oder einer persönlichen App für einen einzelnen Benutzer hinzufügen. Registerkarte "Basic", "Notification Bot", "Command Bot", "Basic Bot" und "Basic Message Extension"
Bot: Bots helfen bei der Interaktion mit Ihrem Webdienst über Text, interaktive Karten und Aufgabenmodule. Grundlegende Nachrichtenerweiterung, SSO-fähige Registerkarte und Registerkarte "Basic"
Nachrichtenerweiterung Nachrichtenerweiterungen helfen bei der Interaktion mit Ihrem Webdienst über Schaltflächen und Formulare im Microsoft Teams-Client. Basic-Bot, SSO-fähige Registerkarte und Registerkarte "Basic"
Szenariobasierte Teams-App    
Benachrichtigungsbot Der Benachrichtigungsbot sendet proaktiv Nachrichten im Teams-Kanal- oder Gruppenchat oder im persönlichen Chat. Sie können den Benachrichtigungsbot mit einer HTTP-Anforderung auslösen, z. B. Karten oder SMS. Registerkarte "SSO-fähig" und Registerkarte "Basic"
Befehlsbot Mit dem Befehlsbot können Sie sich wiederholende Aufgaben mithilfe eines Befehlsbots automatisieren. Es reagiert auf einfache Befehle, die in Chats mit den adaptiven Karten gesendet werden. Registerkarte "SSO-fähig" und Registerkarte "Basic"
Workflowbot Der Workflowbot ermöglicht Benutzern die Interaktion mit einer adaptiven Karte, die vom Aktionshandler für adaptive Karten in der Workflowbot-App aktiviert wird. Registerkarte "SSO-fähig" und Registerkarte "Basic"
Registerkarte "SPFx" Microsoft 365 hostet die SPFx-Registerkarten-Apps und unterstützt das Entwickeln und Hosten Ihrer clientseitigen SharePoint-Framework (SPFx)-Lösung. Keine
Registerkarte "SSO-enabled" (SSO-fähig) Sie können eine SSO-fähige Registerkarten-App erstellen, die dem Benutzer den Zugriff auf Ihre App mit einmaligem Anmelden (Single Sign-On, SSO) ermöglicht. SSO-fähige Registerkarte, Benachrichtigungsbot, Befehlsbot, grundlegender Bot und grundlegende Nachrichtenerweiterung

Hinweis

Sie können Registerkarten bis zu 16 Instanzen hinzufügen. Sie können jedem instance jeweils einen Bot und eine Nachrichtenerweiterung hinzufügen.

Fähigkeiten hinzufügen

Sie können Funktionen auf folgende Weise hinzufügen:

Bereich "Teams-Toolkit verwenden"

  1. Öffnen Sie Ihr App-Projekt in Visual Studio Code.

  2. Wählen Sie teams Toolkit in der Aktivitätsleiste von Visual Studio Code aus.

  3. Wählen Sie im Abschnitt ENTWICKLUNG die Option Features hinzufügen aus.

    Hinzufügen von Funktionen aus dem Teams-Toolkit

  4. Wählen Sie in der angezeigten Dropdownliste die Funktion aus, die Sie Ihrer App hinzufügen möchten.

    Benachrichtigung

    Teams Toolkit fügt Ihrer App die ausgewählte Funktion hinzu und aktualisiert die App-Verzeichnisstruktur für die neue Funktion. Nach dem erfolgreichen Hinzufügen der Funktion zu Ihrer Teams-App müssen Sie für jede Umgebung bereitstellen.

Verwenden der Befehlspalette

  1. Öffnen Sie Ihr App-Projekt in Visual Studio Code.

  2. Wählen Sie Befehlspalette anzeigen>... oder STRG+UMSCHALT+P aus.

    Hinzufügen von Funktionen aus der Befehlspalette

  3. Wählen Sie Teams: Features hinzufügen aus.

    So fügen Sie Funktionen mithilfe der Befehlspalette hinzu.

  4. Wählen Sie in der angezeigten Dropdownliste die Funktion aus, die Sie Ihrer App hinzufügen möchten.

    Benachrichtigung

    Teams Toolkit fügt Ihrer App die ausgewählte Funktion hinzu und aktualisiert die App-Verzeichnisstruktur für die neue Funktion. Nach dem erfolgreichen Hinzufügen der Funktion zu Ihrer Teams-App müssen Sie für jede Umgebung bereitstellen.

Verwenden der TeamsFx-CLI

Sie können teamsFx CLI als alternative Möglichkeit zum Hinzufügen von Funktionen zu Ihrem Teams-App-Projekt verwenden.

In diesem Abschnitt werden die Funktionen aufgeführt, die Sie Ihrer Teams-App mithilfe von TeamsFx CLI-Befehlen hinzufügen können. Bevor Sie Ihrer App Funktionen hinzufügen, stellen Sie sicher, dass Sie das Verzeichnis in Ihr Projektverzeichnis geändert haben.

In der folgenden Tabelle sind die Funktionen und die TeamsFx CLI-Befehle zum Hinzufügen aufgeführt:

Funktion und Szenario Get-Help
So fügen Sie einen Benachrichtigungsbot hinzu teamsfx add notification
So fügen Sie einen Befehlsbot hinzu teamsfx add command-and-response
So fügen Sie die Registerkarte "SSO-fähig" hinzu teamsfx add sso-tab
So fügen Sie die Registerkarte hinzu teamsfx add tab
So fügen Sie einen Bot hinzu teamsfx add bot
So fügen Sie eine Nachrichtenerweiterung hinzu teamsfx add message extension

Änderungen nach dem Hinzufügen von Funktionen

In der folgenden Tabelle sind die Änderungen aufgeführt, die Nach dem Hinzufügen von Funktionen in den Dateien Ihrer App angezeigt werden:

Funktion hinzufügen Beschreibung Änderungen
Einfacher Bot, grundlegende Nachrichtenerweiterung und Registerkarte "Basic" Schließt einen einfachen Bot oder eine einfache Registerkarten-App-Vorlage in Ihr Projekt ein. Teams Toolkit fügt einen Front-End-Bot- oder Registerkartenvorlagencode in einen Unterordner mit pfad yourProjectFolder\bot bzw yourProjectFolder\tab. hinzu.
Standardbot, Nachrichtenerweiterung und Registerkarte "Basic" Enthält die erforderlichen Skripts für Visual Studio Code und wird ausgeführt, wenn Sie Ihre App lokal debuggen möchten. Teams Toolkit aktualisiert die launch.json Dateien und task.json im .vscode Ordner.
Grundlegende Bot- und Basisnachrichtenerweiterung Updates die Manifestdatei für einen einfachen Bot oder eine einfache Registerkarten-App. Diese Informationen stellen Ihre App in der Teams-Plattform dar. Teams Toolkit aktualisiert die Datei manifest.template.json im templates\appPackage Ordner. Die Manifestdatei enthält Tabstoppinformationen, die Ihre App in der Teams-Plattform darstellen. Die Änderungen sind in der ID Ihres Bots, den Bereichen Ihres Bots und den Befehlen sichtbar, auf die Ihr Bot oder ihre Registerkarten-App reagieren kann.
Registerkarte "Basic" Enthält Informationen in der Manifestdatei für einen einfachen Bot oder eine Einfache Registerkarte. Diese Informationen stellen Ihre App in der Teams-Plattform dar. Teams Toolkit-Updates manifest.template.json im templates\appPackage Ordner. Die Manifestdatei enthält Tabstoppinformationen, die Ihre App in der Teams-Plattform darstellen. Die Änderungen sind in den konfigurierbaren und statischen Registerkarten und Bereichen der Registerkarten sichtbar.
Einfacher Bot, grundlegende Nachrichtenerweiterung und Registerkarte "Basic" Enthält Informationen in TeamsFx für einen einfachen Bot oder eine Registerkarten-App. Es enthält auch Bereitstellungsdateien, die für die Integration Azure Functions sind. Dateien unter templates\azure\teamsfx werden aktualisiert, und templates\azure\provision\xxx.bicep Dateien werden neu generiert.
Einfacher Bot, grundlegende Nachrichtenerweiterung und Registerkarte "Basic" Stellt sicher, dass Sie Ihr Projekt mit der richtigen Konfiguration für die neu hinzugefügte Funktion eingerichtet haben. Teams Toolkit generiert die Dateien unter .fx\configneu.

Schritt-für-Schritt-Anleitungen

Siehe auch