Erstellen von Teams-Connectors - Teams

Der Microsoft Teams-Connector ist eine MVC-Beispielaufgabenverwaltungsanwendung (Model-View-Controller), die mithilfe der ASP.NET Webanwendungsvorlage generiert wird. Der Großteil des Codes bezieht sich entweder auf die grundlegende MVC-Konfiguration oder das Aufgabenverwaltungssystem. Sie können Ihren vorhandenen Office 365 Connector hinzufügen oder einen neuen in Teams erstellen.

Arten von Connectorcodes

ConnectorController.cs: Einrichten und Speichern von Aktionen.
TaskController.cs: Erstellen und Aktualisieren von Aktionen.

Wichtige Features des Microsoft Teams-Connectors

Simuliert das reale Aufgabenverwaltungssystem.
Ermöglicht Benutzern das Erstellen und Anzeigen von Aufgaben.
Generiert Inhalte nach dem Zufallsprinzip.
Simuliert die Benachrichtigung, die an den Microsoft Teams-Kanal gesendet werden soll.

Diese schrittweise Anleitung hilft Ihnen beim Erstellen und Testen eines Connectors in Microsoft Teams. Die folgende Ausgabe wird angezeigt:

Einführungsbild

Voraussetzungen

10 Minuten verbleibend

Stellen Sie sicher, dass Sie die folgenden Tools installieren und Ihre Entwicklungsumgebung einrichten:

	Installieren	Zum Benutzen...
Required
	Microsoft Teams	Microsoft Teams für die Zusammenarbeit mit allen Personen, mit denen Sie zusammenarbeiten, über Apps für Chats, Besprechungen, Anrufe und alle an einem Ort.
	Visual Studio 2022, Version 17.3 Installieren Sie einen der folgenden beiden Workloads: • ASP.NET und Webentwicklung • Plattformübergreifende .NET Core-Entwicklung	Sie können die Enterprise-Version in Visual Studio 2022 und die Workloads installieren.
	ngrok	Teams-App-Features (Unterhaltungsbots, Nachrichtenerweiterungen und eingehende Webhooks) erfordern eingehende Verbindungen. Ein Tunnel verbindet Ihr Entwicklungssystem mit Teams. Sie ist nicht für Apps erforderlich, die nur Registerkarten enthalten. Dieses Paket wird im Projektverzeichnis installiert (mit npm `devDependencies`).

Hinweis

Melden Sie sich nach dem Herunterladen von ngrok an, und installieren Sie authtoken.

Einrichten einer lokalen Umgebung

9 Minuten verbleibend

Öffnen Sie Microsoft Teams-Beispiele.
Wählen Sie "Code" aus.
Wählen Sie im Dropdownmenü " Mit GitHub-Desktop öffnen" aus.
Wählen Sie "Klonen" aus.

Entwicklervorschau aktivieren

8 Minuten verbleibend

Aktivieren Sie das Hochladen von Apps in der Administratorkonsole Ihres Mandanten.
1. Melden Sie sich mit Ihren Administratoranmeldeinformationen beim Microsoft 365 Admin Center an.
2. Wählen Sie im linken Bereich " Alle anzeigen" aus.
3. Wählen Sie "Teams" aus.
Wählen Sie im linken Bereich Teams-Apps aus.
Wählen Sie "Setuprichtlinien" aus.
Wählen Sie "Global" (organisationsweiter Standard) aus.
Umschalten der Option "Benutzerdefinierte Apps hochladen " in die Position "Ein ".
Wählen Sie Speichern.

Ihr Testmandant kann benutzerdefiniertes Querladen von Apps zulassen.

Tipp

Das Querladen dauert einige Zeit, bis es aktiv wird.
Wechseln Sie zu Microsoft Teams.
Wählen Sie in der oberen rechten Ecke Ihrer Teams-Benutzeroberfläche die Option ...aus.
Wählen Sie Informationen aus.
Wählen Sie "Entwicklervorschau" aus.
Wählen Sie "Zur Entwicklervorschau wechseln" aus.

Konfigurieren des Connectors

7 Minuten verbleibend

Wechseln Sie im geklonten Repository zu "TeamsToDoAppconnector.sln ".
Verwenden Sie ngrok oder Eingabeaufforderung, um einen Tunnel zu den öffentlich verfügbaren HTTPS-Endpunkten Ihres lokal ausgeführten Webservers zu erstellen. Führen Sie den folgenden Befehl in ngrok aus:
```
ngrok http --host-header=localhost 3978
```
Tipp

Wenn ERR_NGROK_4018 auftreten, führen Sie die Schritte aus, wie in der Eingabeaufforderung angezeigt, um ngrok zu registrieren und zu authentifizieren. Führen Sie anschließend den Befehl ngrok http --host-header=localhost 3978 aus.
Wechseln Sie zum Connector-Entwicklerportal.
Wählen Sie Neuer Connector.
Geben Sie die folgenden Details ein, um einen neuen Connector zu registrieren:
- Connectorname
- Logo
- Kurze Beschreibung Ihrer App (10 Wörter oder weniger)
- Detaillierte Beschreibung der Funktionsweise des Connectors (3-5 Sätze)
- Website des Unternehmens
- Konfigurationsseite für Ihren Connector als https://[BASE_URI]/connector/setup
- Gültige Domäne als https Base URL
- Wählen Sie "Ja " aus, um die Aktion auf der Connectorkarte zu aktivieren.
- Aktions-URL als https://[BASE_URI]/Task/Update
- Wählen Sie "Ich akzeptiere die Bedingungen der Vereinbarung für App-Entwickler" aus.
- Wählen Sie Speichern aus.
Sie haben erfolgreich einen neuen Connector registriert. Das Fenster wird mit der registrierten Connector-ID angezeigt.

Tipp

Speichern Sie die Connector-ID zur zukünftigen Referenz.
Wählen Sie die Datei "TeamsToDoAppConnector.csproj " aus dem Ordner "TeamsToDoAppConnector" aus.
Öffnen Sie in Visual Studio.
Ersetzen Sie die configuration.appSettings.BaseUrl Variable durch ngrok https forwarding url.
Press F5 to run the project. Eine Webseite wird geöffnet.

Testconnector in Microsoft Teams

6 Minuten verbleibend

Wechseln Sie in Ihrem geklonten Repository zu csharp > TeamsToDoAppConnector > TeamsAppPackages.
Erstellen Sie eine .zip mit den folgenden Dateien, die im Manifestordner vorhanden sind:
- manifest.json
- icon-outline.png
- icon-color.png
Wechseln Sie zu Microsoft Teams.
Wählen Sie im linken Bereich "Apps > verwalten" aus.
Wählen Sie Benutzerdefinierte App hochladen aus.
Wählen Sie "Öffnen " aus, um die .zip Datei hochzuladen, die Sie im Manifestordner erstellt haben.
Wählen Sie "Zu einem Team hinzufügen" aus.
Wählen Sie den Team- oder Kanalnamen aus der Liste aus.
Wählen Sie "Verbinder einrichten" aus.
Suchen Sie im linken Bereich in der Suchleiste nach dem Teams ToDo-Benachrichtigungsconnector , und wählen Sie "Konfigurieren" aus.
Wählen Sie auf der Registrierungsseite entweder "Erstellt " oder " Aktualisiert " und dann " Speichern" aus.

Nach der Konfiguration können Sie Benachrichtigungen im Kanal mit Link zum Task-Manager-Portal sehen.
Wechseln Sie zum Task-Manager-Portal.
Wählen Sie "Neu erstellen" aus.
Geben Sie die neuen Aufgabendetails ein:
- Titel
- Beschreibung
- Zuweisen zu
Wählen Sie Speichern aus.

Die Nachrichtenkarte wird im registrierten Teams-Kanal angezeigt.

Tipp

Sie können die interaktiven Schaltflächen ausprobieren, die auf der Nachrichtenkarte verfügbar sind.