So verwenden Sie Microsoft 365-Aktivitäten ohne Integration Service-Verbindungen

Über

Sie können jetzt die neueren Microsoft 365-Aktivitäten über Microsoft 365 Scope auch dann verwenden, wenn Sie nicht über Integration Service verfügen.

Die speziell für den Integration Service entwickelten Microsoft 365-Aktivitäten verfügen über ein Feld Verbindung, mit dem Sie eine Verbindung auswählen können, die über einen Integration Service-Connector erstellt wurde. Bei Verwendung innerhalb des Microsoft 365 Scope erben die Aktivitäten einfach die Verbindungsinformationen aus dem Scope.

Matrix von Authentifizierungs- und Projekttypen

Microsoft 365
	Cloud		Lokal
	Microsoft Office 365-Anwendungsbereich	Integration Service	Microsoft Office 365-Anwendungsbereich	Integration Service
Plattformübergreifend
Interaktives Token – OAuth – Öffentliche UiPath-App
Interaktives Token – OAuth – BYOA
Integrierte Windows-Authentifizierung
UsernameAndPassword
Anwendungs-ID und Geheimschlüssel
AnwendungsID und Zertifikat
Windows
Interaktives Token – OAuth – Öffentliche UiPath-App
Interaktives Token – OAuth – BYOA
Integrierte Windows-Authentifizierung
UsernameAndPassword
Anwendungs-ID und Geheimschlüssel
AnwendungsID und Zertifikat

Verbindungsmethoden

Es gibt zwei Möglichkeiten, eine Verbindung in der Aktivität Microsoft 365 Scope einzurichten.

Verbindungsmethode		Beschreibung	Vorteile	Nachteile
Asset Hinweis: Empfohlen.		Verwendet ein Orchestrator-Asset, um die Verbindung zusammen mit der Scope-Konfiguration zu speichern. Das Asset hat ein JSON-Format. Bei jeder Verwendung ruft die Aktivität die Konfiguration aus dem Asset ab. Basierend auf der Asset-Konfiguration verhält sich der Scope unterschiedlich; Sie identifiziert den Authentifizierungstyp und blendet nicht benötigte Felder aus. Wenn die Asset-JSON nicht richtig festgelegt ist, wird ein Validierungsfehler ausgelöst.	Die Aktivitäten profitieren von Suchen zur Entwurfszeit und können Dateien, Ordner, Listen, Bereiche usw. erkennen. Die Verbindung ist leicht übertragbar, da Anmeldeinformationen nicht im Klartext von einem Benutzer an einen anderen weitergegeben werden. Kann von einem Administrator konfiguriert werden. Es ist sicherer, da die Anmeldeinformationen den Studio-Workflow nicht erreichen.	Erfordert einen fortgeschrittenen Benutzer, um das Asset zu konfigurieren. Für einen Citizen Developer nicht einfach einzurichten.
Eigenschaften-Panel		Verwenden Sie den vorhandenen Eigenschaftenbereich, um die Verbindungsanmeldeinformationen zu konfigurieren. Die Konfiguration kann im Klartext oder über Variablen hinzugefügt werden.	Einfacher zu verwenden. Die Abwärtskompatibilität bleibt erhalten.
	Konfiguration durch Klartext Hinweis: Nicht empfohlen.	Konfigurieren Sie den Eigenschaftenbereich mit Nur-Text-Werten.	Die Aktivitäten profitieren von Suchen zur Entwurfszeit und können Dateien, Ordner, Listen, Bereiche usw. erkennen.	Weniger sicher, weil die Anmeldeinformationen in Klartext zwischen Benutzern übergeben werden müssen.
	Konfiguration über Variablen	Konfigurieren Sie den Eigenschaftenbereich mit Variablen.	Mehr Sicherheit, da die Anmeldeinformationen den Studio-Workflow nicht erreichen.	Die Aktivitäten können zur Entwurfszeit keine Ressourcen erkennen.

Microsoft 365 Scope-Asset-Asset-Format

Hinweis: Das in den folgenden Abschnitten verwendete uap steht für Benutzername und Kennwort.

Standard-Asset-Format

Es folgt das akzeptierte JSON-Format, das Sie in Textassets, in der Entwurfszeit oder in der Laufzeit oder in beidem verwenden können, sowie Anmeldeinformationsassets, die Sie in der Laufzeit zum Angeben von Microsoft 365 Details verwenden können.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Hinweis: Wenn Sie die Parameter OAuth2AppData, ApplicationId und TenantId verwenden, stellen Sie sicher, dass Sie diese basierend auf Ihrem gewählten Authentifizierungsmodus ausfüllen. Beispiele finden Sie in den folgenden Abschnitten.

Die vollständige Liste der Optionen, aus denen Sie für die Parameter Umgebung und Modus auswählen können, ist:

• „Umgebung“: „Standard“ | „Global“ | „China“ | „ Deutschland“ | „USGovernment“ | „USGovernmentDOD“,
• „Modus“: „interaktiv“ | „integriert“ | „UAP“ | „appidsecret“ | „appidcertificate“,

Konfiguration des Assets der UiPath-Anwendung (OAuth – Öffentliche UiPath-App) mit mehreren Mandanten

Hinweis: Die Anwendungs-ID im Beispiel ist die gültige UiPath App-ID, die Sie für Verbindungen verwenden können.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": ""
    }
}

Wenn eine Mandanten-ID erforderlich ist, überprüfen Sie den Abschnitt Details zum interaktiven Token .

Konfiguration der Assets der UiPath-Anwendung (OAuth – Öffentliche UiPath-App) für einen einzelnen Mandanten

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Asset-Konfiguration der benutzerdefinierten Anwendung (OAuth – BYOA).

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Konfiguration des Assets Anwendungs-ID und geheime benutzerdefinierte Anwendung (OAuth – BYOA

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "your unique Microsoft 365 application secret",
    "Environment": "Default",
    "Mode": "appidsecret",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Einschränkungen

Die folgenden Funktionen sind nicht verfügbar, wenn Aktivitäten innerhalb von Microsoft 365 Scope verwendet werden: Trigger, Bindungen und Überschreiben.

Tokenaktualisierung

Es ist kein Dienst zum Aktualisieren Ihrer Verbindungstoken verfügbar, wie der, der im Integration Service verfügbar ist.

Wenn das Autorisierungstoken eine bestimmte Anzahl von Tagen lang nicht aktualisiert wird, läuft es ab und Sie müssen sich erneut authentifizieren. Um das Ablaufen von Autorisierungstokens zu vermeiden, führen Sie einen Roboter mit dieser speziellen Verbindung aus. Beim Ausführen einer Automatisierung mit der Scope-Aktivität wird das Autorisierungstoken aktualisiert.

Zusätzliche OAuth 2.0-Ressourcen:

• Mit Genehmigungsablauf des Administrators: OAuth 2.0-Client-Anmeldeinformationen werden auf der Microsoft Identity-Plattform genutzt
• Ohne Administratorgenehmigungsflow: Microsoft Identity-Plattform und OAuth 2.0-Autorisierungscodeflow – Microsoft Identity-Plattform