Obtenir des messages

Vue d'ensemble (Overview)

L'activité Obtenir le message appelle l'API ObtenirChannelMessage ou ObtenirChatMessage de Microsoft Graph

pour récupérer un message spécifié (MessageId) à partir d'un chat ou d'un canal (ChannelId) et d'une équipe (ÉquipeID).

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 les activités suivantes (par exemple, ChatMessage.Id dans Obtenir les réponses au message, Répondre au message, etc.).

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

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

4. Ajoutez l’activité Obtenir le message à l’intérieur de l’activité Étendue Microsoft Teams .

5. Saisissez des valeurs pour les propriétés Canal OU Chat et Entrée .

6. Créez et entrez une variable ChatMessage 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 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 Teams ou appel d’API externe) Il est obligatoire de spécifier soit (ChatId), soit (TeamId et ChannelId).

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 les canaux ou l’appel d’API externe) Il est obligatoire de spécifier soit (ChatId), soit (TeamId et ChannelId).

Messagerie

ChatId

ID de l'objet Chat auquel vous souhaitez envoyer le message.

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 (par exemple, Obtenir des chats ou un appel API externe) Il est obligatoire de spécifier soit (ChatId), soit (TeamId et ChannelId).

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 un appel d'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é IDMessage .

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	The variable you create for this property can be used as an input variable in subsequent activities (e.g., Get Message Replies, Reply To Message, etc.). The ChatMessage object includes multiple properties that you can use in other activities.The example image below shows some of the properties that you can return. 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 et des exemples étape par étape, consultez les guides de démarrage rapide .