Get Messages

Vue d'ensemble (Overview)

L'activité Get Messages (Obtenir les messages) appelle l'API Microsoft Graph ListChatMessages ou ListChannelMessages

pour récupérer tous les messages d'un chat (ChatId) ou d'un canal (ChannelId) et d'une équipe (TeamID) spécifiés.

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 des activités ultérieures (par exemple, ChatMessage(0).Id dans Obtenir des réponses au message ( Get Message Replies), Répondre au message ( Reply To 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. Remplissez l'une des deux options suivantes (A ou B) :

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

B. 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, Get Channels).

1. Ajoutez l’activité Obtenir des messages (Get Messages ) à l’intérieur de l’activité Étendue Microsoft Teams (Microsoft Teams Scope ).
2. Entrez les valeurs des propriétés Canal OU Chat .
3. Créez et entrez une variable ChatMessage[] pour votre propriété Output (Sortie).

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 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) Soit (ChatId), soit (TeamId et ChannelId) sont requis.

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 valeur Channel.Id , utilisez un processus ou une activité externe qui inclut la valeur Channel.Id dans sa sortie (par exemple, Obtenir des canaux ou un appel API externe) Soit (ChatId), soit (TeamId et ChannelId) sont 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 TeamId et ChannelId 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 (par exemple, Get Chats ou un appel API externe) Soit (ChatId), soit (TeamId et ChannelId) sont requis.

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 des activités ultérieures (p. ex., ChatMessage(0).Id dans Obtenir des réponses au message ( Get Message Replies), Répondre au message ( Reply To 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 inclut plusieurs propriétés 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 ChatMessage (par exemple, ODatatType). 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 .