Zum Inhalt springen

Microsoft Teams Verbindung

Einführung

Eine Microsoft Teams Verbindung, die mit dem Microsoft Teams Connector erstellt wurde, richtet den Zugriff auf Microsoft Teams ein. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Microsoft Teams-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind, um sie entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) zu verwenden.

Erstellen oder Bearbeiten einer Microsoft Teams Verbindung

Eine neue Microsoft Teams-Verbindung wird mithilfe des Microsoft Teams Connectors von einem dieser Standorte aus erstellt:

Eine bestehende Microsoft Teams-Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Microsoft Teams Verbindung

Jedes Benutzeroberflächenelement des Microsoft Teams Verbindungskonfigurationsbildschirms wird unten beschrieben.

Microsoft Teams Verbindungskonfiguration

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft Teams-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des Microsoft Teams Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Mandanten-ID: Geben Sie die Mandanten-ID ein. Die Mandanten-ID erhalten Sie, indem Sie sich bei Microsoft Entra ID anmelden.

  • Client-ID: Geben Sie die Client-ID ein. Sowohl die Client-ID als auch der Wert des Client-Geheimnisses werden zugewiesen, wenn Ihre App gemäß den Anweisungen unter Microsoft Teams-Voraussetzungen registriert wird.

  • Clientgeheimnis: Geben Sie den Wert des Clientgeheimnisses ein. Sowohl die Client-ID als auch der Wert des Clientgeheimnisses werden zugewiesen, wenn Ihre App gemäß den Anweisungen unter Microsoft Teams-Voraussetzungen registriert wird.

  • Benutzername: Geben Sie den Benutzernamen ein, mit dem Sie sich bei Microsoft Entra ID anmelden.

  • Passwort: Geben Sie das Passwort ein, mit dem Sie sich bei Microsoft Entra ID anmelden.

  • Optionale Einstellungen: Klicken Sie, um diese optionalen Einstellungen zu erweitern:

    • Geltungsbereich: Geben Sie die Microsoft Teams API Berechtigungen ein, die für Ihre App-Registrierung aktiviert sind. Standardmäßig sind alle 31 API Berechtigungen aktiviert, die für die Verwendung aller Aktivitäten erforderlich sind, wie unter Voraussetzungen beschrieben, sind in diesem Feld vorbelegt.

      Tipp

      Wenn Sie nicht alle 31 API Berechtigungen verwenden, können Sie eingeben .default in diesem Bereich. Die .default Der Umfang umfasst die API Berechtigungen, die Ihrer App-Registrierung in der Anfrage gewährt wurden.

    • Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Möglicher Verbindungsfehler

Möglicherweise erhalten Sie die Fehlermeldung The user or administrator has not consented to use the application wenn für Microsoft Graph-API Berechtigungen keine Administratorzustimmung erteilt wurde.

Um das Problem zu beheben, erteilen Sie den Administratoren die Zustimmung zu allen API Berechtigungen, für die dies erforderlich ist, wie in Microsoft Graph-API Berechtigungen dokumentiert in Voraussetzungen.

Nächste Schritte

Nachdem eine Microsoft Teams Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Kanäle auflisten: Ruft eine Liste von Kanälen für ein Team bei Microsoft Teams ab und soll als Ziel in einer Operation verwendet werden.

  • Mitglieder hinzufügen: Fügt Mitglieder zu einem Kanal in einem Team bei Microsoft Teams hinzu und ist als Ziel in einer Operation vorgesehen.

  • Kanäle hinzufügen: Erstellt Kanäle (mit der Option, Mitglieder hinzuzufügen) in einem Team bei Microsoft Teams und ist für die Verwendung als Ziel in einer Operation vorgesehen.

  • Chat: Ruft einen vorhandenen Chat ab oder erstellt einen neuen Chat bei Microsoft Teams und soll als Ziel in einer Operation verwendet werden.

  • Nachricht senden: Sendet eine Nachricht an ein bestimmtes Team und einen bestimmten Kanal bei Microsoft Teams und soll als Ziel in einer Operation verwendet werden.