Kanal abrufen

Aktivität zum Aufrufen der Microsoft Graph GetChannel-API zum Abrufen der Eigenschaften und Beziehungen eines angegebenen Kanals aus einem Team in Microsoft Teams

Überblick

Die Aktivität Get Channel ruft die Microsoft Graph GetChannel- API auf, um die Eigenschaften und Beziehungen eines angegebenen Kanals (Kanal-ID) von einem Team (TeamID) abzurufen.

Nach dem Abrufen des Kanals gibt die Aktivität seine Eigenschaften und Beziehungen in einem Channel -Objekt (Kanal) zurück, das Sie in nachfolgenden Aktivitäten als Eingabevariablen verwenden können (z. B. Channel.Id in Nachrichten abrufen, Nachricht senden usw.).

Im Gegensatz zur Aktivität Get Channels , die eine Liste von Kanälen (Channel[]) mithilfe Ihrer angegebenen QueryOptions sucht und zurückgibt, ruft die Aktivität Get Channel einen einzelnen, angegebenen Kanal (Channel) mithilfe der bereitgestellten Kanal-ID und TeamID ab. Diese Aktivität ist nicht für die Suche nach einem Kanal wie die Aktivität Get Channels vorgesehen und kann nur verwendet werden, wenn der Wert Channel.Id bekannt ist.

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) UND eine Aktivität oder einen externen Prozess, der einen Channel.Id -Wert ausgibt (z. B. Create Channel).
4. Fügen Sie die Aktivität Get Channel 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 GetChannel -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	Kanal 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 den Kanal 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. Create Team oder externer API-Aufruf).

Channel ID

Die ID des Channel -Objekts, das Sie 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 Channel.Id abzurufen, verwenden Sie einen externen Prozess oder eine Aktivität, die den Wert Channel.Id in ihrer Ausgabe enthält (z. B.Kanal erstellen 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

Ausgabe

Kanal

Das Channel -Objekt, das den abgerufenen Kanal darstellt.

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 Team -Variable ein.
Hinweise	Die Variable, die Sie für diese Eigenschaft erstellen, kann als Eingabevariable in nachfolgenden Aktivitäten verwendet werden (z. B. Channel.Id in Get Messages, Send Message usw.). Das Channel -Objekt enthält mehrere Eigenschaften und Beziehungen , die Sie in anderen Aktivitäten verwenden können. Die folgende Beispielabbild zeigt einige der Eigenschaften, die Sie zurückgeben können. 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 .