Zum Inhalt springen

Microsoft Teams-Connector für Jitterbit Studio

Zusammenfassung

Der Microsoft Teams-Connector ermöglicht den Zugriff auf Microsoft Teams.

Der Microsoft Teams-Connector bietet eine Schnittstelle zum Erstellen einer Microsoft Teams-Verbindung, die als Grundlage für die Generierung von Instanzen von Microsoft Teams-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Microsoft Teams.

Der Microsoft Teams-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Hinweis

Integrationsrezepte sind für diesen Connector über den Jitterbit Marketplace verfügbar.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine Microsoft Teams-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

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

Microsoft Teams-Aktivitätstypen

  • Kanäle auflisten: Ruft eine Liste von Kanälen für ein Team in Microsoft Teams ab und ist als Ziel in einem Vorgang gedacht.

  • Mitglieder hinzufügen: Fügt Mitglieder zu einem Kanal in einem Team in Microsoft Teams hinzu und ist als Ziel in einem Vorgang gedacht.

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

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

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

Hinweis

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

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der Microsoft Teams Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

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

Der Microsoft Teams Connector erfordert, dass eine Anwendung erstellt und bei Microsoft Entra ID mit einem bestimmten Berechtigungsset registriert wird. Erstellen und konfigurieren Sie diese Anwendung wie in den Voraussetzungen für Microsoft Teams beschrieben, bevor Sie den Connector konfigurieren.

Der Microsoft Teams Connector unterstützt OAuth 2.0 unter Verwendung des Registrierungsprozesses für Microsoft Entra ID-Apps.

Bekannte Probleme

Der Microsoft Teams Connector hat folgendes bekanntes Problem:

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

    • Zusammenfassung: Das Testen einer Abfrage in Schritt 2 einer Microsoft Teams List Channels-Aktivität 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 Aktivierungskonfiguration kann weiterhin abgeschlossen werden. Zur Laufzeit gibt der Vorgang die erwarteten Kanalinformationen zurück.

Fehlerbehebung

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

  1. Klicken Sie auf die Test-Schaltfläche in der Verbindungskonfiguration, 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 Auto Connector Update deaktivieren).

  2. Stellen Sie sicher, dass keine Microsoft Entra ID-App-Registrierungen, die mit der Verbindung verbunden sind, die veraltete Azure AD Graph verwenden.

  3. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  4. Aktivieren Sie das Debug-Protokoll für den Vorgang (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  5. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokoll für den Connector für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

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

    Weitere Informationen zum ausführlichen Protokoll für Connectoren finden Sie unter Ausführliches Protokoll für Connectoren, die Jitterbit private Agenten verwenden.

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

  7. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Vorgängen.

  8. Verbindung: Wenn Sie die Verbindung testen, kann die Fehlermeldung Der Benutzer oder Administrator hat nicht zugestimmt, die Anwendung zu verwenden angezeigt werden, wenn keine Administratorberechtigungen für die Microsoft Graph API erteilt wurden.

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