Quickstart - Get teams, channels, and messages

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple de travail qui utilise différentes activités Microsoft Teams, notamment les activités Obtenir les équipes ( Get Teams), Obtenir les canaux ( Get Channels), Obtenir les messages ( Get Messages) et les activités.

Cet exemple de travail vous permet de vérifier rapidement la connexion à votre application Microsoft Teams enregistrée et de vous familiariser avec les types de données d'entrée/de sortie de l'activité.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Établit une connexion à votre application Microsoft Teams enregistrée (Étendue Microsoft Teams).
2. Recherche et renvoie une équipe qui correspond à votre requête de recherche d'équipe ( Obtenir des équipes (Get Teams) ).
3. Recherche et renvoie le canal de l'équipe que vous avez spécifié qui correspond à votre requête de recherche (Obtenir des canaux).
4. Récupère tous les messages du canal spécifié ( Obtenir des messages (Get Messages) ).

5. Vérifie que les messages ont été récupérés en sortant le contenu du corps du message et en renvoyant toutes les réponses au message (For Each and Write Line et Get Message Replies).

   
   

   

   
   

Prérequis

Avant de commencer :

1. Terminez les étapes de configuration de Microsoft Teams.

2. Créez ou utilisez une équipe et un canal existants, envoyez au moins un message et répondez à ce message.

   • Pour utiliser les mêmes valeurs que nous dans ce guide, créez et envoyez les éléments suivants :

     • Nom de l’équipe : Quickstart_Test1
     • Canal : QS4_Channel
     • Message 1 : Bonjour de la part d’UiPath !
     • Réponse 1 : Hé, hé, hé
     • Réponse 2 : Très heureux d'être ici !
     • Message 2 : À quelle heure est la réunion ?
     • Réponse 1 : 11 h

Étapes

Construisez votre projet

1. Ajoutez l’activité Étendue Microsoft Teams ( Microsoft Teams Scope ) à votre projet.

2. Saisissez l ' IDApplication de votre application enregistrée.

   • Pour plus d'informations, consultez la section Enregistrer votre application dans le Guide de configuration .

3. Dans la liste déroulante TypeAuthentification ( AuthenticationType ), sélectionnez le flux d'authentification applicable (par exemple, InteractiveToken).

   • Pour plus d'informations, consultez la page d'activité Automatisation assistée vs. Automatisation assistée dans l' étendue Microsoft Teams (Unattended vs. Attended ).
4. Ajoutez l’activité Obtenir les équipes après l’activité Étendue Microsoft Teams .
5. Sélectionnez le type d'équipes que vous souhaitez récupérer dans la liste déroulante TypeListe (par ex. MyJoinedTeams)

6. Saisissez vos options de requête pour rechercher une équipe spécifique dans votre liste d'équipes (par exemple, {New QueryOption("filter", "displayName eq 'Team Name'")}).

   • Pour plus d'informations, consultez la section QueryOptions dans la page d'activité Obtenir les équipes ( Get Teams ).
7. Créez et entrez une variable Team[] pour votre valeur Teams (par exemple, myTeams).
   • Lors de la création de votre variable, sélectionnez Microsoft.Graph.Team comme type de variable.
8. Ajoutez l’activité Obtenir les canaux après l’activité Obtenir les équipes .

9. Saisissez vos options de requête pour rechercher un canal spécifique de votre équipe (par exemple, {New QueryOption("filter", "displayName eq 'Channel Name'")}).

   • Pour plus d'informations, consultez la section QueryOptions dans la page d'activité Get Channels .
10. Dans la propriété TeamId , entrez la variable Team[] que vous avez créée pour l'activité Get Teams . Pour saisir une valeur String , spécifiez l'élément dans le tableau et ajoutez .Id à la fin de la variable (par exemple, myTeams(0).Id).
11. Créez et entrez une variable Channel[] pour votre valeur Canaux (par exemple, myChannels).
    • Lors de la création de votre variable, sélectionnez Microsoft.Graph.Channel comme type de variable.
12. Ajoutez l'activité Get Messages après l'activité Get Channels .
13. Dans la propriété ChannelId , entrez la variable Channel[] que vous avez créée pour l'activité Get Channels . Pour saisir une valeur String , spécifiez l'élément dans le tableau et ajoutez .Id à la fin de la variable (par exemple, myChannels(0).Id).
14. Dans la propriété TeamId , entrez la variable Team[] que vous avez créée pour l'activité Get Teams . Pour saisir une valeur String , spécifiez l'élément dans le tableau et ajoutez .Id à la fin de la variable (par exemple, myTeams(0).Id).
15. Pour limiter le nombre de messages générés, saisissez un nombre faible dans la propriété Limite (Limit) (par exemple, 5).
16. Créez et entrez une variable ChatMessage[] pour votre valeur Messages (par exemple, myMessages).

    • Lors de la création de votre variable, sélectionnez Microsoft.Graph.ChatMessage comme type de variable.

      
      

      

      
      

Tester votre projet

1. Pour tester que vos activités ont récupéré l'équipe, le canal et les messages, ajoutez une activité For Each après l'activité Get Messages .

   1. Dans la propriété TypeArgument , sélectionnez Microsoft.Graph.ChatMessage.
   2. Dans la propriété Valeurs (Values), entrez la variable ChatMessage[] que vous avez créée pour l'activité Obtenir les messages ( Get Messages ) (par exemple, myMessages).

2. Dans l'activité For Each , ajoutez une activité Write Line .

   1. Dans la propriété Texte (Text), saisissez « Message : » + item.Body.Content

3. Ajoutez l'activité Get Message Replies après l'activité Write Line .

   1. Dans la propriété ChannelId , entrez la variable Channel[] que vous avez créée pour l'activité Get Channels . Pour saisir une valeur String , spécifiez l'élément dans le tableau et ajoutez .Id à la fin de la variable (par exemple, myChannels(0).Id).
4. Pour limiter le nombre de messages générés, saisissez un nombre faible dans la propriété Limite (Limit) (par exemple, 2).
5. Dans la propriété IDMessage , entrez IDÉlément pour obtenir les réponses de chacun des messages récupérés.
6. Dans la propriété TeamId , entrez la variable Team[] que vous avez créée pour l'activité Get Teams . Pour saisir une valeur String , spécifiez l'élément dans le tableau et ajoutez .Id à la fin de la variable (par exemple, myTeams(0).Id).
7. Créez et entrez une variable ChatMessage[] pour votre valeur MessageReplies (par exemple, myReplies).
   • Lors de la création de votre variable, sélectionnez _Microsoft.Graph.ChatMessage_comme type de variable.

8. Ajoutez une autre activité For Each après l'activité Get Message Replies .

   1. Dans la propriété TypeArgument , sélectionnez Microsoft.Graph.ChatMessage.
   2. Dans la propriété Valeurs (Values), entrez la variable ChatMessage[] que vous avez créée pour l'activité Obtenir des réponses aux messages ( Get Message Replies ) (par exemple, myReplies).

9. Dans l'activité For Each , ajoutez une activité Write Line .

   1. Dans la propriété Text , saisissez "Reply: "+ item.Body.Content

10. Cliquez sur Exécuter ( Run) et vérifiez que la fenêtre Sortie (Output) inclut vos messages et leurs réponses associées.

    
    

    

    
    

Vous avez terminé !

Lorsque vous êtes prêt, essayez les autres guides de démarrage rapide pour vous familiariser avec les différentes activités Microsoft Teams.

Pour en savoir plus sur les activités Microsoft Teams (y compris des exemples d’entrées/sorties de propriétés), consultez les pages d’activités suivantes pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.

• Équipe