Obtenir des canaux

Vue d'ensemble (Overview)

À l'aide de vos paramètres de recherche (QueryOptions) et de l'équipe spécifiée (TeamId), l'activité Obtenir les canaux ( Get Channels ) appelle l'API Microsoft Graph ListChannels pour récupérer les canaux qui correspondent à votre requête.

Après avoir récupéré les canaux, l'activité renvoie ses propriétés et relations dans un objet Channel[] (Canaux) que vous pouvez utiliser comme variables d'entrée dans les activités suivantes (par exemple, Channel(0).Id dans Get Messages, Send Message, etc.).

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).
4. Ajoutez l’activité Obtenir les canaux (Get Channels ) à 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 ListChannels .
   • 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 des canaux
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 les canaux.

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, Obtenir des équipes 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

Options

OptionsRequête

Les paramètres de recherche que vous souhaitez appliquer lors de la récupération de votre liste de canaux.

Attributs	Détails (Details)
Saisie de texte	QueryOption[] (syntaxe OData)
Requis	Non (No)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable QueryOption[] ou QueryOption .
Remarques	Entrez votre valeur à l'aide d'une option de requête système OData; le format est le suivant : _{New QueryOption("Option", "OptionParameter")}. Par exemple, si vous souhaitez appliquer l'option $filter , vous devez saisir « filtre » comme première chaîne, puis saisir un paramètre de filtre comme deuxième chaîne (par exemple, {New QueryOption("filter", "displayName ne 'General'")}.

Sortie

Canaux

Tableau de canaux (objet Channel[] ) qui correspondent à la valeur OptionsRequête .

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 Channel[] .
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, Get Messages, Send Message, etc.). * Lorsque vous utilisez cette variable comme valeur de propriété d'entrée, spécifiez l'élément du tableau que vous souhaitez utiliser (par exemple, createdChannels(0)). 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 .