Quickstart - Get teams, channels, and messages

Überblick

Dieser Leitfaden soll Sie bei der Erstellung eines funktionierenden Beispiels unterstützen, das verschiedene Microsoft Teams-Aktivitäten verwendet, einschließlich der Aktivitäten Get Teams, Get Channels, Get Messages und der Aktivitäten.

Mit diesem Arbeitsbeispiel können Sie die Verbindung mit Ihrer registrierten Microsoft Teams-Anwendung schnell überprüfen und sich mit den Eingabe-/Ausgabedatentypen der Aktivität vertraut machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Stellt eine Verbindung mit Ihrer registrierten Microsoft Teams-Anwendung (Microsoft Teams Scope) her.
2. Sucht ein Team, das Ihrer Teamsuchabfrage entspricht, und gibt es zurück (Get Teams).
3. Sucht einen Kanal in Ihrem angegebenen Team, der Ihrer Kanalsuchabfrage entspricht (Get Channels) und gibt ihn zurück.
4. Ruft alle Nachrichten aus dem angegebenen Kanal ab (Nachrichten abrufen).

5. Überprüft, ob die Nachrichten abgerufen wurden, indem der Inhalt des Nachrichtentexts ausgegeben und alle Nachrichtenantworten zurückgegeben werden (For Each und Write Line und Get Message Replies).

   
   

   

   
   

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Einrichten von Microsoft Teams ab.

2. Erstellen oder verwenden Sie ein vorhandenes Team und einen Kanal, senden Sie mindestens eine Nachricht, und antworten Sie auf diese Nachricht.

   • Um die gleichen Werte wie in dieser Anleitung zu verwenden, erstellen und senden Sie Folgendes:

     • Teamname: Quickstart_Test1
     • Kanal: QS4_Channel
     • Nachricht 1: Hallo von UiPath!
     • Antwort 1: Hey, hey, hey
     • Antwort 2: Wir freuen uns, hier zu sein!
     • Meldung 2: Wann ist die Besprechung?
     • Antwort 1: 11:00

Schritte

Erstellen Sie Ihr Projekt

1. Fügen Sie die Aktivität Microsoft Teams Scope zu Ihrem Projekt hinzu.

2. Geben Sie die AnwendungsID für Ihre registrierte Anwendung ein.

   • Weitere Informationen finden Sie im Abschnitt Registrieren Ihrer Anwendung in der Setup- Anleitung.

3. Wählen Sie aus der Dropdownliste Authentifizierungstyp den anwendbaren Authentifizierungsablauf aus (z. B. InteractiveToken).

   • Weitere Informationen finden Sie auf der Aktivitätsseite „ Unattended vs. Attended “ auf der Aktivitätsseite Microsoft Teams Scope .
4. Fügen Sie die Aktivität Get Teams nach der Aktivität Microsoft Teams Scope hinzu.
5. Wählen Sie den Typ der Teams aus, die Sie von der Dropdownliste Listentyp abrufen möchten (z. B MyJoinedTeams)

6. Geben Sie Ihre QueryOptions ein, um ein bestimmtes Team aus Ihrer Teamliste zu finden (z. B. {New QueryOption("filter", "displayName eq 'Team Name'")}).

   • Weitere Informationen finden Sie im Abschnitt QueryOptions auf der Aktivitätsseite Get Teams .
7. Erstellen und geben Sie eine Team[] -Variable für Ihren Teams -Wert ein (z. B. myTeams).
   • Wählen Sie beim Erstellen Ihrer Variablen Microsoft.Graph.Team als Variablentyp aus.
8. Fügen Sie die Aktivität Get Channels nach der Aktivität Get Teams hinzu.

9. Geben Sie Ihre QueryOptions ein, um einen bestimmten Kanal in Ihrem angegebenen Team zu finden (z. B. {New QueryOption("filter", "displayName eq 'Channel Name'")}).

   • Weitere Informationen finden Sie im Abschnitt QueryOptions auf der Aktivitätsseite Get Channels .
10. Geben Sie in der Eigenschaft TeamID die Variable Team[] ein, die Sie für die Aktivität Teams abrufen erstellt haben. Um einen String -Wert einzugeben, geben Sie das Element im Array an und hängen .Id am Ende der Variablen an (z. B. myTeams(0).Id).
11. Erstellen und geben Sie eine Channel[] -Variable für Ihren Kanalwert ein (z. B. myChannels).
    • Wählen Sie beim Erstellen Ihrer Variablen Microsoft.Graph.Channel als Variablentyp aus.
12. Fügen Sie die Aktivität Get Messages nach der Aktivität Get Channels hinzu.
13. Geben Sie in der Eigenschaft ChannelId die Variable Channel[] ein, die Sie für die Aktivität Get Channels erstellt haben. Um einen String -Wert einzugeben, geben Sie das Element im Array an und hängen .Id am Ende der Variablen an (z. B. myChannels(0).Id).
14. Geben Sie in der Eigenschaft TeamID die Variable Team[] ein, die Sie für die Aktivität Teams abrufen erstellt haben. Um einen String -Wert einzugeben, geben Sie das Element im Array an und hängen .Id am Ende der Variablen an (z. B. myTeams(0).Id).
15. Um die Anzahl der auszugebenden Meldungen zu begrenzen, geben Sie eine niedrige Zahl in die Eigenschaft Limit ein (z. B. 5).
16. Erstellen und geben Sie eine ChatMessage[] -Variable für Ihren Nachrichtenwert ein (z. B. myMessages).

    • Wählen Sie beim Erstellen Ihrer Variablen Microsoft.Graph.ChatMessage als Variablentyp aus.

      
      

      

      
      

Testen Sie Ihr Projekt

1. Um zu testen, ob Ihre Aktivitäten das Team, den Kanal und Nachrichten abgerufen haben, fügen Sie eine Für jede ( For Each )-Aktivität nach der Aktivität Nachrichten abrufen ( Get Messages ) hinzu.

   1. Wählen Sie in der Eigenschaft TypeArgument die Option Microsoft.Graph.ChatMessage aus.
   2. Geben Sie in der Eigenschaft Werte die Variable ChatMessage[] ein, die Sie für die Aktivität Nachrichten abrufen ( Get Messages ) erstellt haben (z. B. myMessages).

2. Fügen Sie in der Für jede -Aktivität eine Zeile schreiben ( Write Line )-Aktivität hinzu.

   1. Geben Sie in der Eigenschaft Text "Message: " + item.Body.Content

3. Fügen Sie die Aktivität Get Message Replies nach der Aktivität Write Line hinzu.

   1. Geben Sie in der Eigenschaft ChannelId die Variable Channel[] ein, die Sie für die Aktivität Get Channels erstellt haben. Um einen String -Wert einzugeben, geben Sie das Element im Array an und hängen .Id am Ende der Variablen an (z. B. myChannels(0).Id).
4. Um die Anzahl der auszugebenden Meldungen zu begrenzen, geben Sie eine niedrige Zahl in die Limit- Eigenschaft ein (z. B. 2).
5. Geben Sie in der Eigenschaft NachrichtenId Item.Id ein, um die Antworten der abgerufenen Nachrichten abzurufen.
6. Geben Sie in der Eigenschaft TeamID die Variable Team[] ein, die Sie für die Aktivität Teams abrufen erstellt haben. Um einen String -Wert einzugeben, geben Sie das Element im Array an und hängen .Id am Ende der Variablen an (z. B. myTeams(0).Id).
7. Erstellen und geben Sie eine ChatMessage[] -Variable für Ihren MessageReplies -Wert ein (z. B. myReplies).
   • Wählen Sie beim Erstellen Ihrer Variablen _Microsoft.Graph.ChatMessage_ als Variablentyp aus.

8. Fügen Sie eine weitere For Each -Aktivität nach der Aktivität Get Message Replies hinzu .

   1. Wählen Sie in der Eigenschaft TypeArgument die Option Microsoft.Graph.ChatMessage aus.
   2. Geben Sie in der Eigenschaft Werte die Variable ChatMessage[] ein, die Sie für die Aktivität Get Message Replies erstellt haben (z. B. myReplies).

9. Fügen Sie in der Für jede -Aktivität eine Zeile schreiben ( Write Line )-Aktivität hinzu.

   1. Geben Sie in der Eigenschaft Text „Reply:“ + item.Body.Content

10. Klicken Sie auf Ausführen und überprüfen Sie, ob das Fenster Ausgabe ( Output ) Ihre Nachrichten und die zugehörigen Antworten enthält.

    
    

    

    
    

Alles erledigt!

Wenn Sie bereit sind, lesen Sie die anderen Schnellstartanleitungen , um sich mit den verschiedenen Microsoft Teams-Aktivitäten vertraut zu machen.

Weitere Informationen zu den Microsoft Teams-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf den folgenden Aktivitätsseiten mit einer vollständigen Aktivitätsliste und Links zu den Aktivitätsdetailseiten.

• Teams