Kanäle abrufen

Überblick

Mithilfe Ihrer Suchparameter (QueryOptions) und des angegebenen Team (TeamId) ruft die Aktivität Get Channels die Microsoft Graph ListChannels -API auf, um die Kanäle abzurufen, die Ihrer Abfrage entsprechen.

Nach Abrufen der Kanäle gibt die Aktivität ihre Eigenschaften und Beziehungen in einem Channel[] -Objekt (channels) zurück, das Sie als Eingabevariablen in nachfolgenden Aktivitäten verwenden können (z. B. Channel(0).Id in Get Messages, Send Message usw.).

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Microsoft Teams Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der einen Team.Id -Wert ausgibt (z. B. Get Teams).
4. Fügen Sie die Aktivität Get Channels innerhalb der Aktivität Microsoft Teams Scope hinzu.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen und geben Sie eine Channel[] -Variable für Ihre Output- Eigenschaft ein.
7. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die ListChannels- API gesendet.

   • Die API gibt den Wert Channel[] an Ihre Ausgabeeigenschaftsvariable zurück.

     

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Kanäle abrufen
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Eingabe

Team ID

Die ID des Team -Objekts, von dem Sie Kanäle abrufen möchten.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Wert Team.Id abzurufen, verwenden Sie einen externen Prozess oder eine Aktivität, die den Wert Team.Id in ihrer Ausgabe enthält (z. B. Get Teams oder externer API-Aufruf).

Sonstiges

Private

Falls ausgewählt werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Optionen

Abfrageoptionen

Die Suchparameter, die Sie beim Abrufen Ihrer Kanalliste anwenden möchten.

Attribute	Details
Typ	QueryOption[] (OData-Syntax)
Erforderlich	Nein
Standardwert	Leer
Zulässige Werte	Geben Sie eine QueryOption[] oder QueryOption -Variable ein.
Hinweise	Enter your value using an OData system query option ; the format is as follows: _{New QueryOption("Option", "OptionParameter")}. For example, if you want to apply the $filter option, you would enter "filter" as the first string and then enter a filter parameter as the second string (e.g., {New QueryOption("filter", "displayName ne 'General'")}.

Ausgabe

Kanäle

Ein Array von Kanälen (Channel[] -Objekt), die mit dem QueryOptions -Wert übereinstimmen.

Attribute	Details
Typ	Channel[]
Erforderlich	Nein (erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten)
Standardwert	Leer
Zulässige Werte	Geben Sie eine Channel[] -Variable ein.
Hinweise	The variable you create for this property can be used as an input variable in subsequent activities (e.g., Get Messages, Send Message, etc.). * Wenn Sie diese Variable als Eingabeeigenschaftswert verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. erstellteKanäle(0) ). The Channel object includes multiple properties and relationships that you can use in other activities.The example image below shows some of the properties that you can return. Hinweis – Einige im Designer aufgeführte Eigenschaften gelten nicht für das Channel -Objekt (z. B. Visibility). Eine Liste der anwendbaren Team -Eigenschaften finden Sie unter den obigen Links.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Eine Schritt-für-Schritt-Anleitung und Beispiele finden Sie in den Schnellstartanleitungen .