Obtenir le canal

Vue d'ensemble (Overview)

L'activité Obtenir le canal ( Get Channel ) appelle l'API Microsoft Graph GetChannel pour récupérer les propriétés et les relations d'un canal spécifié (ChannelId) à partir d'une équipe (TeamId).

Après avoir récupéré le canal, l'activité renvoie ses propriétés et ses relations dans un objet Channel (Canal) que vous pouvez utiliser comme variables d'entrée dans les activités suivantes (par exemple, Channel.Id dans Obtenir des messages ( Get Messages) , Envoyer un message ( Send Message), etc.).

Contrairement à l'activité Get Channels , qui recherche et renvoie une liste de canaux (Channel[]) à l'aide de vos QueryOptions spécifiés, l'activité Get Channel récupère un seul canal spécifié (Channel) à l'aide des ChannelId et TeamId fournis. Cette activité n'est pas destinée à être utilisée pour rechercher un canal comme l'activité Obtenir les canaux ( Get Channels ) et ne peut être utilisée que lorsque la valeur Channel.Id est connue.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l’activité Étendue Microsoft Teams ( Microsoft Teams Scope ) à votre projet.
3. Ajoutez une activité ou exécutez un processus externe qui génère une valeur Team.Id (par exemple, Get Teams) ET une activité ou un processus externe qui génère une valeur Channel.Id (par exemple, Create Channel).
4. Ajoutez l’activité Obtenir le canal (Get Channel ) à l’intérieur de l’activité Étendue Microsoft Teams ( Microsoft Teams Scope ).
5. Entrez les valeurs des propriétés d' entrée .
6. Créez et entrez une variable Channel pour votre propriété Output (Sortie).

7. Exécutez l’activité.

   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API GetChannel .
   • L'API renvoie la valeur Channel à votre variable de propriété de sortie.
     
     

     

     
     

Propriétés

Les valeurs des propriétés suivantes sont spécifiées lors de l'ajout de cette activité à votre projet dans UiPath Studio.

Commun

DisplayName

Le nom complet de l’activité.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Obtenir le canal
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

Entrée

ID d'équipe

ID de l'objet Team dont vous souhaitez récupérer le canal.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Pour obtenir la valeur Team.Id , utilisez un processus ou une activité externe qui inclut la valeur Team.Id dans sa sortie (par exemple, Créer une équipe ou un appel API externe)

Identifiant du canal

ID de l'objet Channel que vous souhaitez récupérer.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Pour obtenir la valeur Channel.Id , utilisez un processus ou une activité externe qui inclut la valeur Channel.Id dans sa sortie (par exemple,Créer un canal ou un appel API externe)

Divers

Private

Si elles sont sélectionnées, les valeurs des variables et des arguments ne sont plus enregistrées au niveau détaillé.

Attributs	Détails (Details)
Saisie de texte	Case à cocher
Requis	Non (No)
Valeur par défaut	non sélectionné
Valeurs autorisées	Sélectionné ou Non sélectionné
Remarques	S/O

Sortie

Canal

L'objet Channel qui représente le canal récupéré.

Attributs	Détails (Details)
Saisie de texte	Channel
Requis	Non (requis si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable Team .
Remarques	La variable que vous créez pour cette propriété peut être utilisée comme variable d'entrée dans des activités ultérieures (par exemple, Channel.Id dans Obtenir des messages ( Get Messages) , Envoyer un message ( Send Message), etc.). L'objet Channel comprend plusieurs propriétés et relations que vous pouvez utiliser dans d'autres activités. L'image d'exemple ci-dessous montre certaines des propriétés que vous pouvez renvoyer. Remarque - certaines propriétés répertoriées dans le concepteur ne s'appliquent pas à l'objet Channel (par exemple, Visibility). Pour obtenir la liste des propriétés Team applicables, cliquez sur les liens ci-dessus.

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez les guides de démarrage rapide .