Kanal abrufen

Überblick

The Get Channel activity calls the Microsoft Graph GetChannel API to retrieve the properties and relationships of a specified channel (ChannelId) from a team (TeamId).

After retrieving the channel, the activity returns its properties and relationships in a Channel object (Channel) that you can use as input variables in subsequent activities (e.g., Channel.Id in Get Messages, Send Message, etc.).

Unlike the Get Channels activity, which searches and returns a list of channels(Channel[]) using your specified QueryOptions, the Get Channel activity retrieves a single, specified channel (Channel) using the provided ChannelId and TeamId. This activity is not intended to be used to search for a channel like the Get Channels activity and can only be used when the Channel.Id value is known.

Wie es funktioniert

The following steps and message sequence diagram is an example of how the activity works from design time (that is, the activity dependencies and input/output properties) to run time.

1. Schließen Sie die Einrichtungsschritte ab.
2. Add the Microsoft Teams Scope activity to your project.
3. Add an activity or run an external process that outputs a Team.Id value (e.g., Get Teams) AND an activity or external process that outputs a Channel.Id value (e.g., Create Channel).
4. Add the Get Channel activity inside the Microsoft Teams Scope activity.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Create and enter a Channel variable for your Output property.
7. Führen Sie die Aktivität aus.

   • Your input property values are sent to the GetChannel API.

   • 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	To get the Team.Id value, use an external process or activity that includes the Team.Id value in its output (for example, Create Team or external API call)

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	To get the Channel.Id value, use an external process or activity that includes the Channel.Id value in its output (for example, Create Channel or external API call)

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	The variable you create for this property can be used as an input variable in subsequent activities (e.g., Channel.Id in Get Messages , Send Message , etc.). 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. Note - some properties listed in the designer are not applicable to the Channel object (e.g., Visibility ). For a list of the applicable Team properties, visit the links above.

Beispiel

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

For step-by-step instructions and examples, see the Quickstart guides.