Zum Inhalt springen

Microsoft Teams List Channels-Aktivität in Jitterbit Studio

Einführung

Eine Microsoft Teams List Channels-Aktivität, die ihre Microsoft Teams-Verbindung verwendet, ruft eine Liste von Kanälen für ein Team in Microsoft Teams ab und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

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 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 ist auf das Testen der Abfrage beschränkt. Die Aktivitätskonfiguration kann weiterhin abgeschlossen werden. Zur Laufzeit gibt der Vorgang die erwarteten Kanaldetails zurück.

Erstellen einer Microsoft Teams List Channels-Aktivität

Eine Instanz einer Microsoft Teams List Channels-Aktivität wird aus einer Microsoft Teams-Verbindung unter Verwendung des Aktivitätstyps List Channels erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft Teams List Channels-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Microsoft Teams List Channels-Aktivität

Befolgen Sie diese Schritte, um eine Microsoft Teams List Channels-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Team aus

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Team aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpunktmenü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Microsoft Teams List Channels-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Team auswählen: In diesem Abschnitt werden die in dem Microsoft Teams-Endpunkt verfügbaren Teams angezeigt.

    • Ausgewähltes Team: Nachdem ein Team ausgewählt wurde, wird es hier aufgelistet.

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Teams zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Teams bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Teams beim Suchen vom Endpunkt neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Teams vom Microsoft Teams-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Teams zu Microsoft Teams hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Teamtabelle verwendet werden.

    • Ein Team auswählen: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Team auszuwählen. Es kann nur ein Team ausgewählt werden. Die für jedes Team verfügbaren Informationen werden vom Microsoft Teams-Endpunkt abgerufen:

      • Name: Der Name des Teams.

      • Beschreibung: Die Beschreibung des Teams. Wenn ein Team keine Beschreibung hat oder die Beschreibung nur aus Leerzeichen besteht, verwendet der Connector den Teamnamen als Teambeschreibung. Dies hat keinen Einfluss auf das Schema, die Ausführung oder die zurückgegebene Antwort.

    Hinweis

    Wenn die Tabelle nicht mit verfügbaren Teams gefüllt wird, könnte die Microsoft Teams-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Definieren Sie eine Filterzeichenfolge

In diesem Schritt wird eine Filterzeichenfolge für eine Abfrage unter Verwendung der verfügbaren Kanalfelder und Abfrageeinstellungen definiert. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

Hinweis

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

Die Filterzeichenfolge kann in den Basis- oder Erweitert-Tabs konfiguriert werden.

Hinweis

Änderungen, die in einem Tab vorgenommen werden, werden im anderen nicht angezeigt. Die Abfrage der Filterzeichenfolge für den Modus, der ausgewählt ist, wenn der Connector geschlossen wird, ist die Abfrage, die für den Connector verwendet wird.

  • Basis: Ermöglicht es Ihnen, die Filterzeichenfolge mit geführten Feldern zu erstellen.

    • Objektfelder: Wählen Sie die Felder aus, die in der Abfrage basierend auf dem ausgewählten Kanal verwendet werden sollen.

      • Suche: Geben Sie einen Teil eines Feldnamens in das Suchfeld ein, um die Liste der Felder für den ausgewählten Kanal zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Die aufgelisteten Ergebnisse werden in Echtzeit mit jedem Tastendruck gefiltert.

      • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Felder des Kanals vom OData-Endpunkt neu zu laden.

      • Alle in Kanälen auswählen: Wenn Sie das Suchfeld verwenden, um zu filtern, können Sie dieses Kontrollkästchen verwenden, um alle sichtbaren Felder auf einmal auszuwählen.

      • Felder auswählen: Wählen Sie die Kontrollkästchen der Felder aus, die Sie in die Abfrage einbeziehen möchten, damit sie automatisch zur Filterzeichenfolge hinzugefügt werden. Sie können auch alle Felder auf einmal mit dem übergeordneten Kontrollkästchen auswählen.

    • Seitenzahl: Geben Sie eine Seitenzahl ein, um die Ergebnis-Paginierung zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite wird die angegebene Größe nicht überschreiten. Ein Link zur nächsten Seite der Ergebnisse wird ebenfalls in der Antwort enthalten sein.

    • Anzahl einbeziehen: Wählen Sie aus, die Anzahl der Ergebnisse einer Abfrage als Teil der Antwort einzubeziehen. Wenn eine Abfrage beispielsweise insgesamt 5 Ergebnisse zurückgibt, wird die Antwort auch "@odata.count": 5 enthalten.

    • Volltextsuche: Geben Sie Suchbegriffe ein, um in der ausgewählten Objektklasse zu suchen. Der OData-Endpunkt verarbeitet, wie die Suche für eine Objektklasse interpretiert wird.

    • Überspringen: Geben Sie eine Anzahl von Ergebnissen an, die in der Abfrageantwort übersprungen werden sollen.

    • Top: Geben Sie eine maximale Anzahl von Ergebnissen an, die Sie in der Abfrageantwort erhalten möchten.

    • Bedingte Klauseln: Um Bedingungen hinzuzufügen, verwenden Sie diese Felder als Eingabe, um die Klauseln zu konstruieren, die dann in der Filterzeichenfolge erscheinen.

      • Objekt: Verwenden Sie das Dropdown-Menü, um die Objektklasse auszuwählen, die für die Bedingung verwendet werden soll.

      • Feld: Verwenden Sie das Dropdown-Menü, um das Feld aus der Objektklasse auszuwählen, das für die Bedingung verwendet werden soll.

      • Operator: Verwenden Sie das Dropdown-Menü, um einen geeigneten Operator auszuwählen:

        Vergleich
        Gleich
        Größer als
        Größer als oder gleich
        Kleiner als
        Kleiner als oder gleich

      • Wert: Geben Sie den gewünschten Wert ein, um ihn mit den vorherigen Dropdown-Auswahlen zu vergleichen.

      • Entfernen: Klicken Sie, um die Bedingung zu entfernen.

      • Hinzufügen: Klicken Sie, um eine neue Bedingung zur Tabelle Bedingte Klauseln und Filterzeichenfolge hinzuzufügen.

      • Alle Entfernen: Klicken Sie, um alle Bedingungen aus der Tabelle Bedingte Klauseln und Filterzeichenfolge zu entfernen.

    • Filterzeichenfolge: Während Sie die anderen Felder im Tab Basis ausfüllen, wird die Filterzeichenfolgenanweisung in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Abfrageoptionen ausgefüllt.

  • Erweitert: Blendet die geführten Felder aus und ermöglicht es Ihnen, die Filterzeichenfolge direkt zu ändern.

    • Seitenzahl: Geben Sie eine Seitenzahl ein, um die Ergebnis-Paginierung zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite wird bis zur angegebenen Größe summiert. Ein Link zur nächsten Seite der Ergebnisse wird ebenfalls in der Antwort enthalten sein.

    • Filterzeichenfolge: Bearbeiten Sie die Filterzeichenfolgenanweisung direkt.

  • Abfrage testen: Klicken Sie, um die Abfrage zu validieren. Wenn die Abfrage gültig ist, wird eine Stichprobe von bis zu 10 Datensätzen, die aus der Abfrage abgerufen wurden, in einer Tabelle angezeigt. Wenn die Abfrage nicht gültig ist, werden relevante Fehlermeldungen angezeigt. Wenn Sie die Filterzeichenfolge im Erweitert-Modus bearbeiten, muss die Abfrage gültig sein und über diese Schaltfläche validiert werden, um die Schaltfläche Weiter zu aktivieren.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 3: Überprüfen der Datenschemas

Alle Anforderungs- oder Antwortschemas, die vom Endpunkt generiert wurden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    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.

    Die Anforderungs- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Microsoft Teams-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, z. B. in einer benachbarten Transformation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor für dieses Datenschema zu öffnen. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu anzuordnen sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder werden auf [0, 1] Kardinalität gesetzt. Änderungen an den Datenschemas müssen für den Endpunkt akzeptabel sein und sollten nur nach Konsultation der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach dem Bearbeiten des Schemas wird ein Datum der letzten Bearbeitung oben im entsprechenden Schema angezeigt, um anzuzeigen, dass das Schema manuelle Änderungen erfahren hat. Das Aktualisieren der Schemata setzt die Schemata auf ihre Standardstrukturen zurück.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nach dem Vornehmen von Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Microsoft Teams Kanäle auflisten-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Microsoft Teams Kanäle auflisten-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, setzen Sie den Vorgang ein und führen Sie ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.