Zum Inhalt springen

Microsoft SharePoint Server-Verbindung in Jitterbit Studio

Einführung

Eine Microsoft SharePoint Server-Verbindung, die mit dem Microsoft SharePoint Server-Connector erstellt wird, stellt den Zugriff auf Microsoft SharePoint Server her. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit Microsoft SharePoint Server.

Microsoft SharePoint Server-Verbindung erstellen oder bearbeiten

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

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

Microsoft SharePoint Server-Verbindung konfigurieren

Nachfolgend werden alle Elemente der Benutzeroberfläche des Konfigurationsbildschirms der Microsoft SharePoint Server-Verbindung beschrieben.

Tipp

Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. 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 wählen können.

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

  • URL: Geben Sie die URL ein.

  • SharePoint edition: Wählen Sie die SharePoint-Edition aus, eine der folgenden:

    • SharePoint Online

      • Auth scheme: Wählen Sie das Autorisierungsschema aus, eines der folgenden:

        • AzureAD

          • Initiate OAuth: Wählen Sie die OAuth-Einstellung aus, eine der folgenden:

            • OFF

              • OAuth access token: Geben Sie das OAuth-Zugriffstoken ein.

            • REFRESH

              • OAuth access token: Geben Sie das OAuth-Zugriffstoken ein.

            • GETANDREFRESH

          • OAuth refresh token: Geben Sie das OAuth-Aktualisierungstoken ein.

        • AzureServicePrincipalCert

          • Azure tenant: Geben Sie den Azure-Mandanten ein.

          • OAuth JWT issuer: Geben Sie den OAuth JWT-Aussteller ein.

          • Initiate OAuth: Wählen Sie die OAuth-Einstellung aus, eine der folgenden:

            • OFF

              • OAuth access token: Geben Sie das OAuth-Zugriffstoken ein.

            • REFRESH

              • OAuth access token: Geben Sie das OAuth-Zugriffstoken ein.

            • GETANDREFRESH

          • OAuth refresh token: Geben Sie das OAuth-Aktualisierungstoken ein.

  • OAuth JWT cert: Geben Sie das OAuth JWT-Zertifikat ein.

            -   **OAuth JWT cert type:** Wählen Sie den OAuth JWT-Zertifikattyp aus, einer der folgenden:

            -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

        -   **OAuth JWT cert password:** Geben Sie das Passwort für das OAuth JWT-Zertifikat ein.

    -   **AzurePassword**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

        -   **Azure tenant:** Geben Sie den Azure-Mandanten ein.

        -   **OAuth client ID:** Geben Sie die OAuth-Client-ID ein.

    -   **AzureMSI**

    -   **PingFederate**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

        -   **SSO login URL:** Geben Sie die SSO-Anmelde-URL ein.

        -   **SSO domain:** Geben Sie die SSO-Domäne ein.

        -   **SSO properties:** Geben Sie die SSO-Eigenschaften ein.

    -   **ADFS**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

        -   **SSO login URL:** Geben Sie die SSO-Anmelde-URL ein.

        -   **SSO domain:** Geben Sie die SSO-Domäne ein.

        -   **SSO properties:** Geben Sie die SSO-Eigenschaften ein.

    -   **OneLogin**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

        -   **SSO login URL:** Geben Sie die SSO-Anmelde-URL ein.

        -   **SSO domain:** Geben Sie die SSO-Domäne ein.

        -   **SSO properties:** Geben Sie die SSO-Eigenschaften ein.

    -   **Okta**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

        -   **SSO login URL:** Geben Sie die SSO-Anmelde-URL ein.

        -   **SSO domain:** Geben Sie die SSO-Domäne ein.

        -   **SSO properties:** Geben Sie die SSO-Eigenschaften ein.

    -   **SharePointOAuth**

        -   **OAuth client ID:** Geben Sie die OAuth-Client-ID ein.

        -   **OAuth client secret:** Geben Sie das OAuth-Client-Geheimnis ein.

    -   **NTLM**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

    -   **Basic**

        -   **User:** Geben Sie den Benutzer ein.

        -   **Password:** Geben Sie das Passwort ein.

    -   **OAuth**

        -   **Initiate OAuth:** Wählen Sie die OAuth-Einstellung aus, einer der folgenden:

            -   **OFF**

                -   **OAuth access token:** Geben Sie das OAuth-Zugriffstoken ein.

            -   **REFRESH**

                -   **OAuth Access Token:** Geben Sie das OAuth-Zugriffstoken ein.

            -   **GETANDREFRESH**

        -   **OAuth Refresh Token:** Geben Sie das OAuth-Aktualisierungstoken ein.

    -   **OAuthJWT**

        -   **Azure tenant:** Geben Sie den Azure-Mandanten ein.

        -   **OAuth JWT issuer:** Geben Sie den OAuth JWT-Aussteller ein.

        -   **Initiate OAuth:** Wählen Sie die OAuth-Einstellung aus, einer der folgenden:

            -   **OFF**

                -   **OAuth access token:** Geben Sie das OAuth-Zugriffstoken ein.

            -   **REFRESH**

                -   **OAuth access token:** Geben Sie das OAuth-Zugriffstoken ein.

            -   **GETANDREFRESH**

        -   **OAuth refresh token:** Geben Sie das OAuth-Aktualisierungstoken ein.

        -   **OAuth JWT cert:** Geben Sie das OAuth JWT-Zertifikat ein.

  • OAuth JWT cert type: Wählen Sie den OAuth JWT-Zertifikattyp aus, einer der folgenden:

                -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

        -   **OAuth JWT cert password:** Geben Sie das Passwort des OAuth JWT-Zertifikats ein.

    • SharePoint OnPremise

      • Auth scheme: Wählen Sie das Autorisierungsschema aus, eines der folgenden:

        • NTLM

          • User: Geben Sie den Benutzer ein.

          • Password: Geben Sie das Passwort ein.

        • Negotiate

          • User: Geben Sie den Benutzer ein.

          • Password: Geben Sie das Passwort ein.

        • None

        • Basic

          • User: Geben Sie den Benutzer ein.

          • Password: Geben Sie das Passwort ein.

        • ADFS

          • User: Geben Sie den Benutzer ein.

          • Password: Geben Sie das Passwort ein.

          • SSO login URL: Geben Sie die SSO-Anmelde-URL ein.

          • SSO domain: Geben Sie die SSO-Domäne ein.

          • SSO properties: Geben Sie die SSO-Eigenschaften ein.

  • Schema: Wählen Sie das Schema aus, eines der folgenden:

    • SOAP

    • REST

    Wichtig

    Microsoft stellt die IDCRL-Authentifizierung ein, was sich auf SOAP-Schemaverbindungen zu SharePoint Online auswirkt. Nach dem 1. Mai 2026 beginnen Vorgänge, die von Verbindungen mit dem SharePoint Online SOAP-Schema abhängen, fehlzuschlagen. So führen Sie die Migration durch:

    1. Erstellen Sie eine neue Verbindung, die mit dem REST-Schema konfiguriert ist.
    2. Legen Sie Auth scheme auf eine REST-kompatible Option fest. Für SharePoint Online gehören zu den unterstützten Schemas AzureAD, AzureServicePrincipalCert, AzurePassword, AzureMSI, SharePointOAuth, ADFS, Okta, PingFederate und OneLogin.
    3. Testen Sie die Verbindung.
    4. Öffnen Sie für jede Aktivität, die die alte SOAP-Verbindung verwendet, den Aktivitätskonfigurationsbildschirm, halten Sie den Mauszeiger über den Endpunktnamen, um das Bearbeitungssymbol anzuzeigen, klicken Sie auf das Endpunktmenü und wählen Sie die neue REST-Verbindung aus.
    5. Wenn beim Wechsel des Endpunkts Probleme auftreten, erstellen Sie neue Aktivitäten vom neuen REST-Endpunkt von Grund auf und ersetzen Sie sie manuell in jedem Vorgang, in dem die alten Aktivitäten verwendet wurden.
    6. Führen Sie die Konfigurationsschritte für jede Aktivität aus. Da das REST-Schema andere Tabellen und Spalten als SOAP verfügbar macht, überprüfen und aktualisieren Sie die Tabellenauswahl und Feldzuordnungen nach Bedarf.
    7. Stellen Sie alle vom Vorgang abhängigen Vorgänge erneut bereit und führen Sie sie aus, um die aktualisierten Aktivitäten zu validieren.
    8. Deaktivieren Sie die alte SOAP-basierte Verbindung.

    Wenden Sie sich an den Jitterbit-Support für Unterstützung.

  • Use Proxy Settings: Wählen Sie diese Option, um private Agent-Proxy-Einstellungen zu verwenden.

  • Advanced Configurations: Wenn diese Option aktiviert ist, wird die Tabelle Advanced Configurations Properties angezeigt, die zum Hinzufügen von zusätzlichen Konfigurationseigenschaften als Schlüssel-Wert-Paare verwendet wird.

    • Add: Fügt eine Zeile zur Tabelle hinzu. Geben Sie für jede Eigenschaft ein Schlüssel-Wert-Paar ein.
    • Submit: Speichert das Schlüssel-Wert-Paar in der Tabelle. Wird angezeigt, wenn Sie den Mauszeiger im Bearbeitungsmodus über eine Zeile halten.
    • Discard: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Wird angezeigt, wenn Sie den Mauszeiger im Bearbeitungsmodus über eine Zeile halten.
    • Edit: Ermöglicht das Bearbeiten eines vorhandenen Schlüssel-Wert-Paars. Wird angezeigt, wenn Sie den Mauszeiger über eine vorhandene Zeile halten.
    • Delete: Löscht die Zeile aus der Tabelle. Wird angezeigt, wenn Sie den Mauszeiger über eine vorhandene Zeile halten.
    • Clear All: Löscht alle Zeilen aus der Tabelle.

Hinweis

Spalten- und Tabellennamen in Microsoft SharePoint Server können Sonderzeichen enthalten, die von anderen Diensten nicht unterstützt werden. Fügen Sie die Konfigurationseigenschaft UseSimpleNames hinzu und setzen Sie sie auf true, um ein Benennungsschema zu erzwingen, das auf alphanumerische Zeichen und Unterstriche beschränkt ist. Bei Aktivierung werden nicht-alphanumerische Zeichen in Unterstriche umgewandelt.

Wichtig

Felder in der Tabelle Advanced Configurations Properties zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

Felder in der Tabelle Advanced Configurations Properties unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Falls Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird {"success": "true"}; zu {\"success\": \"true\"}; maskiert.

  • Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, lädt der Agent bzw. die Agents in der mit der aktuellen Umgebung verknüpften Agent-Gruppe die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Organisationsrichtlinie Disable Auto Connector Update.

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

  • Discard changes: 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.

  • Delete: 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 Component dependencies, deletion, and removal). Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung mit OAuth durch spezifische Konfigurationseigenschaften. Nach Auswahl eines Authentifizierungsschemas, das Initiate OAuth enthält, können Sie die Konfiguration in den angezeigten Feldern angeben.

Hinweis

Zusätzliche IDs, Secrets, Scopes und andere Authentifizierungstoken können erforderlich sein, um die OAuth-Authentifizierung erfolgreich abzuschließen. Überprüfen Sie die Endpoint-Dokumentation auf weitere Informationen zu deren Anforderungen.

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (z. B. Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die erforderlichen Zugriffstokens vom betreffenden Endpoint zu erhalten. Beide Szenarien funktionieren nur für Single-Agent-Gruppen. Dies sind Agent-Gruppen, die aus einem einzelnen Agent bestehen.

  • Scenario 1: Verwendung eines OAuth-Zugriffstokens, das nach einem bestimmten Zeitraum abläuft.

    Mit dieser Konfiguration stellen Sie ein OAuth-Zugriffstoken bereit, das für einen bestimmten Zeitraum gültig ist, wie vom jeweiligen Endpoint bestimmt. Der Connector verwendet das Token, um die Verbindung herzustellen. Die Verbindung funktioniert jedoch nicht mehr, sobald das Zugriffstoken abläuft. Sie würden den Connector zur Verwendung des Tokens konfigurieren, indem Sie diese Eigenschaften festlegen:

    Konfigurationseigenschaft Wert
    Initiate OAuth OFF
    OAuth Access Token Auf den Wert des vom Endpoint erhaltenen OAuth-Zugriffstokens setzen

  • Scenario 2: Verwendung eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Refresh-Token zur Aktivierung der automatischen Aktualisierung des Zugriffs.

    Mit dieser Konfiguration verwendet der Connector ein Refresh-Token, um ein neues Zugriffstoken zu erhalten, sobald das aktuelle Zugriffstoken abgelaufen ist. Dies ist in der Regel die beste Methode zum Konfigurieren von OAuth.

Sie stellen ein OAuth-Zugriffstoken und ein OAuth-Aktualisierungstoken bereit, wie vom jeweiligen Endpunkt vorgegeben. Sie konfigurieren den Connector zur Verwendung dieser Tokens, indem Sie diese Eigenschaften festlegen:

Konfigurationseigenschaft Wert
OAuth initiieren REFRESH
OAuth-Zugriffstoken Auf den Wert des vom Endpunkt erhaltenen OAuth-Zugriffstokens festlegen
OAuth-Aktualisierungstoken Auf den Wert des vom Endpunkt erhaltenen OAuth-Aktualisierungstokens festlegen

Hinweis

Bei Verwendung mehrerer OAuth-basierter Microsoft SharePoint Server-Verbindungen auf demselben privaten Agent legen Sie die Konfigurationseigenschaft OAuthSettingsLocation auf einen eindeutigen beschreibbaren Agent-Pfad für jede Verbindung fest. Legen Sie in der jitterbit.conf-Datei für den Agent EnableLocalFileLocation=true fest. Wenn Sie diese beiden Schritte nicht ausführen, verwenden die mehreren Verbindungen denselben Standardpfad und überschreiben sich gegenseitig.

Nächste Schritte

Nach dem Erstellen einer Microsoft SharePoint Server-Connector-Verbindung platzieren Sie einen Aktivitätstyp auf der Designoberfläche, 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:

  • Abfrage: Ruft Datensätze aus einer Tabelle auf einem Microsoft SharePoint Server ab und ist für die Verwendung als Quelle in einem Vorgang vorgesehen.

  • Erstellen: Fügt einen Datensatz in eine Tabelle auf einem Microsoft SharePoint Server ein und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle auf einem Microsoft SharePoint Server und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Löschen: Löscht einen Datensatz aus einer Tabelle auf einem Microsoft SharePoint Server und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.

  • Ausführen: Führt eine Prozedur auf einem Microsoft SharePoint Server aus und ist für die Verwendung als Ziel in einem Vorgang vorgesehen.