Einrichten

This setup is required when using the classic Microsoft 365 activities. If you are using the newer Microsoft 365 activities with Integration Service connections, see.…

Einleitung

Um die Microsoft Office 365-Aktivitäten zu aktivieren, muss Ihre App in die Microsoft Identity Platform integriert sein und ihr müssen die richtigen Microsoft Graph-API-Berechtigungen zugewiesen sein.

Führen Sie die folgenden Schritte aus, um Ihre Anwendung zu integrieren, Berechtigungen zuzuweisen und mit der Erstellung Ihres Automatisierungsprojekts zu beginnen:

Registrieren Sie Ihre Anwendung.
Fügen Sie API-Berechtigungen hinzu.
Erstellen Sie Ihr Projekt.

Nach der Registrierung Ihrer Microsoft Office 365-Anwendung weist Azure Active Directory eine eindeutige Anwendungs-(Client-)ID zu, die Sie in der Aktivität Microsoft Office 365 Scope zusammen mit den Diensten eingeben, denen Sie Berechtigungen zugewiesen haben (z. B. Dateien, E-Mail, Kalender).

Schritte

Registrieren Sie Ihre Anwendung

Melden Sie sich mit Ihrem persönlichen, geschäftlichen oder schulischen Microsoft Office 365-Konto beim Azure-Portal an.
Klicken Sie im linken Navigationsbereich auf Azure Active Directory.
Nachdem die Seite Azure Active Directory geöffnet wurde, klicken Sie auf App-Registrierungen.
Klicken Sie in der oberen Navigationsleiste auf + Neue Registrierung .
Geben Sie einen Namen für Ihre Anwendung ein (z. B. „Office365App“).
Wählen Sie unter UnterstützteKontotypen die für Sie zutreffende Option aus. Weitere Informationen zur Auswahl der Option finden Sie unten 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 im Abschnitt Unattended- und Attended-Automatisierung auf der Seite mit den Details zur Aktivität Microsoft 365 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.
- Bei der Arbeit mit Office 365 in einem UiPath Studio-Projekt, das auf .NET 5.0abzielt, sollten die Clients http://localhost zum Umleitungs-URI ihrer benutzerdefinierten Anwendungen hinzufügen.
  
  Weitere Informationen finden Sie unter Desktop-App-Registrierung in der Dokumentation zur Microsoft Identity Platform.
Klicken Sie auf Registrieren. Eine Beispielkonfiguration ist im Screenshot unten verfügbar.
Hinweis: Diese Einrichtung ist nur ein Beispiel. Führen Sie die in der Dokumentation beschriebenen Schritte aus, und treffen Sie eine Auswahl basierend auf den Richtlinien Ihrer Organisation.

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

In Zukunft plant Microsoft, den Standard-Umleitungs-URI in https://login.microsoftonline.com/common/oauth2/nativeclientzu ändern, sodass Sie möglicherweise stattdessen diesen verwenden.

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

API-Berechtigungen hinzufügen

Klicken Sie auf der Seite Ihrer registrierten Anwendung (Azure-Portal > Azure Active Directory > App-Registrierungen > Office365App) im linken Navigationsbereich auf API-Berechtigungen .
Nachdem die Seite API-Berechtigung geöffnet wurde, klicken Sie auf + Berechtigung hinzufügen (dadurch wird das Fenster API -Berechtigungen anfordern geöffnet).
Klicken Sie unter APIauswählen auf Microsoft-APIs (kann standardmäßig geöffnet sein).
Klicken Sie unter Häufig verwendete Microsoft-APIsauf Microsoft Graph.
Unter Welche Art von Berechtigungen erfordert Ihre Anwendung?, klicken Sie auf Delegierte Berechtigungen oder Anwendungsberechtigungen , um die Liste der Berechtigungen anzuzeigen. Anwendungsberechtigungen müssen festgelegt werden, wenn der Wert von AuthenticationType in der Microsoft Office 365 Scope -Aktivität auf ApplicationIdAndSecret oder ApplicationIdAndCertificatefestgelegt ist. Die anderen Authentifizierungstypen, die in der Aktivität Microsoft Office 365 Scope verfügbar sind, erfordern delegierte Berechtigungen.

Weitere Informationen zu Berechtigungstypen finden Sie unter Konfigurieren einer Clientanwendung für den Zugriff auf Web-APIs in der Microsoft Azure-Dokumentation.

Wichtig:
Einige Aktivitäten unterstützen den Authentifizierungstyp ApplicationIdAndSecret oder ApplicationIdAndCertificate nicht (z. B Besprechungszeiten finden).

Bei E-Mail-Aktivitäten muss ein Wert für den Parameter Account angegeben werden (d. h. welches Postfach aller Mandantenpostfächer Sie verwenden möchten).

Bei Verwendung dieses Authentifizierungstyps hat die Anwendung Zugriff auf alle Postfächer Ihres Mandanten. Der Grund dafür ist, dass die Anwendungs-API-Berechtigung Mail.Read E-Mails in allen Postfächern lesen und Mail.ReadWrite E-Mails in allen Postfächern lesen und schreibenbedeutet.

Eine Lösung besteht darin, Anwendungsberechtigungen auf bestimmte Postfächer zu beschränken, sodass die Anwendung nur Zugriff auf die angegebenen Postfächer hat.

Weitere Informationen finden Sie unter Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer festlegen.

Verwenden Sie die Anwendungsberechtigung Sites.Selected , um der Anwendung den Zugriff nur auf die bestimmten SharePoint-Websitesammlungen und nicht auf alle zu ermöglichen.
Verwenden Sie die Suchleiste oder scrollen Sie in der alphabetischen Liste nach unten und wählen Sie die folgenden Berechtigungen aus:
- Kalender
  - Kalender.Lesen
  - Calendars.ReadWrite
- Dateien
  - Files.Read
  - Files.Read.All
  - Files.ReadWrite
  - Files.ReadWrite.All
- Websites
  - Sites.Read.All
  - Sites.ReadWrite.All
- E-Mail (Mail)
  - Mail.Read
  - Mail.ReadWrite
  - Mail.Send
- Freigegeben\*
  - Mail.Read.Shared
  - Mail.ReadWrite.Shared
  - Mail.Send.Shared
  - Calendars.Read.Shared
  - Calendars.ReadWrite.Shared
    
    \* Bereiche, die für den Zugriff auf Ressourcen erforderlich sind, die für den Benutzer freigegeben sind, aber nicht in dessen Besitz sind.
- Klicken Sie auf Berechtigungen hinzufügen (Sie kehren zu Ihrer Liste der API-Berechtigungenzurück).
Stellen Sie sicher, dass Ihre API-Berechtigungen Ihre hinzugefügten Berechtigungen Kalender, Dateienund E- Mail umfassen.

Erstellen Sie Ihr Projekt

Erstellen Sie ein neues Automatisierungsprojekt.
- Öffnen Sie UiPath Studio.
- Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
- Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.
- Klicken Sie auf Erstellen.
Installieren Sie das Paket UiPath.MicrosoftOffice365.Activities .
- Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
- Klicken Sie unter Alle Paketeauf Los!
- Geben Sie in der Suchleiste Office365ein.
- Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für UiPath.MicrosoftOffice365.Activities.
  
  Weitere Informationen zu Uipath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

Alles erledigt!

Nachdem Sie das Setup abgeschlossen haben, können Sie mit dem Hinzufügen der Microsoft Office 365-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Für eine praxisbezogene Lernerfahrung und für einen schnellen Einstieg in die Verwendung der Aktivitäten, sehen Sie sich die Schnellstartanleitungen an. Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, mit denen Sie Arbeitsbeispiele für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung mit Ihrer registrierten App überprüfen und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu den Microsoft Office 365-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Hauptseite der Aktivitäten. Dort finden Sie eine vollständige Aktivitätsliste und Links zu den Detailseiten der Aktivität.

Auf dieser Seite