Get Messages

Vue d'ensemble (Overview)

L'activité Obtenir les messages appelle l'API Microsoft Graph ListChatMessages ou ListChannelMessages pour récupérer tous les messages d'un chat (ID de chat) ou d'un canal (ID de canal) et d'une équipe (ID d'équipe).

Après avoir effectué la recherche, l'activité génère les propriétés dans un objet ChatMessage[] (Message) que vous pouvez utiliser comme variables d'entrée dans les activités suivantes (par exemple, ChatMessage(0).Id dans Obtenir les réponses au message, Répondre à un 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 à votre projet.
3. Complete one of the following two options (A or B):

A. Ajoutez une activité ou exécutez un processus externe qui génère une valeur Chat.Id (par exemple, Obtenir des chats).

B. 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, Obtenir les canaux).

1. Ajoutez l’activité Obtenir les messages à l’intérieur de l’activité Étendue Microsoft Teams .
2. Saisissez des valeurs pour les propriétés du canal ou du chat .
3. Créez et entrez une variable ChatMessage[] pour votre propriété Output .
4. Exécutez l’activité.

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

   • L'API renvoie la valeur ChatMessage[] à 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	Get Messages
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

Canal

ID d'équipe

ID de l'objet Team qui contient le canal à partir duquel vous souhaitez recevoir des messages.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ChatId est vide)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Pour obtenir la Team.Id valeur , utilisez un processus ou une activité externe qui inclut la Team.Id valeur dans sa sortie. Il estobligatoire de renseigner soit (ChatId), soit (IDd' équipe et ID de canal ).

Identifiant du canal

ID de l'objet Channel à partir duquel vous souhaitez recevoir le message.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si TeamId a une valeur)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Pour obtenir la Channel.Id valeur , utilisez un processus ou une activité externe qui inclut la Channel.Id valeur dans sa sortie. Il est obligatoirede renseigner soit (ChatId), soit (IDd' équipe et CanalId ) soit requis.

Messagerie

ChatId

ID de l'objet Chat dont vous souhaitez obtenir les messages.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (si ID d'équipe et ID du canal sont vides)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	Pour obtenir la valeur Chat.Id , utilisez un processus ou une activité externe qui inclut la valeur Chat.Id dans sa sortie. Il est obligatoire de renseigner soit ( ChatId ), soit (ID d'équipe et ID Canal) ).

Options

Limite

Le nombre maximal de messages récents à récupérer.

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

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

Messages

Tableau de messages (objet ChatMessage[] ) provenant de la conversation ou du canal spécifié.

Attributs	Détails (Details)
Saisie de texte	ChatMessage[]
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 ChatMessage[] .
Remarques	La variable que vous créez pour cette propriété peut être utilisée comme variable d'entrée dans les activités suivantes (par exemple, ChatMessage(0).Id dans Obtenir les réponses au message , Répondre à un 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, myMessages(0) ). L'objet ChatMessage comprend plusieurs propriétés 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 ChatMessage (par exemple, ODatatType ). 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 .