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 zunächst 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 Administratorzustimmung 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-ID (Client) 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.

Nach dem Hinzufügen der Berechtigungen können Sie dieselbe AnwendungsID sowohl in den Aktivitäten Microsoft Office 365 Scope als auch in 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. In the left-hand navigation panel, click Azure Active Directory.

3. After the Azure Active Directory page opens, click App registrations.

4. Click + New registration in the top navigation bar.

   

5. Enter a Name for your application (e.g., "Office365App").

6. Under Supported account types, select the option that applies to you.

   • 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.
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • Ihre Auswahl hängt vom Authentifizierungstyp ab. Weitere Informationen zu diesem Thema finden Sie unter Unattended- und Attended-Automatisierung auf der Seite mit den Details zur Aktivität „Microsoft Teams Scope “.
   • 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. Click Register.

   

   Hinweis:

   Today the Microsoft Authentication Library (MSAL.NET) uses urn:ietf:wg:oauth:2.0:oob as the default redirect URI and this value will likely work for you when using the InteractiveToken authentication type (we use this in all of our examples and Quickstart guides).

   In the future, Microsoft plans to change the default redirect URI to https://login.microsoftonline.com/common/oauth2/nativeclient, so you may consider using this instead.

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

2. Add API permissions

1. Klicken Sie auf Ihrer Seite der registrierten Anwendung (Azure-Portal > Azure Active Directory > App-Registrierungen > Office365App) im linken Navigationsbereich auf API-Berechtigungen .

2. After the API permission page opens, click + Add a permission (this opens the Request API permissions window).

3. Under Select an API, click Microsoft APIs (may be open by default).

4. Under Commonly used Microsoft APIs, click Microsoft Graph.

   

5. Wählen Sie unter Welcher Berechtigungstyp benötigt Ihre Anwendung? klicken Sie auf Delegierte Berechtigungen , um die Liste der Berechtigungen anzuzeigen.

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • 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. Click Add permissions (returning you to your list of API permissions)

   

8. Überprüfen Sie, ob Ihre API-Berechtigungen die hinzugefügten Berechtigungen für Chat, Gruppe und Benutzer enthalten.

   

3. Erstellen Sie Ihr Projekt

1. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Klicken Sie auf Erstellen (Create).

      

2. Installieren Sie das UiPath.MicrosoftTeamsActivities -Paket.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. Geben Sie in der Suchleiste Teams.
   4. Klicken, 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 „Learning by doing“ möchten und die Aktivitäten schnell einsetzen möchten, sehen Sie sich die Schnellstartanleitungen an. Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, mit denen Sie funktionierende Beispiele für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung zu Ihrer registrierten App überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

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