Microsoft SharePoint Server-Verbindung

Einführung

Eine Microsoft SharePoint Server-Verbindung, die mit dem Microsoft SharePoint Server-Connector erstellt wurde, ermöglicht den Zugriff auf Microsoft SharePoint Server. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Microsoft SharePoint Server.

Erstellen oder Bearbeiten einer Microsoft SharePoint Server-Verbindung

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

Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
Der Global Endpoints-Seite (siehe Erstellen eines globalen Endpunkts in Global Endpoints).

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

Der Projektendpunkte und -connectoren-Registerkarte der Designkomponentenpalette (siehe Designkomponentenpalette).
Der Komponenten-Registerkarte des Projektfensters (siehe Aktionenmenü für Komponenten in Projektfenster Komponenten-Registerkarte).
Der Global Endpoints-Seite (siehe Bearbeiten eines globalen Endpunkts in Global Endpoints).

Konfigurieren einer Microsoft SharePoint Server-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Microsoft SharePoint Server-Verbindung wird im Folgenden beschrieben.

Tipp

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

Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Microsoft SharePoint Server-Verbindung einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Microsoft SharePoint Server-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.
URL: Geben Sie die URL ein.
SharePoint-Edition: Wählen Sie die SharePoint-Edition aus, eine der folgenden:
- SharePoint Online
  - Authentifizierungsschema: Wählen Sie das Authentifizierungsschema aus, eines der folgenden:
    - AzureAD
      - OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine der folgenden:
        
        AUS
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        AKTUALISIEREN
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        HOLENUNDAKTUALISIEREN
      - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
    - AzureServicePrincipalCert
      - Azure-Mandant: Geben Sie den Azure-Mandanten ein.
      - OAuth JWT-Aussteller: Geben Sie den OAuth JWT-Aussteller ein.
      - OAuth initiieren: Wählen Sie die OAuth-Einstellung aus, eine der folgenden:
        
        AUS
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        AKTUALISIEREN
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        HOLENUNDAKTUALISIEREN
      - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
      - OAuth JWT-Zertifikat: Geben Sie das OAuth JWT-Zertifikat ein.
      - OAuth JWT-Zertifikatstyp: Wählen Sie den OAuth JWT-Zertifikatstyp aus, einen der folgenden:
        
        BENUTZER
        
        MASCHINE
        
        PFXDATEI
        
        PFXBLOB
        
        JKSDATEI
        
        JKSBLOB
        
        PEMKEY_DATEI
        
        PEMKEY_BLOB
        
        PUBLIC_KEY_FILE
        
        PUBLIC_KEY_BLOB
        
        SSHPUBLIC_KEY_FILE
        
        SSHPUBLIC_KEY_BLOB
        
        P7BFILE
        
        PPKFILE
        
        XMLFILE
        
        XMLBLOB
        
        BCFKSFILE
        
        BCFKSBLOB
      - OAuth JWT-Zertifikat Passwort: Geben Sie das Passwort für das OAuth JWT-Zertifikat ein.
    - AzurePassword
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - Azure-Mandant: Geben Sie den Azure-Mandanten ein.
      - OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.
    - AzureMSI
    - PingFederate
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - SSO-Anmelde-URL: Geben Sie die SSO-Anmelde-URL ein.
      - SSO-Domain: Geben Sie die SSO-Domain ein.
      - SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.
    - ADFS
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - SSO-Anmelde-URL: Geben Sie die SSO-Anmelde-URL ein.
      - SSO-Domain: Geben Sie die SSO-Domain ein.
      - SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.
    - OneLogin
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - SSO-Anmelde-URL: Geben Sie die SSO-Anmelde-URL ein.
      - SSO-Domain: Geben Sie die SSO-Domain ein.
      - SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.
    - Okta
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - SSO-Anmelde-URL: Geben Sie die SSO-Anmelde-URL ein.
      - SSO-Domain: Geben Sie die SSO-Domain ein.
      - SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.
    - SharePointOAuth
      - OAuth-Client-ID: Geben Sie die OAuth-Client-ID ein.
      - OAuth-Client-Geheimnis: Geben Sie das OAuth-Client-Geheimnis ein.
    - NTLM
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
    - Basic
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
    - OAuth
      - OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
        
        AUS
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        AKTUALISIEREN
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        HOLENUNDAKTUALISIEREN
      - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
    - OAuthJWT
      - Azure-Mandant: Geben Sie den Azure-Mandanten ein.
      - OAuth-JWT-Aussteller: Geben Sie den OAuth-JWT-Aussteller ein.
      - OAuth initiieren: Wählen Sie die OAuth-Einstellung, eine von:
        
        AUS
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        AKTUALISIEREN
        
        OAuth-Zugriffstoken: Geben Sie das OAuth-Zugriffstoken ein.
        
        HOLENUNDAKTUALISIEREN
      - OAuth-Aktualisierungstoken: Geben Sie das OAuth-Aktualisierungstoken ein.
      - OAuth-JWT-Zertifikat: Geben Sie das OAuth-JWT-Zertifikat ein.
      - OAuth-JWT-Zertifikatstyp: Wählen Sie den OAuth-JWT-Zertifikatstyp, eine von:
        
        BENUTZER
        
        MASCHINE
        
        PFXDATEI
        
        PFXBLOB
        
        JKSDATEI
        
        JKSBLOB
        
        PEMKEY_DATEI
        
        PEMKEY_BLOB
        
        ÖFFENTLICHE_KEY_DATEI
        
        ÖFFENTLICHE_KEY_BLOB
        
        SSHPUBLIC_KEY_FILE
        
        SSHPUBLIC_KEY_BLOB
        
        P7BFILE
        
        PPKFILE
        
        XMLFILE
        
        XMLBLOB
        
        BCFKSFILE
        
        BCFKSBLOB
      - OAuth JWT-Zertifikat Passwort: Geben Sie das Passwort für das OAuth JWT-Zertifikat ein.
- SharePoint OnPremise
  - Auth-Schema: Wählen Sie das Autorisierungsschema, eines von:
    - NTLM
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
    - Negotiate
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
    - Keine
    - Basic
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
    - ADFS
      - Benutzer: Geben Sie den Benutzer ein.
      - Passwort: Geben Sie das Passwort ein.
      - SSO-Anmelde-URL: Geben Sie die SSO-Anmelde-URL ein.
      - SSO-Domain: Geben Sie die SSO-Domain ein.
      - SSO-Eigenschaften: Geben Sie die SSO-Eigenschaften ein.
Schema: Wählen Sie das Schema, eines von:
- SOAP
- REST
Wichtig

Microsoft stellt die IDCRL-Authentifizierung ein, was Auswirkungen auf SOAP-Schema-Verbindungen zu SharePoint Online hat. Nach dem 1. Mai 2026 werden Vorgänge, die von Verbindungen abhängen, die das SharePoint Online SOAP-Schema verwenden, fehlschlagen. Um zu migrieren:
1. Erstellen Sie eine neue Verbindung, die mit dem REST-Schema konfiguriert ist.
2. Setzen Sie das Auth-Schema auf eine REST-kompatible Option. Für SharePoint Online umfassen die unterstützten Schemata AzureAD, AzureServicePrincipalCert, AzurePassword, AzureMSI, SharePointOAuth, ADFS, Okta, PingFederate und OneLogin.
3. Testen Sie die Verbindung.
4. Für jede Aktivität, die die alte SOAP-Verbindung verwendet, öffnen Sie den Konfigurationsbildschirm der Aktivität, fahren Sie mit der Maus über den Endpunktnamen, um das Bearbeitungssymbol anzuzeigen, klicken Sie auf das Endpunktmenü und wählen Sie die neue REST-Verbindung aus.
5. Wenn Sie beim Wechseln des Endpunkts auf Probleme stoßen, erstellen Sie neue Aktivitäten von dem neuen REST-Endpunkt aus und ersetzen Sie sie manuell in jeder Operation, in der die alten Aktivitäten verwendet wurden.
6. Schließen Sie die Konfigurationsschritte jeder Aktivität ab. Da das REST-Schema andere Tabellen und Spalten als SOAP bereitstellt, überprüfen und aktualisieren Sie die Tabellenauswahlen und Feldzuordnungen nach Bedarf.
7. Stellen Sie alle Vorgänge, die von der Verbindung abhängen, erneut bereit und führen Sie sie aus, um die aktualisierten Aktivitäten zu validieren.
8. Stilllegen Sie die alte, auf SOAP basierende Verbindung.
Kontaktieren Sie Jitterbit-Support für Unterstützung.
Proxy-Einstellungen verwenden: Wählen Sie aus, um private Agenten-Proxy-Einstellungen zu verwenden.
Erweiterte Konfigurationen: Wenn ausgewählt, wird die Tabelle Eigenschaften der erweiterten Konfigurationen angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen.
- Hinzufügen: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
- Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
- Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar beim Überfahren einer Zeile im Bearbeitungsmodus.
- Bearbeiten: Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar beim Überfahren einer bestehenden Zeile.
- Löschen: Löscht die Zeile aus der Tabelle. Sichtbar beim Überfahren einer bestehenden Zeile.
- Alle löschen: Löscht alle Zeilen aus der Tabelle.
Hinweis

Microsoft SharePoint Server-Spalten- und Tabellennamen 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 durchzusetzen, das auf alphanumerischen Zeichen und Unterstrichen für Spalten und Tabellen beschränkt ist. Nicht-alphanumerische Zeichen werden bei Aktivierung in Unterstriche umgewandelt.

Wichtig

Felder in der Tabelle Eigenschaften der erweiterten Konfigurationen zeigen das Variablen-Icon nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agenten-Version mindestens 10.75 / 11.13 sein.

Felder in der Tabelle Eigenschaften der erweiterten Konfigurationen unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.
Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, 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 Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

OAuth-Verbindungen konfigurieren

Dieser Connector unterstützt eine Verbindung über OAuth, indem spezifische Konfigurationseigenschaften verwendet werden. Nachdem Sie ein Authentifizierungsschema ausgewählt haben, das OAuth initiieren umfasst, können Sie die Konfiguration in den angezeigten Feldern angeben.

Hinweis

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

Für diesen Connector werden zwei Szenarien unterstützt. In beiden Szenarien müssen Sie ein Drittanbieter-Tool (wie Postman oder ein ähnliches Tool) verwenden, um das erforderliche Zugriffstoken oder die Tokens vom beteiligten Endpunkt zu erhalten. Beide Szenarien funktionieren nur für Einzel-Agentengruppen. Dies sind Agentengruppen, die aus einem einzelnen Agenten bestehen.

Szenario 1: Verwendung eines OAuth-Zugriffstokens, das nach einer festgelegten Zeitspanne abläuft.

Mit dieser Konfiguration stellen Sie ein OAuth-Zugriffstoken zur Verfügung, das für einen festgelegten Zeitraum gültig ist, der durch den jeweiligen Endpunkt bestimmt wird. 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 so konfigurieren, dass er das Token verwendet, indem Sie diese Eigenschaften festlegen:

Konfigurationseigenschaft	Wert
OAuth initiieren	`AUS`
OAuth-Zugriffstoken	Setzen Sie den Wert des von dem Endpunkt erhaltenen OAuth-Zugriffstokens

Szenario 2: Verwendung eines OAuth-Zugriffstokens in Kombination mit einem OAuth-Refresh-Token, um eine automatische Aktualisierung des Zugriffs zu ermöglichen.

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

Sie stellen ein OAuth-Zugriffstoken und ein OAuth-Refresh-Token zur Verfügung, wie es der jeweilige Endpunkt bestimmt. Sie würden den Connector so konfigurieren, dass er diese Tokens verwendet, indem Sie diese Eigenschaften festlegen:

Konfigurationseigenschaft	Wert
OAuth initiieren	`AKTUALISIEREN`
OAuth-Zugriffstoken	Setzen Sie den Wert des von dem Endpunkt erhaltenen OAuth-Zugriffstokens
OAuth-Refresh-Token	Setzen Sie den Wert des von dem Endpunkt erhaltenen OAuth-Refresh-Tokens

Hinweis

Wenn Sie mehrere OAuth-basierte Microsoft SharePoint Server-Verbindungen auf demselben privaten Agenten verwenden, setzen Sie die Konfigurationseigenschaft OAuthSettingsLocation auf einen eindeutigen beschreibbaren Agentenpfad für jede Verbindung. In der jitterbit.conf-Datei für den Agenten setzen Sie EnableLocalFileLocation=true. Wenn Sie diese beiden Schritte nicht ausführen, verwenden die mehreren Verbindungen denselben Standardpfad und überschreiben sich gegenseitig.

Nächste Schritte

Nachdem eine Verbindung zum Microsoft SharePoint Server Connector erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe 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 als Quelle in einem Vorgang vorgesehen.
Erstellen: Fügt einen Datensatz in eine Tabelle auf einem Microsoft SharePoint Server ein und ist als Ziel in einem Vorgang vorgesehen.
Aktualisieren: Aktualisiert einen Datensatz in einer Tabelle auf einem Microsoft SharePoint Server und ist als Ziel in einem Vorgang vorgesehen.
Löschen: Löscht einen Datensatz aus einer Tabelle auf einem Microsoft SharePoint Server und ist als Ziel in einem Vorgang vorgesehen.
Ausführen: Führt eine Prozedur auf einem Microsoft SharePoint Server aus und ist als Ziel in einem Vorgang vorgesehen.