Microsoft Office 365 Scope

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

Beschreibung

Verwendet die Microsoft Identity-Plattform, um eine authentifizierte Verbindung zwischen UiPath und Ihrer Microsoft 365-Anwendung herzustellen. Diese authentifizierte Verbindung ermöglicht einem Roboter, die Microsoft Graph-API aufzurufen, um Ressourcen in Ihrem Namen zu lesen und zu schreiben.

Wichtig: Ab Version 2.5.5 können Sie die neueren Microsoft 365-Aktivitäten innerhalb der Scope-Aktivität verwenden. Informationen zur Verwendung der Integration Service-Aktivitäten mit Microsoft 365 Scope finden Sie unter Verwendung von Microsoft 365-Aktivitäten ohne Integration Service-Verbindungen.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Tipp: Auf dieser Seite werden die Authentifizierungsparameter erläutert, die in der Microsoft 365-Aktivität „Scope“ verfügbar sind. Weitere Informationen zu den einzelnen Authentifizierungsoptionen finden Sie im Handbuch zum Herstellen einer Verbindung mit Microsoft 365-Aktivitäten.

Um mit der Konfiguration dieser Aktivität zu beginnen, müssen Sie zuerst eine Verbindungsmethode auswählen. Je nach ausgewählter Methode werden dann unterschiedliche Felder im Eigenschaftenbereich angezeigt.

• Verbindungsmethode – Wählen Sie die Verbindungsmethode aus, die Sie verwenden möchten. Die im Dropdownmenü verfügbaren Optionen sind:
  • Eigenschaftenbereich – Konfigurieren Sie die Verbindungsdetails im Eigenschaftenbereich.
  • Asset – Verwenden Sie Orchestrator-Anmeldeinformationsassets. Wir empfehlen Ihnen, diese Option zu verwenden.

Asset-Verbindungsmethode

Hinweis: Wenn Sie diese Option auswählen, werden die meisten Authentifizierungsfelder ausgeblendet, die normalerweise im Eigenschaftenbereich angezeigt werden, da die Authentifizierungsinformationen innerhalb des Assets gespeichert werden.

• Verbindungs-Assets – Durchsuchen Sie die Orchestrator-Ordner, um ein Asset auszuwählen. Dieses Feld unterstützt IResource -Variablen. Wählen Sie die Schaltfläche Assets verwalten aus, um den Orchestrator zu öffnen. Die Liste der verfügbaren Assets hängt vom Orchestrator ab, mit dem Ihr Studio und Ihr Roboter verbunden sind.
  • Verwenden Sie das Schaltflächenmenü Plus, um Assets neu laden auszuwählen, wenn Sie Ihre Assets im Orchestrator aktualisiert haben. Beachten Sie Folgendes: Wenn Sie ein neues Asset im Orchestrator hinzufügen, während Studio Desktop verwendet wird, ist dieses nicht sofort in der Scope-Aktivität verfügbar.

• Siehe Asset-Format unter Verwenden von Microsoft 365-Aktivitäten ohne Integration Service-Verbindungen.

Je nach Authentifizierungstyp, der im Asset konfiguriert ist, müssen Sie auch die folgenden Felder konfigurieren, die im Eigenschaftenbereich verfügbar sind:

Authentication

• E-Mail-Adresse des Benutzers, dessen Identität angenommen wird – Die E-Mail-Adresse des Benutzers, dessen Identität angenommen wird. Wird für die Authentifizierungsmethoden Anwendungs-ID und Geheimschlüssel sowie Anwendungs-ID und Zertifikat verwendet.

Benutzername und Kennwort (Unattended)

• Benutzername – Der Benutzername Ihres Microsoft 365-Kontos. Wird für die Authentifizierungsmethode Benutzername und Kennwort verwendet.
• Kennwort – Das Kennwort Ihres Microsoft 365-Kontos.

Allgemein

• AuszeitMS (TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur interaktiven Authentifizierung (Zustimmungsdialogfeld) an, bevor ein Fehler ausgegeben wird. Dieses Feld unterstützt nur Integer- und Int32 -Variablen. Der Standardwert ist 30000 ms (30 Sekunden).

Laufzeit

• Runtime-Verbindungsassets – Durchsuchen, um ein Asset auszuwählen. In diesem Feld können Sie ein anderes Asset für die Laufzeit auswählen. Verwenden Sie das Schaltflächenmenü Plus, um Relativer Pfad auszuwählen, und geben Sie den vollständigen Pfad des Orchestrator-Assets ein, das die Verbindungsdetails enthält.

Verbindungsmethode für den Eigenschaftenbereich

Hinweis: Wenn Sie diese Option auswählen, müssen Sie die Authentifizierungsfelder konfigurieren, die im Eigenschaftenbereich verfügbar sind.

Konfigurieren Sie zunächst die folgenden Felder:

• Verbindungen – Wählen Sie ein Konto aus der Liste aus. Sie können Verbindungen hinzufügen, löschen und auswählen, welche verwendet werden sollen.
• Authentifizierungs-Scopes – Siehe Abschnitt Verwenden der Authentifizierungs-Scopes unten.

Verwenden des Assistenten für Authentifizierungs-Scopes

Hinweis: Dieser Assistent ersetzt den Parameter Services, der in früheren Versionen dieses Pakets verfügbar war. Der Assistent für Authentifizierungs-Scopes ist verfügbar, wenn Sie die interaktive Tokenauthentifizierung verwenden.

Die Aktivität Scope enthält einen universellen Berechtigungsselektor, der ein klares Bild aller verwendeten Authentifizierungs-Scopes bietet, die die Aktivitäten benötigen, um ordnungsgemäß zu funktionieren.

Alle untergeordneten Aktivitäten in der Aktivität Microsoft 365 Scope werden automatisch als erforderliche Scopes erkannt.

Wenn im Scopes-Assistenten keine Scopes manuell ausgewählt werden, wird die Funktion „Automatische Erkennung“ standardmäßig zur Laufzeit angewendet; die Konfiguration des Assistenten ist nicht mehr erforderlich. Alle minimal erforderlichen Scopes werden zur Laufzeit ausgewählt.

Sie können einen Scope auch manuell hinzufügen, nachdem Sie eine untergeordnete Aktivität zu Microsoft 365 Scope hinzugefügt haben.

Als Nächstes müssen Sie den Authentifizierungstyp aus dem Eigenschaftenbereich auswählen und die für Ihre bevorzugte Authentifizierungsmethode erforderlichen Felder konfigurieren. In den folgenden Abschnitten sind die Felder aufgeführt, die unter jedem Menü verfügbar sind.

Authentication

• Authentifizierungstyp – Der für Ihre registrierte Anwendung erforderliche Authentifizierungstyp. Wählen Sie eine der fünf Optionen aus: Interaktives Token, Integrierte Windows-Authentifizierung (IWA), Benutzername und Kennwort, Anwendungs-ID und Geheimschlüssel oder Anwendungs-ID und Zertifikat. Der Standardwert ist „Interaktives Token“.
• Umgebung – Die Umgebung. Entweder Azure Global oder nationale Clouds, bei denen es sich um eindeutige und von Azure Global getrennte Umgebungen handelt. Wählen Sie eine der fünf Optionen aus: Standard, Global, China, Deutschland oder US-Regierung. Der Standardwert ist Global.
• Anwendungs-ID – Die eindeutige Anwendungs-(Client-)ID, die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während des Setups registriert haben. Die Anwendungs-(Client-)ID stellt eine Instanz einer Microsoft 365 -Anwendung dar.
• Mandant – Die eindeutige Verzeichnis-(Mandanten-)ID, die von Azure Active Directory zugewiesen wurde, als Sie Ihre App während des Setups registriert haben. Erforderlich für Anwendungen mit mehreren Mandanten und integrierte Windows-Authentifizierung. Die Verzeichnis-ID (Mandant) finden Sie auf der Übersichtsseite Ihrer registrierten Anwendung (unter der Anwendungs-(Client-)ID).
• E-Mail-Adresse des Benutzers, dessen Identität angenommen wird – Die E-Mail-Adresse des Benutzers, dessen Identität angenommen wird. Wird für Unattended-Szenarien (für die Authentifizierungsmethoden Anwendungs-ID und Geheimschlüssel sowie Anwendungs-ID und Zertifikat) verwendet.

Interaktives Token

Hinweis: Dies ist dieselbe Authentifizierungsmethode, die im Integration Service unterstützt wird, entweder über die öffentliche UiPath-App oder eine private benutzerdefinierte Anwendung (Bring Ihre eigene App-Methode mit).

Weitere Informationen finden Sie unter Interaktive Token.

• OAuthClient – Gibt die zu verwendende Anwendung (Client) an. Dieses Feld unterstützt nur OAuthApplication-Variablen. Wählen Sie eine der folgenden Optionen aus:
  • UiPath – Standard. Wenn Sie die von UiPath erstellte Anwendung (UiPath Public App-Registrierung) verwenden möchten. Wenn diese Option ausgewählt ist, werden die im Abschnitt Authentifizierung bereitgestellten Felder Anwendungs-ID und Mandant ignoriert.
  • Benutzerdefiniert – Wenn Sie Ihre eigene Anwendung mit bestimmten Berechtigungen erstellen möchten. In diesem Fall müssen Sie einen Wert für das Feld Anwendungs-ID festlegen. Siehe So erstellen Sie eine Anwendung für Microsoft 365 Scope-Verbindungen.

Anwendungs-ID und Zertifikat (Unattended)

Weitere Informationen finden Sie unter Anwendungs-ID und Zertifikat.

• ZertifikatAlsBase64 – Die base64-Darstellung des Zertifikats.

• Zertifikatkennwort – Ein optionales Kennwort, das für die Verwendung des Zertifikats erforderlich sein kann, als Secure String.

Application ID and Secret (Unattended)

Weitere Informationen finden Sie unter Anwendungs-ID und Geheimschlüssel.

• Anwendungsgeheimnis – Die geheime Zeichenfolge, die die Anwendung verwendet, um ihre Identität bereitzustellen.
• Secure Application Secret (Sicheres Anwendungsgeheimnis) – Das Geheimnis der Anwendung (Client) als SecureString.

Benutzername und Kennwort (Unattended)

Weitere Informationen finden Sie unter Benutzername und Kennwort.

Wichtig: Die Standardauthentifizierung für Exchange online ist bei Microsoft nicht mehr vorhanden. Dies wirkt sich auf einige unserer Aktivitäten aus, z. B. Microsoft Office365 Scope. Wir empfehlen die Verwendung des OAuth-Protokolls in den Aktivitäten, die es unterstützen.

• Kennwort – Das Kennwort Ihres Microsoft 365-Kontos.
• SicheresKennwort – Das Kennwort Ihres Microsoft 365-Kontos als SecureString.
• Benutzername – Der Benutzername Ihres Microsoft 365-Kontos.

Allgemein

• TimeoutMS – Gibt die Wartezeit (in Millisekunden) an, die bis zum Abschluss der interaktiven Authentifizierung (Zustimmungsdialogfeld) gewartet werden soll, bevor ein Fehler ausgegeben wird. Dieses Feld unterstützt nur Integer und Int32-Variablen. Der Standardwert ist 30.000 ms (30 Sekunden) (nicht angezeigt).
• BeiFehlerFortsetzen – Gibt an, dass die Ausführung der verbleibenden Aktivitäten fortgesetzt wird, auch wenn die aktuelle Aktivität nicht ausgeführt werden konnte.

Fehlersuche und ‑behebung

Wenn bei der Authentifizierung Probleme auftreten, finden Sie weitere Informationen unter Fehlerbehebung – Authentifizierung.