Microsoft SharePoint 365 Anbindung

Einführung

Eine Microsoft SharePoint 365 Verbindung, die mit dem Microsoft SharePoint 365 Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft SharePoint 365. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Microsoft SharePoint 365 -Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer Microsoft SharePoint 365 Verbindung

Eine neue Microsoft SharePoint 365 Verbindung wird mithilfe des Microsoft SharePoint 365 Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine bestehende Microsoft SharePoint 365 Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer Microsoft SharePoint 365 Verbindung

Jedes Benutzeroberflächenelement des Microsoft SharePoint 365 Verbindungskonfigurationsbildschirms wird unten beschrieben.

Die in der Verbindungskonfiguration verwendete Schnittstelle hängt vom ausgewählten Authentifizierungstyp ab:

• Azure Zugriffssteuerungsdienst: Diese Option authentifiziert Apps mithilfe des SharePoint-Add-In-Modells und des Azure Access Control Service (ACS).
• Microsoft Entra ID: Diese Option authentifiziert Apps, die bei Microsoft Azure Entra (früher bekannt als Azure Active Directory oder Azure AD) registriert sind.

Azure Zugriffssteuerungsdienst

Wenn Azure Access Control Service als Authentifizierungstyp ausgewählt ist, wird diese Benutzeroberfläche angezeigt:

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft SharePoint 365 Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des Microsoft SharePoint 365 Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• Office 365-Mandanten URL: Geben Sie die Microsoft Office 365 Mandanten URL ein.

• Client-ID: Geben Sie die Client-ID für die Microsoft SharePoint 365 App ein (beschrieben unter Voraussetzungen).

• Mieter-ID: Geben Sie die Mieter-ID ein.

• Authentifizierungstyp: Wählen Sie Azure Access Control Service.

• Clientgeheimnis: Geben Sie das Clientgeheimnis für die Microsoft SharePoint 365 -App ein (beschrieben unter Voraussetzungen).

• Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Microsoft Entra ID

Wenn Microsoft Entra ID als Authentifizierungstyp ausgewählt ist, wird diese Benutzeroberfläche angezeigt:

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Microsoft SharePoint 365 Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des Microsoft SharePoint 365 Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• Office 365-Mandanten URL: Geben Sie die Microsoft Office 365 Mandanten URL ein.

• Client-ID: Geben Sie die Client-ID für die Microsoft SharePoint 365 App ein (beschrieben unter Voraussetzungen).

• Mandanten-ID: Geben Sie die Mandanten-ID ein (beschrieben in Voraussetzungen).

• Authentifizierungstyp: Wählen Sie Microsoft Entra ID.

• Client-Assertion: Geben Sie die Client-Assertion ein, die mit einem Tool wie jwt.io generiert werden können oder mit der Taste CreateJwtToken Funktion in einem Jitterbit Script.

• Geltungsbereich: Geben Sie den OpenID Connect-Geltungsbereich ein in diesem Format: https://jbexample.sharepoint.com/.default.

• Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Möglicher Verbindungsfehler

Wenn beim Testen der Verbindung dieser Fehler auftritt, führen Sie das folgende Script in PowerShell aus, um die benutzerdefinierte App-Authentifizierung zu aktivieren:

{"error":"invalid_request","error_description":"Token type is not allowed."}

Install-Module-Name Microsoft.Online.SharePoint.PowerShell

$adminUPN= "<the full email address of the SharePoint administrator account, example: jan@mydomain.onmicrosoft.com>" $orgName="<mydomain>"

$userCredential = Get-Credential -<the username of the SharePoint administrator account> $adminUPN -Message "<the password of the SharePoint administrator account>" Connect-SPOService-Url https://$orgName-admin.sharepoint.com-Credential

$userCredential set-spotenant-DisableCustomAppAuthentication $false

Nächste Schritte

Nachdem eine Microsoft SharePoint 365 Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verwenden von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Datei hochladen: Lädt eine PDF- oder Textdatei in Microsoft SharePoint 365 hoch und soll als Ziel in einem Operation verwendet werden.

• Abfrage: Fragt Objektdaten in Microsoft SharePoint 365 ab und ist zur Verwendung als Quelle in einem Operation vorgesehen.

• Aktualisieren: Aktualisiert Objektdaten in Microsoft SharePoint 365 und ist zur Verwendung als Ziel in einem Operation vorgesehen.

• Erstellen: Erstellt Objektdaten in Microsoft SharePoint 365 und ist zur Verwendung als Ziel in einem Operation vorgesehen.

• Löschen: Löscht Objektdaten aus Microsoft SharePoint 365 und ist zur Verwendung als Ziel in einem Operation vorgesehen.