Obtenir des messages

Vue d'ensemble (Overview)

L'activité Obtenir un message ( Get Message ) appelle l'API Microsoft Graph GetChannelMessage ou GetChatMessage

pour récupérer un message spécifié (MessageId) à partir d'une conversation (ChatId) ou d'un canal (ChannelId) et d'une équipe (TeamID).

Après avoir effectué la recherche, l'activité génère ses propriétés dans un objet ChatMessage (Message) que vous pouvez utiliser comme variables d'entrée dans des activités ultérieures (p. ex., ChatMessage.Id dans Obtenir des réponses au message ( Get Message Replies), Répondre au message ( Reply To Message), etc.).

La différence entre cette activité et l'activité Get Messages réside dans l'exigence de saisir un message spécifique (IDMessage). La saisie de l ' IDMessage vous permet de récupérer un objet ChatMessage spécifique au lieu d'un tableau d'objets renvoyé dans l'activité Get Messages .

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 un message (Get Message ) à l’intérieur de l’activité Étendue Microsoft Teams (Microsoft Teams Scope ).
2. Saisissez des valeurs pour les propriétés Canal OU Chat (Channel OR Chat ) et Entrée ( Input ).
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 GetChannelMessage ou GetChatMessage .
   • 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 auquel vous souhaitez envoyer le message.

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.

Entrée

IDMessage

L'ID du message 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 Message.Id , utilisez un processus ou une activité externe qui inclut la valeur Message.Id dans sa sortie (par exemple, Obtenir des messages ou 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

Message

L'objet ChatMessage qui représente le message spécifié dans la propriété MessageId .

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 (par exemple, Obtenir des réponses au message ( Get Message Replies), Répondre au message ( Reply To Message), etc.). 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 .