Microsoft Teams Listenkanalaktivität

Einführung

Eine Microsoft Teams Aktivität Kanäle auflisten unter Verwendung ihrer Microsoft Teams-Verbindung, ruft eine Liste von Kanälen für ein Team bei Microsoft Teams ab und soll als Ziel zum Verwenden von Daten in einem Operation verwendet werden.

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.

Erstellen einer Microsoft Teams Listenkanalaktivität

Eine Instanz einer Microsoft Teams Aktivität Kanäle auflisten wird aus einer Microsoft Teams-Verbindung erstellt mithilfe des Aktivitätstyps Kanäle auflisten.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft Teams Aktivität Kanäle auflisten kann an diesen Orten bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer Microsoft Teams Listenkanalaktivität

Befolgen Sie diese Schritte, um eine Microsoft Teams Aktivität Kanäle auflisten zu konfigurieren:

• Schritt 1: Gib einen Namen ein und wähle ein Team aus
  Geben Sie einen Namen für die Aktivität ein und wählen Sie ein Team aus.

• Schritt 2: Definieren Sie eine Filterzeichenfolge
  Legen Sie mithilfe der Kanalfelder Bedingungen für eine Abfrage fest und wenden Sie die Paginierung auf eine Abfrage an.

• Schritt 3: Überprüfen Sie die Datenschemata
  Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt.

Schritt 1: Gib einen Namen ein und wähle ein Team aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Team aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

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

• Wählen Sie ein Team aus: In diesem Abschnitt werden die im Microsoft Teams Endpoint verfügbaren Teams angezeigt.

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

  • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Teams zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Teams angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Teams beim Suchen vom Endpoint 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 Teams vom Microsoft Teams Endpoint 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.

  • Team auswählen: Klicken Sie in der Tabelle irgendwo auf eine 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 Endpoint abgerufen:

    • Name: Der Name des Teams.

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

  Tipp

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

• Speichern und beenden: Klicken Sie, wenn aktiviert, 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 mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Definieren Sie eine Filterzeichenfolge

In diesem Schritt wird die Filterzeichenfolge einer Abfrage unter Verwendung verfügbarer Kanalfelder und Abfrage definiert. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Die Filterzeichenfolge kann in den Registerkarten Basis oder Erweitert konfiguriert werden.

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

  

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

    • Suchen: Geben Sie einen beliebigen Teil eines Feldnamens in das Suchfeld ein, um die Liste der Felder für den ausgewählten Kanal zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Die aufgelisteten Ergebnisse werden mit jedem Tastendruck in Echtzeit gefiltert.

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

    • Alle in Kanälen auswählen: Wenn Sie das Suchfeld zum Filtern verwenden, können Sie mit diesem Kontrollkästchen alle sichtbaren Felder auf einmal auswählen.

    • Felder auswählen: Aktivieren Sie die Kontrollkästchen der Felder, die in die Abfrage aufgenommen werden sollen, damit sie automatisch zum Filterstring hinzugefügt werden. Sie können auch alle Felder auf einmal mithilfe des übergeordneten Kontrollkästchens auswählen.

  • Seitengröße: Geben Sie eine Seitengröße ein, um die Seitennummerierung der Ergebnisse zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite entspricht der angegebenen Größe. Die Antwort enthält außerdem einen Link zur nächsten Seite mit Ergebnissen.

  • Anzahl einschließen: Wählen Sie diese Option aus, um die Anzahl der Ergebnisse einer Abfrage als Teil der Antwort einzuschließen. Wenn eine Abfrage beispielsweise insgesamt 5 Ergebnisse zurückgibt, enthält die Antwort auch "@odata.count": 5.

  • Volltextsuche: Geben Sie Suchbegriffe ein, um die ausgewählte Objektklasse Abfrage. Der OData Endpoint steuert, wie die Suche für eine Objektklasse interpretiert wird.

  • Überspringen: Geben Sie die Anzahl der Ergebnisse ein, die in der Abfrage übersprungen werden sollen.

  • Oben: Geben Sie eine maximale Anzahl von Ergebnissen ein, die in der Abfrage erhalten werden sollen.

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

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

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

    • Operator: Verwenden Sie die Dropdown-Liste, um einen geeigneten Operator auszuwählen:

      Vergleich
      Ist gleich
      Größer als
      Größer als oder gleich
      Weniger 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 hier, um die Bedingung zu entfernen.

    • Hinzufügen: Klicken Sie hier, um der Tabelle Bedingungsklauseln und der Filterzeichenfolge eine neue Bedingung hinzuzufügen.

    • Alle entfernen: Klicken Sie hier, um alle Bedingungen aus der Tabelle Bedingungsklauseln und der Filterzeichenfolge zu entfernen.

  • Filterzeichenfolge: Wenn Sie die anderen Felder auf der Tab Einfach ausfüllen, wird die Filterzeichenfolge in diesem Textfeld automatisch mit den ausgewählten Feldern, Bedingungen und Abfrage gefüllt.

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

  

  • Seitengröße: Geben Sie eine Seitengröße ein, um die Seitennummerierung der Ergebnisse zu aktivieren. Die Anzahl der Ergebnisse auf einer Seite entspricht der angegebenen Größe. Die Antwort enthält außerdem einen Link zur nächsten Seite mit Ergebnissen.

  • Filterzeichenfolge: Bearbeiten Sie die Filterzeichenfolgenanweisung direkt.

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

  

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

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

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

• Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

  Notiz

  Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

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

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

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Microsoft Teams Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

• Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Schema, um den Editor für dieses Schema aufzurufen. Mit dem Editor können Sie Knoten und Felder hinzufügen, löschen und neu organisieren sowie deren Datentypen ändern. Alle neu hinzugefügten Knoten und Felder werden auf [0, 1]Kardinalität. Änderungen an den Datenschemata müssen für den Endpoint akzeptabel sein und sollten nur nach Konsultation der verfügbaren Dokumentation für den Endpoint vorgenommen werden. Nach der Durchführung von Schema wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um darauf hinzuweisen, dass das Schema manuell bearbeitet wurde. Durch Aktualisieren der Schemata werden die Schemata auf ihre Standardstrukturen zurückgesetzt.

• Zurück: Klicken Sie hier, 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 Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Microsoft Teams Aktivität Kanäle auflisten konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Microsoft Teams List Channels-Aktivitäten können mit diesen Operation als Ziel verwendet werden:

• Transformation
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

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, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.