Hallo Welt mit Node.js - Teams

Starten Sie die Entwicklung von Microsoft Teams-Apps, indem Sie Ihre erste App mit einer Registerkarte, einem Bot und einer Nachrichtenerweiterungsfunktion erstellen.

Diese App verfügt über alle Funktionen und jede verfügt über eine eigene Benutzeroberfläche und Benutzeroberfläche:

Screenshot des Diagramms, das zeigt, dass diese App drei Features enthält.

In diesem Tutorial erfahren Sie Folgendes:

Einrichten eines neuen Projekts mithilfe von Befehlszeilentools
Hier erfahren Sie, wie Sie drei Apps mit jeweils unterschiedlichen Funktionen erstellen: Registerkarte, Bot und Nachrichtenerweiterung.
Hier erfahren Sie, wie Sie Ihre App über das Entwicklerportal bereitstellen.

Voraussetzungen

4 Minuten verbleibend

Hier finden Sie eine Liste der Tools, die Sie zum Erstellen und Bereitstellen einer Teams-App installieren müssen.

	Installieren	Zum Benutzen...
Required
	Node.js und NPM	Back-End-JavaScript-Laufzeitumgebung. Weitere Informationen finden Sie unter Node.js Versionskompatibilitätstabelle für den Projekttyp.
	ngrok	Teams-App-Features (Konversationsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Dies ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mit npm `devDependencies`).
	Microsoft Edge (empfohlen) oder Google Chrome	Ein Browser mit Entwicklertools.
	Visual Studio Code	Build-Umgebungen für JavaScript, TypeScript oder SharePoint Framework (SPFx). Verwenden Sie Version 1.55 oder höher.
	Git	Git, um das Beispiel-Node.js-App-Repository von GitHub zu verwenden.
	Schluck	Open-Source-JavaScript-Toolkit. Installieren Sie Version 4.0.0 oder höher.
	Microsoft Teams	Microsoft Teams für die Zusammenarbeit mit allen, mit denen Sie arbeiten, über Apps für Chats, Besprechungen und Anrufe an einem Ort.
Optional
	Azure-Tools für Visual Studio Code und Microsoft Azure CLI	Azure-Tools für den Zugriff auf gespeicherte Daten oder die Bereitstellung eines cloudbasierten Back-Ends für Ihre Teams-App in Azure.
	React Developer Tools für Chrome ODER React Developer Tools für Microsoft Edge	Browsertools für die Entwicklung von Registerkarten mit JavaScript.
	Microsoft Graph-Tester	Microsoft Graph Explorer, ein browserbasiertes Tool, mit dem Sie eine Abfrage aus Microsoft Graph-Daten ausführen können.
	Entwicklerportal für Teams	Webbasiertes Portal zum Konfigurieren, Verwalten und Veröffentlichen Ihrer Teams-App, einschließlich in Ihrem organization oder im Microsoft Teams Store.
	Visual Studio Code-Erweiterungen
	Azure Functions Core Tools	Back-End-Komponenten während einer lokalen Debugausführung, einschließlich der Authentifizierungshilfsprogramme, die beim Ausführen Ihrer Dienste in Azure erforderlich sind. Es wird im Projektverzeichnis installiert (mit npm `devDependencies`).
	.NET SDK	Angepasste Bindungen für lokales Debuggen und Azure Functions App-Bereitstellungen. Wenn Sie das .NET 3.1-SDK (oder höher) nicht global installiert haben, kann die portable Version installiert werden.

Überprüfen der Versionsnummern für installierte Tools

Verwenden Sie die folgenden Befehle, um zu überprüfen, ob die installierten Versionen für die Tools nach Bedarf installiert sind.

Hinweis

Verwenden Sie das Terminalfenster, mit dem Sie auf Ihrer Plattform am besten vertraut sind. Diese Beispiele verwenden Git Bash (das in der Git-Installation enthalten ist), aber diese Skripts können auf den meisten Plattformen ausgeführt werden.

So überprüfen Sie die Versionsnummern der installierten Tools:

Öffnen Sie ein Terminalfenster.
Führen Sie den folgenden Befehl aus, um die git auf Ihrem Computer installierte Version zu überprüfen:
```
$ git --version
```
Ausgabebeispiel: git version 2.19.0.windows.1
Führen Sie den folgenden Befehl aus, um die node.js Version zu überprüfen:
```
$ node -v
```
Ausgabebeispiel: v8.9.3
Überprüfen Sie die Versionsnummer von npm:
```
$ npm -v
```
Ausgabebeispiel: 5.5.1
Überprüfen Sie die Versionsnummer von gulp:
```
$ gulp -v
```
Ausgabebeispiel: CLI version 2.3.0

Local version 4.0.2
Führen Sie den folgenden Befehl aus, um die Versionsnummer von Visual Studio Code zu überprüfen:
```
code --version
```
Ausgabebeispiel: 1.28.2

929bacba01ef658b873545e26034d1a8067445e9

Sie können problemlos eine andere Version dieser Anwendungen verwenden.

Einrichten Ihres Teams-Entwicklungsmandanten

Ein Mandant ist wie ein Raum oder ein Container für Ihre organization in Teams, in dem Sie chatten, Dateien freigeben und Besprechungen ausführen. In diesem Bereich laden Sie auch Ihre benutzerdefinierte App hoch und testen sie.

Lassen Sie uns überprüfen, ob Sie bereit sind, mit dem Mandanten zu entwickeln.

Option zum Hochladen benutzerdefinierter Apps aktivieren

Nachdem Sie die App erstellt haben, müssen Sie ihre App in Teams laden, ohne sie zu verteilen. Dieser Vorgang wird als benutzerdefinierter App-Upload bezeichnet. Melden Sie sich bei Ihrem Microsoft 365-Konto an, um diese Option anzuzeigen.

Hinweis

Ein benutzerdefinierter App-Upload ist für die Vorschau und das Testen von Apps in der lokalen Teams-Umgebung erforderlich. Wenn sie nicht aktiviert ist, können Sie Ihre App in Teams nicht lokal in der Vorschau anzeigen und testen.

Verfügen Sie bereits über einen Mandanten und über Administratorzugriff? Lassen Sie uns überprüfen, ob Sie dies wirklich tun!

Überprüfen Sie, ob Sie eine benutzerdefinierte App in Teams hochladen können:

Wählen Sie im Teams-Client das Symbol Store aus.
Wählen Sie Verwalten Ihrer Apps aus.
Suchen Sie nach der Option Hochladen einer benutzerdefinierten App. Wenn die Option angezeigt wird, ist der benutzerdefinierte App-Upload aktiviert.

Hinweis

Wenn Teams die Option zum Hochladen einer benutzerdefinierten App nicht zeigt, wenden Sie sich an Ihren Teams-Administrator.

Erstellen eines kostenlosen Teams-Entwicklermandanten

Wenn Sie nicht über ein Teams-Entwicklerkonto verfügen, können Sie es kostenlos erhalten. Nehmen Sie am Microsoft 365-Entwicklerprogramm teil!

Gehen Sie zu Microsoft 365-Entwicklerprogramm.
Wählen Sie Jetzt beitreten aus, und folgen Sie den Anweisungen auf dem Bildschirm.
Wählen Sie auf der Willkommensseite E5-Abonnement einrichten aus.
Einrichten Ihres Administratorkontos. Nachdem Sie fertig sind, wird der folgende Bildschirm angezeigt.
Melden Sie sich bei Teams mit dem Administratorkonto an, das Sie gerade eingerichtet haben. Vergewissern Sie sich, dass Sie über die Option Benutzerdefinierte App hochladen in Teams verfügen.

Abrufen eines kostenlosen Azure-Kontos

Wenn Sie Ihre App hosten oder auf Ressourcen in Azure zugreifen möchten, benötigen Sie ein Azure-Abonnement. Erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Jetzt verfügen Sie über alle Tools und richten Ihre Konten ein. Richten Sie als Nächstes Ihre Entwicklungsumgebung ein, und beginnen Sie mit dem Erstellen!

Sie können dieses Terminalfenster weiterhin verwenden, um die folgenden Befehle in diesem Tutorial auszuführen.

Herunterladen des Beispiels

Verwenden Sie für dieses Tutorial das Hello World!-Beispiel, um zu beginnen. Sie können es von GitHub herunterladen und klonen.

So klonen Sie das Beispielrepository mithilfe von Git Bash

Öffnen Sie ein Terminalfenster.
Führen Sie den folgenden Befehl aus, um das Beispielrepository auf Ihrem Computer zu klonen:
```
git clone https://github.com/OfficeDev/Microsoft-Teams-Samples.git
```

Tipp

Sie können dieses Repository forken, wenn Sie Ihre Änderungen an Ihrem GitHub-Repository zur späteren Referenz ändern und einchecken möchten.

Erstellen Ihrer ersten Node.js-App

3 Minuten verbleibend

Nachdem Sie das Repository für Node.js Beispiel-App geklont haben, können Sie die App in Ihrer lokalen Umgebung erstellen und testen.

Auf dieser Seite erfahren Sie Folgendes:

Erstellen und Ausführen Ihrer ersten App
Testen Ihrer Beispiel-App

Erstellen und Ausführen des Beispiels

Nachdem das Repository geklont wurde, können Sie die Beispiel-App erstellen.

Öffnen Sie ein Terminalfenster.
Führen Sie den Befehl verzeichnis ändern im Terminal aus, um in das Beispielverzeichnis der App zu wechseln:
```
cd Microsoft-Teams-Samples/samples/app-hello-world/nodejs/
```
Installieren Sie alle Abhängigkeiten mit dem folgenden Befehl:
```
npm install
```
Es sollte eine Reihe von Abhängigkeiten installiert werden.
Führen Sie die App mit dem folgenden Befehl aus, nachdem die Installation abgeschlossen ist:
```
npm start
```
Wenn die Hallo Welt-App gestartet wird, wird sie im Terminalfenster angezeigtApp started listening on port 3333.

Hinweis

Wenn in der obigen Meldung eine andere Portnummer angezeigt wird, liegt dies daran, dass Sie eine PORT-Umgebungsvariable festgelegt haben. Sie können diesen Port weiterhin verwenden oder Ihre Umgebungsvariable in 3333 ändern.
Öffnen Sie ein Browserfenster, und verwenden Sie die folgenden URLs, um zu überprüfen, ob alle Hallo Welt App-URLs geladen werden:
- http://localhost:3333
- http://localhost:3333/hello
- http://localhost:3333/first
- http://localhost:3333/second

Testen Ihrer Beispiel-App in einer lokalen Umgebung

Denken Sie daran, dass Apps in Microsoft Teams Webanwendungen sind, die eine oder mehrere Funktionen verfügbar macht. Stellen Sie Ihre App im Internet zur Verfügung, damit sie von der Teams-Plattform geladen werden kann. Damit Ihre App über das Internet erreichbar ist, müssen Sie Ihre App hosten .

Für lokale Tests können Sie die App auf Ihrem lokalen Computer ausführen und einen Tunnel mit einem Webendpunkt erstellen. ngrok ist ein kostenloses Tool, mit dem Sie genau das tun können. Mit ngrok können Sie eine Webadresse wie https://d0ac14a5.ngrok.io abrufen (diese URL ist nur ein Beispiel). Sie können ngrok für Ihre Umgebung herunterladen und installieren. Stellen Sie sicher, dass Sie sie einem Speicherort im PATHhinzufügen.

Erstellen eines ngrok-Tunnels

Nach der Installation von ngrok können Sie einen Tunnel erstellen, um Ihre App lokal bereitzustellen.

Öffnen Sie ein neues Terminalfenster.
Führen Sie den folgenden Befehl aus, um einen Tunnel zu erstellen. Die Beispiel-App verwendet Port 3333:
```
ngrok http 3333 --host-header=localhost:3333
```
Ein ngrok-Tunnel wird erstellt. Hier sehen Sie ein Beispiel für einen ngrok-Tunnel.

Ngrok lauscht auf Anforderungen aus dem Internet und leitet sie an Ihre App weiter, die an Port 3333 ausgeführt wird.

So überprüfen Sie die lokale Bereitstellung der App:

Öffnen Sie den Browser.
Laden Sie Ihre App über die folgende URL:

https://<forwarding address in ngrok console session>/

Hier sehen Sie ein Beispiel für die URL:

Sie können versuchen, , firstoder second zur ngrok-Tunnel-URL hinzuzufügenhello, um verschiedene Registerkartenseiten der App anzuzeigen.

Ngrok lauscht auf Anforderungen aus dem Internet und leitet sie an Ihre App weiter, die an Port 3333 ausgeführt wird.
Notieren Sie sich die Weiterleitungsadresse in der ngrok-Konsole. Sie benötigen diese URL, um Ihre App in Teams bereitzustellen.

Hinweis

Wenn Sie beim Erstellen und Ausführen einen anderen Port verwendet haben, stellen Sie sicher, dass Sie dieselbe Portnummer verwenden, um den ngrok-Tunnel einzurichten.

Tipp

Es ist eine gute Idee, ngrok in einem anderen Terminalfenster auszuführen, um die Ausführung ohne Beeinträchtigung der Knoten-App aufrechtzuerhalten, die Sie später möglicherweise beenden, neu erstellen und erneut ausführen müssen. Die ngrok-Sitzung gibt nützliche Debuginformationen in diesem Fenster zurück. Die kostenpflichtige Version von ngrok lässt persistente Namen zu.

Wichtig

Wenn Sie die kostenlose Version von ngrok verwenden, ist Ihre App nur während der aktuellen Sitzung auf Ihrem Entwicklungscomputer verfügbar. Es ist nicht verfügbar, wenn der Computer heruntergefahren wird oder in den Standbymodus wechselt. Wenn Sie den Dienst neu starten, wird eine neue Adresse zurückgegeben. Anschließend müssen Sie jeden Speicherort aktualisieren, der die veraltete Adresse verwendet. Denken Sie an diesen Schritt, wenn Sie die App zu Testzwecken freigeben.

Erstellen Node.js App-Pakets

Sie können verwenden gulp CLI , um das App-Paket für Node.js zu erstellen.

Öffnen Sie ein Terminalfenster.
Stellen Sie sicher, dass Sie sich in dem Verzeichnis befinden, in dem geklont node.js ist. Dies ist der Ordner, in dem gulpfile.js platziert wird.
Führen Sie den folgenden Befehl aus, um das Node.js App-Paket zu erstellen.

$ gulp

Hier sehen Sie ein Beispiel für die Befehlsausgabe:

[13:39:27] Using gulpfile ~\documents\github\msteams-samples-hello-world-nodejs\gulpfile.js

[13:39:27] Starting 'clean'...

[13:39:27] Starting generate-manifest'...

[13:39:27] Finished 'generate-manifest' after 11 ms

[13:39:27] Finished 'clean after 21 ms

[13:39:27] Starting 'default'... Build completed. Output in manifest folder

[13:39:27] Finished 'default' after 62 μs

Das App-Paket helloworldapp.zip wird erstellt. Sie finden die Paketdatei im folgenden Pfad.

<path to the cloned repo>/Microsoft-Teams-Samples/samples/app-hello-world/nodejs/manifest

Hinweis

Suchen Sie nach der App-Paketdatei, helloworldapp.zip, wenn der Speicherort im verwendeten Tool nicht klar ist.

Konfigurieren Ihrer ersten Node.js-App mithilfe des Entwicklerportals

2 Minuten verbleibend

Sie können das Entwicklerportal verwenden, um das App-Paket in Teams hochzuladen und App-Funktionen zu konfigurieren. Entwicklerportal ist eine Teams-App, die die Erstellung und Registrierung einer App vereinfacht. Installieren Sie aus dem Teams Store!

Nachdem Sie Ihre Teams-App erstellt und getestet haben, können Sie sie mithilfe des Entwicklerportals konfigurieren und in der Vorschau anzeigen.

Das Aktualisieren des App-Pakets umfasst Folgendes:

Importieren des App-Pakets in das Entwicklerportal
Konfigurieren von App-Funktionen

Importieren des App-Pakets in das Entwicklerportal

So importieren Sie das App-Paket:

Öffnen Sie Microsoft Teams.
Wählen Sie in der linken Leiste das Symbol Store aus.
Suchen Sie in der Suchleiste nach Entwicklerportal , und wählen Sie Entwicklerportal* aus.
Klicken Sie auf Öffnen.

Das Entwicklerportal wird geöffnet.
Wählen Sie die Registerkarte Apps aus.
Wählen Sie App importieren aus.
Öffnen Sie das App-Paket helloworldapp.zip aus dem folgenden Pfad in der Verzeichnisstruktur Ihres C#-Beispielrepositorys:

<path to cloned node.js sample repo>\Source\Repos\Microsoft-Teams-Samples\samples\app-hello-world\nodejs\manifest

Die Hallo Welt-App wird in das Entwicklerportal importiert.

Nachdem Sie Ihre App in das Entwicklerportal importiert haben, können Sie die Details im Entwicklerportal anzeigen.

Machen Sie eine Tour durch Ihre App im Entwicklerportal

Nachdem Sie Ihre App in das Entwicklerportal importiert haben, können Sie die Details anzeigen, einschließlich der Manifestdatei.

Anzeigen von App-Informationen

Wählen Sie im linken Bereich des Entwicklerportals grundlegende Informationen aus.
Beachten Sie die folgenden Informationen aus den grundlegenden Informationen:
- App-ID
- Entwicklerinformationen
- App-URLs
Wählen Sie im linken Bereich Branding aus, um die Brandinginformationen anzuzeigen.

Diese Details sind wichtig, wenn Sie eine neue App für die Verteilung schreiben.

Anzeigen von App-Features

Wählen Sie im linken Bereich des Entwicklerportals App-Features aus.

Die App-Features werden im rechten Bereich angezeigt. Sie können Karten für die persönliche App, den Bot und die Nachrichtenerweiterung anzeigen.

Anzeigen des App-Manifests

Sie verwenden die Manifestdatei, um Funktionen, erforderliche Ressourcen und andere wichtige Attribute für Ihre App zu konfigurieren.

Wählen Sie im linken Bereich Veröffentlichen aus, um die Dropdownliste zu öffnen, und wählen Sie dann App-Paket aus.

Das App-Manifest wird im rechten Bereich angezeigt.

Die Manifestdatei wird im rechten Bereich angezeigt.

Konfigurieren der Funktionen Ihrer App

Nachdem Sie Ihre App in das Entwicklerportal importiert haben, besteht der nächste Schritt darin, App-Funktionen zu konfigurieren. Das Entwicklerportal enthält alle App-Informationen in verschiedenen Abschnitten. Dies erleichtert die Konfiguration der App-Funktionen.

Mit dem Entwicklerportal haben Sie folgende Möglichkeiten:

Konfigurieren Einer persönlichen Registerkarten-App.
Konfigurieren des Bots.
Konfigurieren sie die Nachrichtenerweiterung.

Konfigurieren einer persönlichen Registerkarten-App

So konfigurieren Sie die persönliche Registerkarten-App:

Wählen Sie im Bereich App-Features das Symbol im Karte Persönliche App aus, und wählen Sie Bearbeiten aus.

Die Details für Hello Registerkarte werden angezeigt.
Wählen Sie das Symbol für Hello Registerkarte und dann Bearbeiten aus, um die App-Details für die Aktualisierung zu öffnen.
Geben Sie die App-Details für die Registerkarte Hello unter Hinzufügen einer Registerkarte zu Ihrer persönlichen App ein.

Geben Sie die folgenden Details ein:
- Name: Hello Registerkarte.
- Inhalts-URL und Website-URL: Die Weiterleitungsadresse in der ngrok-Konsolensitzung.
- Kontext: Wählen Sie die Registerkarte Persönlich aus.
Wählen Sie Aktualisieren aus.

Die Details der Registerkarte Hello werden im Bereich Persönliche App angezeigt.
Klicken Sie auf Speichern.

Im Bereich Persönliche App werden jetzt die neue Registerkarte und die Registerkarte Info automatisch erstellt.

Konfigurieren des Bots

Es ist einfach, die Botfunktionen zu Ihrer App hinzuzufügen. Die Hallo Welt Beispiel-App verfügt bereits über einen Bot als Teil des Beispiels, aber Sie müssen ihn bei Teams registrieren.

Screenshot des Bilds, in dem die Bot-App ohne App-ID importiert wurde.

Der Bot, der aus dem Beispiel importiert wurde, verfügt nicht über eine zugeordnete App-ID. Sie müssen ihn löschen und einen neuen Bot erstellen. Das Entwicklerportal erstellt eine neue App-ID und registriert sie bei Teams.

Das Hinzufügen und Konfigurieren eines Bots umfasst Folgendes:

Hinzufügen eines neuen Bots.
Hinzufügen eines Bots zur App.
Konfigurieren des Botbereichs.

So fügen Sie einen neuen Bot hinzu

Wählen Sie im Bereich App-Features das Symbol im Bot-Karte aus, und wählen Sie Löschen aus.
Wählen Sie Tools aus, um funktion hinzuzufügen.
Wählen Sie im Bereich Tools die Option Botverwaltung aus.
Wählen Sie im Bereich Botverwaltungdie Option + Neuer Bot aus.
Geben Sie einen geeigneten Namen für Ihren Bot ein, und wählen Sie Hinzufügen aus.

Der Bereich Konfigurieren wird mit Details des neuen Bots im linken Bereich angezeigt.
Geben Sie die Weiterleitungs-URL aus der ngrok Konsole ein, und wählen Sie Speichern aus.
Wählen Sie Geheime Clientschlüssel und dann Geheime Clientschlüssel hinzufügen aus , um ein Kennwort für den Bot zu generieren.

Das Entwicklerportal generiert ein Kennwort für den Bot.

Sie können das Symbol verwenden, um das Kennwort zu kopieren. Für dieses Tutorial müssen Sie es nicht kopieren.
Wählen Sie OK aus.
Wählen Sie Bots aus<, um zum Bereich Botverwaltung zurückzukehren.

Im Bereich Botverwaltung wird der neue Bot angezeigt, der mit einer App-ID hinzugefügt wurde.
Stellen Sie sicher, dass Sie die Bot-ID zusammen mit dem Kennwort aus dem Abschnitt Geheimer Clientschlüssel speichern.

So fügen Sie einen Bot zur App hinzu

Öffnen Sie den Bereich App-Features, und wählen Sie den Bot-Karte aus.

Der Bereich Bot wird angezeigt.
Wählen Sie Unter Vorhandenen Bot auswählen Ihre Bot-App und dann Speichern aus.

Der neue Bot wird Ihrer App mit einer eigenen App-ID hinzugefügt.

So konfigurieren Sie den Botbereich

Wählen Sie das Symbol im neuen Bot-Karte und dann Bearbeiten aus.
Wählen Sie auf der Seite Bot alle drei Bereiche für den Befehl aus.
Navigieren Sie durch den Botbereich , um den Abschnitt Befehle anzuzeigen, und wählen Sie + Befehl hinzufügen aus.
Geben Sie einen geeigneten Namen und eine Beschreibung ein, wählen Sie alle drei Bereiche für den Befehl aus, und wählen Sie Hinzufügen aus.
- Privat
- Team
- Gruppenchat
Der neue Befehl wird dem Abschnitt Befehle des Botbereichs hinzugefügt.
Klicken Sie auf Speichern.

Die Befehlsdetails werden gespeichert.
Öffnen Sie den Bereich App-Features, und wählen Sie Persönliche App Karte aus, um die Registerkartendetails Ihrer App anzuzeigen.

Sie sehen, dass Ihrer App eine Registerkarte für Ihren neuen Chatbot hinzugefügt wird.

Konfigurieren der Nachrichtenerweiterung

Mit Nachrichtenerweiterungen können Benutzer Informationen von Ihrem Dienst anfordern und diese Informationen veröffentlichen. Die Informationen werden in Form von Karten in die Kanalunterhaltung eingesendet. Nachrichtenerweiterungen werden am unteren Rand des Verfassenfelds angezeigt.

So fügen Sie eine neue Nachrichtenerweiterung hinzu:

Wählen Sie im Bereich App-Features das Symbol im Karte Nachrichtenerweiterung aus, und wählen Sie Löschen aus.
Wählen Sie im Bereich App-Features die Option Nachrichtenerweiterung aus.
Wählen Sie den Namen Ihrer Bot-App aus der Dropdownliste Vorhandenen Bot auswählen im Bereich Nachrichtenerweiterung aus.
Klicken Sie auf Speichern.

Die Nachrichtenerweiterung wird gespeichert, und der Abschnitt Befehle wird im Bereich Nachrichtenerweiterung angezeigt.
Wählen Sie + Befehl hinzufügen aus, um den Bereich zu definieren, den Ihre Nachrichtenerweiterungs-App ausführen kann.

Das Dialogfeld Befehl hinzufügen .
Stellen Sie sicher, dass Suchen als Befehlstyp ausgewählt ist, den Sie im Dialogfeld Befehl hinzufügen hinzufügen möchten.
Geben Sie geeignete Informationen für die folgenden Details ein:
- Befehls-ID
- Befehlstitel
- Befehlsbeschreibung
Navigieren Sie durch das Dialogfeld, um die restlichen Details anzuzeigen.
Stellen Sie sicher , dass Als Standard festlegen ausgewählt ist.
Wählen Sie die folgenden Kontexte für den Nachrichtenerweiterungsbefehl aus:
- Befehlsfeld
- Compose Box
- Nachricht
Geben Sie geeignete Informationen für die folgenden Details ein:
- Parametername
- Parametertitel
- Parameterbeschreibung
Wählen Sie Text als Eingabetyp aus.
Klicken Sie auf Speichern.
Der Nachrichtenerweiterungsbefehl wird gespeichert und in der Liste der Befehle im Bereich Nachrichtenerweiterung angezeigt.
Klicken Sie auf Speichern.
Öffnen Sie den Bereich App-Features .

Sie sehen alle drei Funktionen – persönliche Registerkarten-App, Bot und Nachrichtenerweiterung –, die für die Hallo Welt-App konfiguriert sind.

Vorschau und Testen Ihrer Node.js-App

100 % abgeschlossen!

Nachdem Sie Ihre App importiert und die Funktionen im Entwicklerportal konfiguriert haben, können Sie eine Vorschau der Beispiel-App anzeigen und testen.

Hinweis

Externe Entwickler können die Option Vorschau in Teams in der Entwicklerportal-App in Teams nicht verwenden. Es ist aufgrund einer API-Einschränkung nicht als App in Teams verfügbar. Wenn Sie eine Vorschau Ihrer App in Teams anzeigen möchten, verwenden Sie die Website des Entwicklerportals .

Nachdem Sie die Funktionen Ihrer App konfiguriert haben, können Sie eine Vorschau Ihrer App in Teams in der lokalen Umgebung anzeigen und testen.

So zeigen Sie eine Vorschau Ihrer App an:

Wählen Sie auf der Symbolleiste des Entwicklerportals die Option Vorschau in Teams aus.

Das Entwicklerportal informiert Sie darüber, dass Ihre benutzerdefinierte App erfolgreich hochgeladen wurde.
Wählen Sie Verwalten Ihrer Apps aus. Ihre App ist in den hochgeladenen Apps aufgeführt.
Suchen Sie Ihre App mithilfe des Suchfelds, und wählen Sie die drei Punkte in der Zeile aus.
Wählen Sie die Option Ansicht aus. Die Seite Hinzufügen wird für Ihre App angezeigt.
Wählen Sie Hinzufügen aus, um die App in Teams zu laden.

Ihre App ist jetzt in Teams verfügbar. Sie können alle Registerkarten anzeigen und die Funktionen testen:
- registerkarte Hello:
- Chatbot:
  
  Sie können eine Nachricht über den Chat senden.
- Nachrichtenerweiterung:
  
  Sie können eine Suche mithilfe der Nachrichtenerweiterung versuchen.
- Registerkarte "Info":