Zum Inhalt springen

Microsoft Teams Connector für Jitterbit Integration Studio

Zusammenfassung

Der Microsoft Teams Connector stellt den Zugriff auf Microsoft Teams her.

Der Microsoft Teams-Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Teams-Verbindung, der Grundlage zum Generieren von Instanzen von Microsoft Teams Aktivitäten. Nach der Konfiguration interagieren diese Aktivitäten über die Verbindung mit Microsoft Teams.

Der Zugriff auf den Microsoft Teams-Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Mit diesem Connector wird zunächst eine Microsoft Teams Verbindung konfiguriert. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einem Operation) oder Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden sollen.

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

Microsoft Teams Aktivitätstypen

  • 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.

Hinweis

Dieser Connector ist ein Connector SDK-basierter Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectoren kommuniziert werden.

Voraussetzungen und unterstützte API Versionen

Der Microsoft Teams Connector erfordert die Verwendung einer Agent-Version 10.1 oder höher. Diese Agentversionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

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

Für den Microsoft Teams Connector muss eine Anwendung erstellt und mit Microsoft Entra ID registriert werden mit einem bestimmten Satz von Berechtigungen. Erstellen und konfigurieren Sie diese Anwendung wie unter Microsoft Teams-Voraussetzungen beschrieben, bevor Sie den Connector konfigurieren.

Der Microsoft Teams Connector unterstützt OAuth 2.0 mithilfe des App-Registrierungsprozesses von Microsoft Entra ID.

Bekannte Probleme

Beim Microsoft Teams Connector besteht das folgende Bekanntes Problem:

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

    • Zusammenfassung: Das Testen einer Abfrage in Schritt 2 einer Microsoft Teams Kanäle auflisten schlägt mit einem Ungültige Abfrage-Fehler fehl, wenn der Microsoft Teams-Teamname Leerzeichen enthält.

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

Fehlerbehebung

Wenn Sie Probleme mit dem Microsoft Teams Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

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

  2. Stellen Sie sicher, dass alle mit der Verbindung verknüpften Microsoft Entra ID App-Registrierungen nicht den veralteten Azure AD Graph verwenden.

  3. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

  4. Aktivieren Sie die debuggen für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  5. Wenn Sie private Agenten verwenden, können Sie Connector Verbose Logging aktivieren für diesen Connector unter Verwendung dieses spezifischen Konfigurationseintrags mit Loggername und -ebene:

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

  6. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

  7. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Vorgängen.

  8. Verbindung: Beim Testen der Verbindung erhalten Sie möglicherweise 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 allen API Berechtigungen, für die dies erforderlich ist, die Administratorzustimmung, wie in Microsoft Graph-API Berechtigungen dokumentiert in Voraussetzungen.