Zum Inhalt springen

Microsoft SharePoint 365-Verbindung in Jitterbit Studio

Einführung

Eine Microsoft SharePoint 365-Verbindung, die mit dem Microsoft SharePoint 365-Connector erstellt wird, stellt den Zugriff auf Microsoft SharePoint 365 her. Nach der Konfiguration einer Verbindung können Sie Instanzen von Microsoft SharePoint 365-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.

Hinweis

Der Microsoft SharePoint 365-Connector unterstützt OAuth 2.0-Authentifizierung.

Microsoft SharePoint 365-Verbindung erstellen oder bearbeiten

Eine neue Microsoft SharePoint 365-Verbindung wird mit dem Microsoft SharePoint 365-Connector von einem dieser Orte aus erstellt:

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

Microsoft SharePoint 365-Verbindung konfigurieren

Nachfolgend werden alle Elemente der Benutzeroberfläche des Konfigurationsbildschirms für die Microsoft SharePoint 365-Verbindung beschrieben.

Die in der Verbindungskonfiguration verwendete Schnittstelle hängt vom ausgewählten Authentication type (Authentifizierungstyp) ab:

  • Microsoft Entra ID: Diese Option authentifiziert Apps, die bei Microsoft Entra ID (ehemals Azure Active Directory oder Azure AD) registriert sind.

  • Azure Access Control Service (Deprecated): Diese Option authentifiziert Apps mit dem SharePoint Add-in-Modell und dem Azure Access Control Service (ACS).

Microsoft Entra ID

Wenn Microsoft Entra ID als Authentication type (Authentifizierungstyp) ausgewählt ist, wird die nachfolgend beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von global variables, project variables und Jitterbit variables. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Connection name: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft SharePoint 365-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch zur Identifizierung des Microsoft SharePoint 365-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

  • Office 365 tenant 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 in Prerequisites).

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

  • Authentication type: Wählen Sie Microsoft Entra ID.

  • Client Assertion: Geben Sie die Client Assertion ein. Diese kann mit einem Tool wie jwt.io oder mit der Funktion CreateJwtToken in einem Jitterbit-Skript generiert werden.

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

  • Proxy-Einstellungen verwenden (nur Private Agent): Bei Verwendung eines Private Agent kann diese Einstellung aktiviert werden, um Private Agent Proxy-Einstellungen zu nutzen.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Beim Testen der Verbindung wird die neueste Version des Connectors von den Agent(en) in der Agent-Gruppe heruntergeladen, die der aktuellen Umgebung zugeordnet ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Azure Access Control Service (veraltet)

Warnung

Microsoft hat Azure Access Control Service (ACS) am 2. April 2026 eingestellt.

Wenn Sie den Jitterbit Microsoft SharePoint 365 Connector mit Azure Access Control Service-Authentifizierung verwenden, wechseln Sie zur Microsoft Entra ID-Authentifizierung. Operationen mit einer Microsoft SharePoint 365 Endpoint-Aktivität mit Azure Access Control Service-Authentifizierung schlagen mit Authentifizierungsfehlern fehl, wenn Anfragen gestellt werden.

Wenn Azure Access Control Service (veraltet) als Authentifizierungstyp ausgewählt ist, wird die nachfolgend beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft SharePoint 365-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Microsoft SharePoint 365 Endpoint zu identifizieren, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht.

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

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

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

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

  • Client Secret: Geben Sie das Client Secret für die Microsoft SharePoint 365-App ein (beschrieben in 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 nutzen.

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Beim Testen der Verbindung lädt der Agent (oder die Agenten) in der Agentgruppe, die der aktuellen Umgebung zugeordnet ist, die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Nach Änderungen an einer neuen oder vorhandenen Konfiguration klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nach dem Öffnen einer vorhandenen Verbindungskonfiguration klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Möglicher Verbindungsfehler

Wenn Sie diesen Fehler beim Testen der Verbindung erhalten, führen Sie das folgende Skript in PowerShell aus, um die Authentifizierung benutzerdefinierter Apps zu aktivieren:

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

PowerShell Script
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

Hinweis

Ersetzen Sie den Platzhaltertext (einschließlich der spitzen Klammern < >) durch die entsprechenden Werte für die SharePoint-Instanz.

Nächste Schritte

Nach dem Erstellen einer Microsoft SharePoint 365-Verbindung platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu verarbeiten) verwendet werden.

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 ist als Ziel in einem Vorgang vorgesehen.

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

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

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

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