Obtenir le canal

Vue d'ensemble (Overview)

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

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

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

Mode de fonctionnement

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

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

   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API GetCchannel .

   • 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.

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 .

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 les activités ultérieures (par exemple, Channel.Id dans Obtenir les messages , Envoyer le message , etc.). L'objet Channel comprend plusieurs propriétés et relations que vous pouvez utiliser dans d'autres activités. L'exemple d'image 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, consultez 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 et des exemples étape par étape, consultez les guides de démarrage rapide .