Einrichten

Einleitung

Um die Microsoft Teams-Aktivitäten zu aktivieren, muss Ihre App in die Microsoft Identity-Plattform integriert sein und die richtigen Microsoft Graph API-Berechtigungen zugewiesen haben.

Um Ihre Anwendung zu integrieren, Berechtigungen zuzuweisen und mit dem Erstellen Ihres Automatisierungsprojekts zu beginnen, müssen Sie sich zuerst entscheiden, ob Sie Ihre eigene App erstellen oder die UiPath-App verwenden (z. B. UiPathStudioO365App).

Wichtig: Wenn Sie die UiPath-App verwenden, müssen Sie sicherstellen, dass Sie die Zustimmung des Administrators hinzufügen.

Wenn Sie keine Administratorzustimmung hinzufügen, wird der folgende Fehler angezeigt.

Wenn Sie Ihre eigene App erstellen, müssen Sie die folgenden Schritte ausführen.

Nach der Registrierung Ihrer Microsoft Office Teams-Anwendung weist Azure Active Directory eine eindeutige Anwendungs-(Client-)ID zu, die Sie im Microsoft Office Teams Scope eingeben.

Hinweis:

Wenn Sie die Microsoft Office 365-Aktivitäten bereits abgeschlossen haben oder bereits eine registrierte Anwendung haben, können Sie direkt zum Abschnitt API-Berechtigungen hinzufügen gehen und die erforderlichen Berechtigungen für die Microsoft Teams-Aktivitäten hinzufügen.

Nachdem Sie die Berechtigungen hinzugefügt haben, können Sie dieselbe ApplicationID sowohl in den Aktivitäten Microsoft Office 365 Scope als auch Microsoft Teams Scope verwenden.

Schritte

1. Registrieren Sie Ihre Anwendung

1. Melden Sie sich mit Ihrem persönlichen, geschäftlichen oder schulischen Microsoft Office 365-Konto beim Azure-Portal an.
2. Klicken Sie im linken Navigationsbereich auf Azure Active Directory.
3. Nachdem die Seite Azure Active Directory geöffnet wurde, klicken Sie auf App-Registrierungen.

4. Klicken Sie in der oberen Navigationsleiste auf + Neue Registrierung .

   
   

   

   
   
5. Geben Sie einen Namen für Ihre Anwendung ein (z. B. „Office365App“).

6. Wählen Sie unter Unterstützte Kontotypen die Option aus, die auf Sie zutrifft.

   • Weitere Informationen zur Auswahl der Option finden Sie in den Empfehlungen von Microsoft:

     • Nur Konten in diesem Organisationsverzeichnis – Verwenden Sie diese Option, wenn Ihre Zielgruppe innerhalb Ihrer Organisation liegt.
     • Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Azure AD-Verzeichnis – Mehrinstanzenfähig) – Verwenden Sie diese Option, wenn Ihre Zielgruppe Geschäfts- oder Bildungskunden sind, und um die Mehrmandantenfähigkeit zu aktivieren.
     • Konten in einem beliebigen Organisationsverzeichnis (Beliebiges Azure AD-Verzeichnis – Mehrinstanzenfähig) und persönliche Microsoft-Konten (z. B. Skype, Xbox) – Verwenden Sie diese Option, um auf die breiteste Gruppe von Microsoft-Identitäten abzuzielen und die Mehrmandantenfähigkeit zu aktivieren.
   • Geben Sie unter Umleitungs-URI (optional)eine URI-Adresse ein (falls zutreffend).
   • Ihre Auswahl hängt von Ihrem Authentifizierungstyp ab. Weitere Informationen zu diesem Thema finden Sie auf der Seite mit den Details zur unbeaufsichtigten und beaufsichtigten Automatisierung .
   • In unserem Beispiel unterstützt die Organisation die mandantenfähige Authentifizierung und kann nur den Authentifizierungstyp Interactive Token verwenden, der einen Umleitungs-URI erfordert.
   • Wenn Ihr Authentifizierungstyp Integrierte Windows-Authentifizierung oder Benutzername und Kennwort ist, müssen Sie keinen Umleitungs-URI für Ihre Anwendung registrieren. Diese Flows führen einen Roundtrip zum Microsoft Identity Platform v2.0-Endpunkt durch, und Ihre Anwendung wird nicht für einen bestimmten URI zurückgerufen.
   • Weitere Informationen finden Sie unter Desktop-App-Registrierung in der Dokumentation zur Microsoft Identity-Plattform.

7. Klicken Sie auf Registrieren.

   
   

   

   
   
   Hinweis:

   Heute verwendet die Microsoft-Authentifizierungsbibliothek (MSAL.NET) urn:ietf:wg:oauth:2.0:oob als Standardumleitungs-URI. Dieser Wert wird wahrscheinlich für Sie funktionieren, wenn Sie den InteractiveToken-Authentifizierungstyp verwenden (dies verwenden wir in allen unseren Beispielen). und Schnellstartanleitungen).

   Für die Zukunft plant Microsoft, den Standardumleitungs-URI in https://<span>login.microsoftonline.com/common/oauth2/nativeclient</span> zu ändern. Sie können daher stattdessen dies verwenden.

Fertig! Jetzt fügen wir Ihrer registrierten Anwendung API-Berechtigungen hinzu.

2. API-Berechtigungen hinzufügen

1. Klicken Sie auf der Seite Ihrer registrierten Anwendung (Azure-Portal > Azure Active Directory > App-Registrierungen > Office365App) im linken Navigationsbereich auf API-Berechtigungen .
2. Nachdem die Seite API-Berechtigung geöffnet wurde, klicken Sie auf + Berechtigung hinzufügen (dadurch wird das Fenster API -Berechtigungen anfordern geöffnet).
3. Klicken Sie unter APIauswählen auf Microsoft-APIs (kann standardmäßig geöffnet sein).

4. Klicken Sie unter Häufig verwendete Microsoft-APIsauf Microsoft Graph.

   
   

   

   
   

5. Klicken Sie unter Welcher Berechtigungstyp erfordert Ihre Anwendung?, klicken Sie auf Delegierte Berechtigungen , um die Liste der Berechtigungen anzuzeigen.

   • Während die Anwendungsberechtigungen auch funktionieren, sind die Aktivitäten für Apps mit delegierten Berechtigungen konzipiert, die den Microsoft Graph-APIs zugewiesen sind.
   • Weitere Informationen zu Berechtigungstypen finden Sie unter Konfigurieren einer Clientanwendung für den Zugriff auf Web-APIs in der Microsoft Azure-Dokumentation.

6. Verwenden Sie die Suchleiste oder scrollen Sie in der alphabetischen Liste nach unten und wählen Sie die folgenden Berechtigungen aus:

   • Chat.ReadWrite
   • Group.ReadWrite.All
   • Benutzer.Alle.Lesen

7. Klicken Sie auf Berechtigungen hinzufügen (Sie kehren zu Ihrer Liste der API-Berechtigungenzurück).

   
   

   

   
   

8. Stellen Sie sicher, dass Ihre API-Berechtigungen Ihre hinzugefügten Chat-, Gruppen- und Benutzerberechtigungen enthalten.

   
   

   

   
   

3. Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.
   2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
   3. Geben Sie einen Projektnamen, einenSpeicherortund eine Beschreibungein.

   4. Klicken Sie auf Erstellen.

      
      

      

      
      

2. Installieren Sie das UiPath.MicrosoftTeamsActivities -Paket.

   1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
   2. Klicken Sie unter Alle Paketeauf Los!
   3. Geben Sie in der Suchleiste Teams ein.

   4. Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für die UiPath.Teams.Activities.

      • Weitere Informationen zu UiPath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

        
        

        

        
        

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit dem Hinzufügen der Microsoft Teams-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Wenn Sie etwas praxisbezogenes lernen und die Aktivitäten schnell einsetzen möchten, sehen Sie sich die Schnellstartanleitungen an. Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, die Ihnen helfen sollen, Arbeitsbeispiele für die verschiedenen Aktivitäten zu erstellen, damit Sie die Verbindung zu Ihrer registrierten App überprüfen können und machen Sie sich mit den Eingabe-/Ausgabeeigenschaften vertraut.

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.

• Kanäle
• Chats
• Messages
• Teams