Zum Inhalt springen

Microsoft Teams-Verbindung

Einführung

Eine Microsoft Teams-Verbindung, die mit dem Microsoft Teams-Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft Teams. Sobald eine Verbindung konfiguriert ist, können Instanzen von Microsoft Teams-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer Microsoft Teams-Verbindung

Eine neue Microsoft Teams-Verbindung wird mit dem Microsoft Teams-Connector von einem dieser Standorte aus erstellt:

Eine vorhandene Microsoft Teams-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer Microsoft Teams-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft Teams-Verbindung wird im Folgenden beschrieben.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine offene eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft Teams-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Microsoft Teams-Endpunkt zu identifizieren, der sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten verweist.

  • Mandanten-ID: Geben Sie die Mandanten-ID ein. Die Mandanten-ID kann durch das Einloggen in Microsoft Entra ID erhalten werden.

  • 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 in den Microsoft Teams-Voraussetzungen registriert wird.

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

  • Benutzername: Geben Sie den Benutzernamen ein, den Sie zum Anmelden bei Microsoft Entra ID verwenden.

  • Passwort: Geben Sie das Passwort ein, das Sie zum Anmelden bei Microsoft Entra ID verwenden.

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

    • Bereich: Geben Sie die für Ihre App-Registrierung aktivierten Microsoft Teams API-Berechtigungen ein. Standardmäßig enthält dieses Feld alle 31 API-Berechtigungen, die benötigt werden, um alle Aktivitäten zu nutzen, wie in den Voraussetzungen beschrieben.

      Tipp

      Wenn Sie nicht alle 31 API-Berechtigungen eingeben, können Sie .default in dieses Feld eingeben. Der .default-Bereich umfasst alle API-Berechtigungen, die Ihrer App-Registrierung gewährt wurden, was zusätzliche Berechtigungen umfassen kann, die vom Microsoft Teams-Connector nicht benötigt werden.

    • Proxy-Einstellungen verwenden (Nur privater Agent): Wenn Sie einen privaten Agenten verwenden, kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Test: Klicken Sie, 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, die mit der aktuellen Umgebung verbunden ist, heruntergeladen. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Auto Connector Update deaktivieren Organisationsrichtlinie.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Möglicher Verbindungsfehler

Sie erhalten möglicherweise den Fehler Der Benutzer oder Administrator hat nicht zugestimmt, die Anwendung zu verwenden, wenn keine Administratorzustimmung für die Microsoft Graph API-Berechtigungen erteilt wurde.

Um das zu beheben, erteilen Sie die Administratorzustimmung für alle API-Berechtigungen, die dies erfordern, wie in den Microsoft Graph API-Berechtigungen in den Voraussetzungen dokumentiert.

Nächste Schritte

Nachdem eine Microsoft Teams-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsfläche, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Weitere Einzelheiten finden Sie in den Aktionsmenüs in den Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • List Channels: Ruft eine Liste von Kanälen für ein Team in Microsoft Teams ab und ist als Ziel in einer Operation vorgesehen.

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

  • Add Channels: Erstellt Kanäle (mit der Option, Mitglieder hinzuzufügen) in einem Team in Microsoft Teams und ist als Ziel in einer Operation vorgesehen.

  • Chat: Ruft einen bestehenden Chat ab oder erstellt einen neuen Chat in Microsoft Teams und ist als Ziel in einer Operation vorgesehen.

  • Send Message: Sendet eine Nachricht an ein bestimmtes Team und einen bestimmten Kanal in Microsoft Teams und ist als Ziel in einer Operation vorgesehen.