Zum Inhalt springen

Microsoft Teams-Connector in Jitterbit Studio

Zusammenfassung

Der Microsoft Teams-Connector stellt Zugriff auf Microsoft Teams bereit.

Der Microsoft Teams-Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Teams-Verbindung, die Grundlage für die Generierung von Instanzen von Microsoft Teams-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Microsoft Teams über die Verbindung.

Der Microsoft Teams-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Tipp

Integration recipes sind für diesen Connector über Jitterbit Marketplace verfügbar.

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine Microsoft Teams-Verbindung zu konfigurieren. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

Zusammen werden eine bestimmte Microsoft Teams-Verbindung und ihre Aktivitäten als Microsoft Teams-Endpunkt bezeichnet:

Microsoft Teams-Aktivitätstypen

  • List Channels: Ruft eine Liste der Kanäle für ein Team in Microsoft Teams ab und ist als Ziel in einem Vorgang vorgesehen.

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

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

  • Chat: Ruft einen vorhandenen Chat ab oder erstellt einen neuen Chat in Microsoft Teams und ist als Ziel in einem Vorgang vorgesehen.

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

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update ausgesetzt werden.

Der Microsoft Teams-Connector verwendet die Microsoft Graph REST API v1.0. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Der Microsoft Teams-Connector erfordert, dass eine Anwendung mit Microsoft Entra ID erstellt und registriert wird, mit einem bestimmten Satz von Berechtigungen. Erstellen und konfigurieren Sie diese Anwendung wie in Microsoft Teams-Voraussetzungen beschrieben, bevor Sie den Connector konfigurieren.

Der Microsoft Teams-Connector unterstützt OAuth 2.0 über den Microsoft Entra ID-App-Registrierungsprozess.

Bekannte Probleme

Der Microsoft Teams-Connector hat dieses bekannte Problem:

  • Das Testen einer Abfrage in einer Microsoft Teams List Channels-Aktivität schlägt fehl, wenn ein Teamname Leerzeichen enthält

    • Zusammenfassung: Das Testen einer Abfrage in Schritt 2 einer Microsoft Teams-Aktivität List Channels schlägt mit einem Fehler Invalid Query fehl, wenn der Microsoft Teams-Teamname Leerzeichen enthält.

    • Zusätzliche Informationen: Das Problem ist auf das Testen der Abfrage beschränkt. Die Aktivitätskonfiguration kann trotzdem abgeschlossen werden. Zur Laufzeit gibt der Vorgang die erwarteten Kanaldetails zurück.

Fehlerbehebung

Falls Probleme mit dem Microsoft Teams-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren verwendet wird).

  2. Stellen Sie sicher, dass alle Microsoft Entra ID-App-Registrierungen, die der Verbindung zugeordnet sind, nicht die veraltete Azure AD Graph verwenden.

  3. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  4. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  5. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agents hinzufügen:

    <logger name="org.jitterbit.connector.teams" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

  6. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  7. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

  8. Verbindung: Beim Testen der Verbindung kann der Fehler The user or administrator has not consented to use the application auftreten, wenn Microsoft Graph API-Berechtigungen keine Admin-Zustimmung erhalten haben.

    Zur Behebung erteilen Sie Admin-Zustimmung für alle API-Berechtigungen, die dies erfordern, wie in Microsoft Graph API-Berechtigungen unter Voraussetzungen dokumentiert.