Details zur Microsoft SharePoint Server Verbindung

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8690 des Connectors.

Erste Schritte

Versionsunterstützung für Microsoft SharePoint

Der Connector unterstützt alle Versionen von Microsoft SharePoint, die die SOAP API unterstützen. Dazu gehören: Windows SharePoint Services 3.0, SharePoint Server 2007+ (2010, 2013 usw.) und SharePoint Online. Der Connector modelliert die benutzerdefinierten Listen Ihrer SharePoint-Site als bidirektionale Tabellen. Wenn Sie eine Verbindung herstellen, ruft der Connector die Metadaten für diese Tabellen ab, indem er SharePoint-Webdienste aufruft. Unterstützte Authentifizierungsschemata sind NTLM, Basic, Digest, Forms, Kerberos, SSO, STS (Security Token Services) und SharePoint-Authentifizierungscookies.

Herstellen einer Verbindung

Herstellen einer Verbindung mit Microsoft SharePoint

Unabhängig davon, ob Sie eine Online- oder Vor-Ort-Verbindung herstellen, welche Architektur verwendet wird und auf welche Listen und Dokumente zugegriffen wird, erfordert die Verbindung mit Microsoft SharePoint genau zwei Dinge:

• Festlegen der URL Verbindungseigenschaft.
• Legen Sie die entsprechenden Authentifizierungseigenschaften für Ihre Umfeld fest.

Einstellung URL:

Microsoft SharePoint funktioniert mit allen Listen und Dokumenten auf der globalen Microsoft SharePoint-Site oder mit allen Listen und Dokumenten auf einzelnen Sites.

Um mit allen Listen und Dokumenten auf der globalen Microsoft Sharepoint-Site zu arbeiten, setzen Sie die URL Verbindungseigenschaft zu Ihrer Site Collection-URL. Beispiel:

https://teams.contoso.com

Um mit allen Listen und Dokumenten auf einer einzelnen Site zu arbeiten, setzen Sie URL Verbindungseigenschaft zu Ihrer individuellen Site-URL. Beispiel:

https://teams.contoso.com/TeamA

In den folgenden Abschnitten wird beschrieben, wie Sie die entsprechenden Authentifizierungseigenschaften für Ihre Umfeld festlegen. Informationen zum Erstellen einer benutzerdefinierten OAuth-Anwendung (erforderlich für die Verwendung mit Microsoft Entra ID in einer Webanwendung; optional für den Zugriff auf Microsoft Entra ID über eine Desktopanwendung oder einen Headless-Server) finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Microsoft SharePoint Online

Satz SharePointEdition auf „SharePoint Online“ und setzen Sie die User Und Password auf die Anmeldeinformationen, die Sie für die Anmeldung bei SharePoint verwenden, beispielsweise die Anmeldeinformationen für Ihr Microsoft Online Services-Konto.

Microsoft SharePoint Online unterstützt eine Reihe von Cloud-basierten Architekturen, von denen jede einen anderen Satz von Authentifizierungsschemata unterstützt:

• Microsoft Entra ID
• Single Sign-On (SSO) über den SSO-Identitätsanbieter ADFS, Okta, OneLogin oder PingFederate
• Verwaltete Identitäten für Azure-Ressourcen
• Azure-Passwort
• OAuthJWT
• SharePointOAuth

Wenn sich die Domäne des Benutzerkontos von der beim Identitätsanbieter konfigurierten Domäne unterscheidet, legen Sie fest SSODomain für Letzteres. Diese Eigenschaft kann für jedes SSO erforderlich sein.

Microsoft Entra ID

Microsoft Entra ID ist ein Verbindungstyp, der OAuth zur Authentifizierung nutzt. OAuth erfordert, dass der authentifizierende Benutzer über einen Internetbrowser mit Microsoft SharePoint interagiert. Der Treiber erleichtert dies auf verschiedene Weise, wie unten beschrieben. Setzen Sie Ihr AuthScheme auf AzureAD. Die unten beschriebenen Microsoft Entra ID Abläufe setzen voraus, dass Sie dies getan haben.

Ihre Organisation benötigt möglicherweise die Zustimmung des Administrators, wenn sie eine neue App-Registrierung für Ihren Azure-Mandanten autorisiert. In allen Microsoft Entra ID Flows erfordert jede Erstinstallation und Verwendung einer App-Registrierung, dass ein Administrator die Anwendung für seinen Azure-Mandanten genehmigt. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Desktop-Anwendungen

Es wird eine eingebettete OAuth-Anwendung bereitgestellt, die die OAuth-Desktop-Authentifizierung vereinfacht. Alternativ können Sie eine benutzerdefinierte App-Registrierung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-Anwendung für Informationen zum Erstellen benutzerdefinierter Anwendungen und Gründe dafür.

Der einzige Unterschied zwischen den beiden Methoden zur Authentifizierung besteht darin, dass Sie bei Verwendung benutzerdefinierter App-Registrierungen zwei zusätzliche Verbindungseigenschaften festlegen müssen.

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.
• CallbackURL: Die Weiterleitungs URL in Ihren Anwendungseinstellungen.
• Custom applications only:
  • OAuthClientId: Die Client-ID in Ihren Anwendungseinstellungen.
  • OAuthClientSecret: Das Client-Geheimnis in Ihren Anwendungseinstellungen.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation. Diese gespeicherten Werte bleiben über Verbindungen hinweg bestehen.

Single Sign-On-Identitätsanbieter

ADFS

Setzen Sie die AuthScheme Zu ADFS. Sie müssen die folgenden Verbindungseigenschaften festlegen:

• User: Der ADFS-Benutzer.
• Password: Das ADFS-Passwort des Benutzers.
• SSODomain (optional): Die mit dem ADFS-Identitätsanbieter konfigurierte Domäne.

Beispiel-Verbindungszeichenfolge:

AuthScheme=ADFS;User=ADFSUserName;Password=ADFSPassword;URL='http://sharepointserver/mysite';

Okta

Setzen Sie den AuthScheme Zu Okta. Die folgenden Verbindungseigenschaften werden zum Herstellen einer Verbindung mit Okta verwendet:

• User: Der Okta Benutzer.
• Password: Das Okta-Passwort des Benutzers.
• SSODomain (optional): Die mit dem OKTA-Identitätsanbieter konfigurierte Domäne.

Beispiel-Verbindungszeichenfolge:

AuthScheme=Okta;User=oktaUserName;Password=oktaPassword;URL='http://sharepointserver/mysite';

OneLogin

Setzen Sie AuthScheme Zu OneLogin. Die folgenden Verbindungseigenschaften werden zum Herstellen einer Verbindung mit OneLogin verwendet:

• User: Der OneLogin-Benutzer.
• Password: Das OneLogin-Passwort des Benutzers.
• SSODomain (optional): Die mit dem OneLogin-Identitätsanbieter konfigurierte Domäne.

Beispiel-Verbindungszeichenfolge:

AuthScheme=OneLogin;User=OneLoginUserName;Password=OneLoginPassword;URL='http://sharepointserver/mysite';

PingFederate

Setzen Sie AuthScheme Zu PingFederate. Die folgenden Verbindungseigenschaften werden zum Herstellen einer Verbindung mit PingFederate verwendet:

• User: Der PingFederate-Benutzer.
• Password: PingFederate-Passwort für den Benutzer.
• SSODomain (optional): Die mit dem Identitätsanbieter PingFederate konfigurierte Domäne.

Beispiel-Verbindungszeichenfolge:

AuthScheme=PingFederate;User=PingFederateUserName;Password=PingFederatePassword;URL='http://sharepointserver/mysite';

Verwaltete Identitäten für Azure-Ressourcen

Wenn Sie Microsoft SharePoint auf einer Azure-VM ausführen, können Sie die MSI-Anmeldeinformationen (Azure Managed Service Identity) für die Verbindung nutzen:

• AuthScheme: AzureMSI.

Die MSI-Anmeldeinformationen werden zur Authentifizierung automatisch abgerufen.

Azure Kennwort

Um eine direkte Verbindung mithilfe Ihrer Azure-Dredentials herzustellen, geben Sie die folgenden Verbindungseigenschaften an:

• AuthScheme: AzurePassword
• User: Das Benutzerkonto, das für die Verbindung mit Azure verwendet wird
• Password: Das für die Verbindung mit Azure verwendete Kennwort
• AzureTenant: Directory (tenant) ID, zu finden auf der Übersichtsseite der OAuth-Anwendung, die zur Authentifizierung bei Microsoft SharePoint auf Azure verwendet wird.

OAuthJWT-Zertifikat

Setzen Sie die AuthScheme Zu OAUTHJWT. Die folgenden Verbindungseigenschaften werden zum Herstellen einer Verbindung mit Microsoft SharePoint verwendet:

• OAuthGrantType: CLIENT.
• AzureTenant: Der Mandant, mit dem Sie sich verbinden möchten.
• OAuthJWTCert: Der JWT-Zertifikatspeicher.
• OAuthJWTIssuer: Die OAuth-Client-ID.

SharePointOAuth

Setzen Sie die AuthScheme Zu SharePointOAuth. Die folgenden Verbindungseigenschaften werden zum Herstellen einer Verbindung mit SharePointOAuth verwendet:

• Schema: REST.
• InitiateOAuth: GETANDREFRESH.
• OAuthClientId: Die Identität/Client-ID der Anwendung.
• OAuthClientSecret: Das Client-Geheimnis der Anwendung.

Beispiel-Verbindungszeichenfolge:

SharePointEdition='SharepointOnline';URL=https://rssbuscrm.sharepoint.com;Schema=REST;AuthScheme=SharepointOAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=11111111-1111-1111-1111-111111111111;OAuthClientSecret=1111111111111/11111111111111/11111111111111=;

Dieses AuthScheme funktioniert mit der benutzerdefinierten OAuth-Anwendung. Informationen zum Generieren von Anmeldeinformationen aus einer benutzerdefinierten OAuth-Anwendung finden Sie unter Erstellen einer benutzerdefinierten OAuth-Anwendung.

Microsoft SharePoint vor Ort

Microsoft SharePoint On-Premises unterstützt eine Reihe von lokalen Architekturen:

Windows (NTLM) Kerberos - ADFS - Anonymer Zugriff

Satz SharePointEdition zu „SharePoint On-Premises“, um die folgenden Authentifizierungstypen zu verwenden.

Windows (NTLM)

Dies ist der am häufigsten verwendete Authentifizierungstyp. Daher ist der Connector so vorkonfiguriert, dass er NTLM als Standard verwendet. Stellen Sie einfach die Windows User Und Password zum Verbinden.

Kerberos

Setzen Sie die AuthScheme Zu NEGOTIATE, und legen Sie dann die folgenden Kerberos-Verbindungseigenschaften fest:

• KerberosKDC: Der Host oder die IP-Adresse Ihrer Kerberos-KDC-Maschine.
• KerberosRealm: Der Bereich des Microsoft SharePoint Kerberos-Prinzipals. Dies ist der Wert nach dem '@'-Symbol (z. B. EXAMPLE.COM) des Prinzipalwerts (z. B. MyService/MyHost@EXAMPLE.COM).
• KerberosSPN: Der Dienst und Host des Microsoft SharePoint Kerberos-Prinzipals. Dies ist der Wert vor dem Symbol „@“ (z. B. MyService/MyHost) des Prinzipalwerts (z. B. MyService/MyHost@EXAMPLE.COM).

Einzelheiten zur Authentifizierung mit Kerberos finden Sie unter Verwenden von Kerberos.

ADFS

Setzen Sie die AuthScheme Zu ADFS, und legen Sie dann die folgenden Verbindungseigenschaften fest:

• User: Der ADFS-Benutzer.
• Password: ADFS-Passwort für den Benutzer.
• SSOLoginURL: Der WS-Trust-Endpoint des ADFS-Servers.

Sie müssen außerdem das setzen SSOProperties zur Authentifizierung bei ADFS. Geben Sie den Wert des RelyingParty-Parameters an; er befindet sich auf dem ADFS-Server für Sharepoint. Beispiel-Verbindungszeichenfolge:

AuthScheme=ADFS;User=ADFSUserName;Password=ADFSPassword;SSOLoginURL='https://<authority>/adfs/services/trust/2005/usernamemixed';SSO Properties ='RelyingParty=urn:sharepoint:sp2016;';

Anonymer Zugriff

Setzen Sie die AuthScheme Zu NONE zusammen mit der URL.

Erstellen einer benutzerdefinierten OAuth-Anwendung

Erstellen einer benutzerdefinierten OAuth-Anwendung

bettet OAuth-Anwendungsanmeldeinformationen mit Branding ein, die verwendet werden können, wenn Azure verwendet wird, um eine Verbindung über eine Desktopanwendung oder eine Headless-Maschine herzustellen. In allen Fällen erfordert die Verbindung mit Azure über eine Webanwendung jedoch die Erstellung einer benutzerdefinierten OAuth-Anwendung.

Möglicherweise möchten Sie auch eine benutzerdefinierte OAuth-Anwendung erstellen, um:

• Kontrolle des Brandings des Authentifizierungsdialogs,
• die Umleitungs-URI steuern, zu der die Anwendung den Benutzer nach der Authentifizierung umleitet, oder
• Passen Sie die Berechtigungen an, die Sie vom Benutzer anfordern.

In den folgenden Abschnitten wird beschrieben, wie Sie mit dem Azure-Portal oder der Sharepoint-App eine benutzerdefinierte OAuth-Anwendung erstellen.

Azure Portal

Um OAuth-Werte für Ihre App zu erhalten, OAuthClientId Und OAuthClientSecret, und registrieren Sie eine benutzerdefinierte OAuth-Anwendung:

1. Melden Sie sich beim Azure Portal an.

2. Navigieren Sie im linken Navigationsbereich zu Microsoft Entra ID > App-Registrierungen.

3. Klicken Sie auf Add.

4. Geben Sie einen Anwendungsnamen ein.

5. Wählen Sie Konten in einem beliebigen Organisationsverzeichnis (Jeder Microsoft Entra ID Mandant - Multitenant).

6. Setzen Sie die Weiterleitungs URL auf http://localhost:33333 (Standardeinstellung des Anschlusses) oder legen Sie einen anderen Port Ihrer Wahl fest.

7. Satz CallbackURL an die genaue Antwort-URL, die Sie definiert haben.

   Das Portal erstellt die neue Anwendung.

8. Navigieren Sie zum Abschnitt „Zertifikate und Geheimnisse“.

9. Erstellen Sie ein Client-Geheimnis für die Anwendung und wählen Sie eine Dauer aus.

10. Nachdem Sie den Schlüssel gespeichert haben, wird der Schlüsselwert einmal angezeigt. Setzen Sie sofort OAuthClientSecret auf den angezeigten Wert. Setze OAuthClientId zur Anwendungs-ID.

11. Wählen Sie API Permissions.

12. Klicken Sie auf Add. Wenn Ihre Anwendung nur innerhalb eines Benutzerkontexts eine Verbindung herstellt, geben Sie delegierte Berechtigungen an.

13. Klicken Sie im Abschnitt API Berechtigungen auf Add a permission und wählen Sie SharePoint. Wählen Sie die Berechtigungen aus, die Ihre App haben soll. Um Listen anzuzeigen und zu bearbeiten, müssen Sie (mindestens) die auswählen AllSites.Manage Erlaubnis.

14. Speichern Sie Ihre Änderungen.

OAuth: Administratoreinwilligung

Administratorzustimmung bezieht sich darauf, wenn der Administrator für einen Microsoft Entra ID Mandanten Berechtigungen für eine Anwendung erteilt, für die die Zustimmung eines Administrators in Ihrer Organisation zum Anwendungsfall erforderlich ist.

Die eingebettete Anwendung im Jitterbit Connector für Microsoft SharePoint enthält keine Berechtigungen, die die Zustimmung des Administrators erfordern. Daher gelten diese Informationen nur für benutzerdefinierte Anwendungen.

Wenn Sie im Azure-Portal eine neue OAuth-Anwendung erstellen, müssen Sie angeben, welche Berechtigungen die Anwendung benötigt. Einige Berechtigungen können mit „Administratorzustimmung erforderlich“ gekennzeichnet sein. Beispielsweise erfordern alle Gruppenberechtigungen die Administratorzustimmung. Wenn Ihre Anwendung die Administratorzustimmung erfordert, können Sie dies auf zwei Arten tun.

Die einfachste Möglichkeit, die Administratorzustimmung zu erteilen, besteht darin, dass sich ein Administrator beim Azure Portal anmeldet und navigieren Sie zu der Anwendung, die Sie in App-Registrierungen erstellt haben. Klicken Sie unter API -Berechtigungen auf Grant Consent, das Berechtigungen für den Mandanten erteilt, unter dem es erstellt wurde.

Wenn Ihre Organisation mehrere Mandanten hat oder Sie Anwendungsberechtigungen für andere Mandanten außerhalb Ihrer Organisation erteilen müssen, verwenden Sie GetAdminConsentURL gespeicherte Prozedur*, um die Administratorautorisierungs URL zu generieren. Nachdem die OAuth-Anwendung erfolgreich autorisiert wurde, gibt sie einen Booleschen Wert zurück, der angibt, dass Berechtigungen erteilt wurden.

Nachdem der Administrator die OAuth-Anwendung genehmigt hat, können Sie mit der Authentifizierung fortfahren.

Sharepoint App

Um eine benutzerdefinierte OAuth-App zu erstellen und die Verbindungseigenschaften für die OAuth-Authentifizierung mithilfe der Sharepoint-App abzurufen, müssen Sie zuerst das Add-In registrieren und diesem Add-In dann Berechtigungen erteilen.

Registrieren des Add-Ins

1. Navigieren Sie zur Seite „Add-In registrieren“, indem Sie die URL folgendermaßen eingeben: https://{sitename}.SharePoint.com/_layouts/15/appregnew.aspx.
2. Klicken Sie im Abschnitt „App-Informationen“ auf Generate, das sich neben den Textfeldern „Client-ID“ und „Client-Geheimnis“ befindet, um die entsprechenden Werte zu generieren.
3. Legen Sie Titel, App-Domäne und Umleitungs-URI fest, indem Sie die entsprechenden Textfelder ausfüllen.
4. Klicken Sie auf Create.

Das Add-In wird registriert und die Sharepoint-App zeigt die erstellten Informationen an.

Erteilen von Berechtigungen für das Add-In

1. Navigieren Sie zur SharePoint-Site.

2. Geben Sie die URL ein: https://{sitename}-admin.sharepoint.com/_layouts/15/appinv.aspx im Browser. Dadurch werden Sie auf die Seite „Berechtigung erteilen“ weitergeleitet.

3. Bei App Id, geben Sie die zuvor generierte Client-ID ein und klicken Sie auf Lookup.

   Dadurch werden die Werte in die anderen Textfelder (Titel, App-Domäne und Umleitungs-URL) eingetragen.

4. Geben Sie die folgende Berechtigungsanfrage im XML-Format ein:

       <AppPermissionRequests AllowAppOnlyPolicy="true">
        <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/>
   </AppPermissionRequests>
   

5. Klicken Sie auf Create. Die Sharepoint-App zeigt einen Berechtigungsbestätigungsdialog an. Um die Berechtigungen zu erteilen, klicken Sie auf Trust It.

Mit REST- API verbinden

Microsoft SharePoint REST API wird sowohl auf Sharepoint OnPremise als auch auf Sharepoint Online unterstützt. Um eine Verbindung über die REST API herzustellen, setzen Sie Schema zum RUHEN.

Die Immobilie SharePointEdition kann verwendet werden, um die Edition von Sharepoint zu definieren.

Sharepoint Online

SharePoint Online verwendet den OAuth-Standard zur Authentifizierung. Befolgen Sie die Schritte unter „Authentifizierung bei SharePoint Online“ in Herstellen einer Verbindung für weitere Informationen.

SharePoint OnPremise

Folgen Sie den Schritten unter „Authentifizierung bei SharePoint vor Ort“ in Herstellen einer Verbindung für weitere Informationen.

Kerberos verwenden

Kerberos

Für die Authentifizierung bei Microsoft SharePoint über Kerberos müssen Sie Authentifizierungseigenschaften definieren und auswählen, wie Kerberos Authentifizierungstickets abrufen soll.

Festlegen der Authentifizierungseigenschaften

Um sich mit Kerberos bei Microsoft SharePoint zu authentifizieren, legen Sie diese Eigenschaften fest:

• hive.server2.authentication: Kerberos.
• AuthScheme: NEGOTIATE.
• KerberosKDC: Der Host oder die IP-Adresse Ihrer Kerberos-KDC-Maschine.
• KerberosRealm: Der Bereich des Microsoft SharePoint Kerberos-Prinzipals. Suchen Sie diesen Wert direkt nach dem '@'-Symbol des Prinzipalwerts.
• KerberosSPN: Der Dienst und Host des Microsoft SharePoint Kerberos-Prinzipals. Suchen Sie diesen Wert direkt vor dem Symbol „@“ des Prinzipalwerts.

Abrufen von Kerberos-Tickets

Kerberos-Tickets werden verwendet, um die Identität des Anforderers zu authentifizieren. Durch die Verwendung von Tickets anstelle von formellen Logins/Passwörtern entfällt die Notwendigkeit, Passwörter lokal zu speichern oder über ein Netzwerk zu senden. Benutzer werden erneut authentifiziert (Tickets werden aktualisiert), wenn sie sich an ihrem lokalen Computer anmelden oder kinit USER in der Eingabeaufforderung.

Der Connector bietet drei Möglichkeiten, das erforderliche Kerberos-Ticket abzurufen, je nachdem, ob das KRB5CCNAME und/oder KerberosKeytabFile Variablen sind in Ihrer Umfeld vorhanden.

MIT Kerberos-Anmeldeinformations-Cache-Datei

Mit dieser Option können Sie den MIT Kerberos Ticket Manager verwenden oder kinit Befehl zum Abrufen von Tickets. Mit dieser Option ist es nicht erforderlich, den User oder Password Verbindungseigenschaften.

Diese Option erfordert, dass KRB5CCNAME wurde in Ihrem System erstellt.

So aktivieren Sie den Ticketabruf über MIT Cerberos Credential Cache Files:

1. Stellen Sie sicher, dass KRB5CCNAME Variable ist in Ihrer Umfeld vorhanden.
2. Satz KRB5CCNAME zu einem Pfad, der auf Ihre Anmeldeinformations-Cachedatei verweist. (Beispiel: C:\krb_cache\krb5cc_0 oder /tmp/krb5cc_0.) Die Anmeldeinformations-Cachedatei wird erstellt, wenn Sie den MIT Kerberos Ticket Manager zum Generieren Ihres Tickets verwenden.

3. So erhalten Sie ein Ticket:

   1. Öffnen Sie die Anwendung MIT Kerberos Ticket Manager.
   2. Klicken Sie auf Get Ticket.
   3. Geben Sie Ihren Hauptnamen und Ihr Passwort ein.
   4. Klicken Sie auf OK.

   Wenn das Ticket erfolgreich abgerufen wurde, werden die Ticketinformationen im Kerberos Ticket Manager angezeigt und in der Anmeldeinformations-Cachedatei gespeichert.

Der Connector verwendet die Cachedatei, um das Kerberos-Ticket für die Verbindung mit Microsoft SharePoint abzurufen.

Keytab-Datei

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld, Sie können ein Kerberos-Ticket mithilfe einer Keytab-Datei abrufen.

Um diese Methode zu verwenden, setzen Sie die User Eigenschaft auf den gewünschten Benutzernamen und legen Sie die KerberosKeytabFile-Eigenschaft auf einen Dateipfad, der auf die mit dem Benutzer verknüpfte Keytab-Datei verweist.

Benutzer und Passwort

Wenn in Ihrer Umfeld die KRB5CCNAME Umfeld und die KerberosKeytabFile-Eigenschaft nicht festgelegt wurde, können Sie ein Ticket mithilfe einer Benutzer- und Passwortkombination abrufen.

Um diese Methode zu verwenden, legen Sie die-Eigenschaft fest User Und Password Eigenschaften für die Benutzer-/Passwortkombination, die Sie zur Authentifizierung bei Microsoft SharePoint verwenden.

Cross-Realm-Authentifizierung aktivieren

Komplexere Kerberos-Umgebungen können eine Cross-Realm-Authentifizierung erfordern, wenn mehrere Realms und KDC-Server verwendet werden. Beispielsweise können sie einen Realm/KDC für die Benutzerauthentifizierung und einen anderen Realm/KDC zum Abrufen des Servicetickets verwenden.

Um diese Art der Cross-Realm-Authentifizierung zu aktivieren, setzen Sie das KerberosRealm Und KerberosKDC Eigenschaften auf die Werte, die für die Benutzerauthentifizierung erforderlich sind. Setzen Sie außerdem die KerberosServiceRealm Und KerberosServiceKDC Eigenschaften auf die Werte, die zum Erhalt des Servicetickets erforderlich sind.

Optimieren des Datenzugriffs

Feinabstimmung der Microsoft SharePoint-Verbindung

Um den Datenzugriff in erweiterten Integrationen zu vereinfachen, verwenden Sie die folgenden Verbindungseigenschaften, um Spaltennamenkennungen und andere Aspekte des Datenzugriffs zu steuern:

• UseDisplayNames: Setzen Sie dies auf „true“, um Spaltennamen zurückzugeben, die mit den Feldnamen in der zugrunde liegenden API übereinstimmen
  . Standardmäßig verwendet der Connector Spaltennamen, die mit den in SharePoint definierten Feldnamen übereinstimmen.
• UseSimpleNames: Setzen Sie dies auf „true“, um Ersetzungen für Sonderzeichen in Spaltennamen vorzunehmen, die SharePoint zulässt, viele Datenbanken jedoch normalerweise nicht.
• ShowPredefinedColumns: Setzen Sie dies auf „false“, um Felder auszuschließen, die von Feldern in der Liste abgeleitet sind, z. B. „Author“ und „CreatedAt
  . Diese Einstellung schließt die vordefinierten Felder von der Rückgabe aus in SELECT * Anweisungen und Schema.
• ShowHiddenColumns: Wenn wahr, werden in SharePoint als ausgeblendet markierte Spalten vom Connector angezeigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Microsoft SharePoint-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Microsoft SharePoint und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Siehe Abfrageverarbeitung für weitere Informationen.

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Microsoft SharePoint können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Calendar WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Client-SSL-Zertifikate

Der Microsoft SharePoint-Connector unterstützt auch das Festlegen von Client-Zertifikaten. Legen Sie Folgendes fest, um eine Verbindung mithilfe eines Client-Zertifikats herzustellen.

• SSLClientCert: Der Name des Zertifikatspeichers für das Client-Zertifikat.
• SSLClientCertType: Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.
• SSLClientCertPassword: Das Passwort für das TLS/SSL-Client-Zertifikat.
• SSLClientCertSubject: Der Betreff des TLS/SSL-Client-Zertifikats.

SOAP Datenmodell

Der Jitterbit Connector für Microsoft SharePoint modelliert Microsoft SharePoint-Entitäten in relationalen Tabellen, Ansichten und gespeicherten Prozeduren. Die Tabellendefinitionen werden dynamisch basierend auf Ihrer Microsoft SharePoint-Site abgerufen. Alle von Ihnen vorgenommenen Änderungen, z. B. das Hinzufügen eines benutzerdefinierten Felds oder das Ändern des Datentyps eines Felds, werden automatisch übernommen, wenn Sie eine Verbindung herstellen.

Anpassen des Datenmodells

Der Connector legt Standardwerte fest, um die maximale Anzahl von Integrationen zu ermöglichen. Die folgenden Verbindungseigenschaften ermöglichen jedoch eine größere Anpassungsgranularität, die bei erweiterten Integrationen nützlich ist:

• CalculatedDataType: Der für berechnete Felder zu verwendende Datentyp.
• CreateIDColumns: Gibt an, ob zusätzliche ID-Spalten für SharePoint-Spalten erstellt werden sollen, die Werte aus in anderen Listen gespeicherten Informationen verwenden.
• FolderOption: Eine Option, um festzulegen, wie Ordner in Ergebnissen angezeigt werden. Geben Sie entweder „FilesOnly“, „FilesAndFolders“, „Recursive“ oder „RecursiveAll“ ein.
• PseudoColumns: Gibt an, ob Pseudospalten als Spalten in den Tabellenmetadaten gemeldet werden sollen oder nicht.

Tabellen

Tabellen beschreibt die verfügbaren Tabellen.

Der Connector kann benutzerdefinierte Listen aus Microsoft SharePoint verfügbar machen, die in den Tabellen nicht erwähnt werden. Das Datenmodell zeigt ein Beispiel, wie Ihre SharePoint-Site aussehen könnte. Das eigentliche Datenmodell wird dynamisch basierend auf Ihren Benutzeranmeldeinformationen und Ihrer SharePoint-Site abgerufen.

Ansichten

Normalerweise werden Entitäten, die nicht geändert werden können, als Ansichten dargestellt oder schreibgeschützte Tabellen. Sie können auch auf benutzerdefinierte Ansichten einer Liste als relationale Ansichten zugreifen.

Um Daten aus einer benutzerdefinierten Ansicht einer Liste abzurufen, können Sie die Pseudospalte ViewID in der WHERE-Klausel festlegen.

SELECT * FROM ListName WHERE ViewID='ID of the view'

Die ID der Ansicht können Sie unter Ansichten abrufen Liste. Sie müssen die Pseudospalte „Liste“ angeben, um eine Liste der Ansichten für diese Liste zu erhalten. Beispiel:

SELECT * FROM Views WHERE List ='ListName'

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie bieten zusätzliche Funktionen der Microsoft SharePoint-API, beispielsweise das Suchen, Aktualisieren und Ändern von Informationen.

Tabellen

Der Connector modelliert die Daten in Microsoft SharePoint in eine Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Microsoft SharePoint-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Anfrage gestellt werden muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Jitterbit-Connector für Microsoft SharePoint-Tabellen

Anlagen

Anhänge für das angegebene Element in der angegebenen Liste lesen oder löschen.

Tabellenspezifische Informationen

Wählen

Liste und Artikel-ID sind erforderlich, um Anhänge zurückzugeben.

Einfügen

Rufen Sie die AddAttachments gespeicherte Prozedur*, um einem Listenelement neue Anhänge hinzuzufügen.

Spalten

Gruppen

Erstellen, aktualisieren, löschen und Abfrage Gruppen aus SharePoint ab.

Tabellenspezifische Informationen

Einfügen

Die Spalten Name, DefaultLogin und OwnerLogin müssen in diese Tabelle eingefügt werden.

Um die Pseudospalte UserName zu verwenden, müssen Sie den Wert auf den LoginName des Benutzers setzen. Sie können den LoginNamen abrufen, indem Sie die Tabelle Users abfragen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Rollen

Erstellen, aktualisieren, löschen und Abfrage Rollen aus SharePoint ab.

Tabellenspezifische Informationen

Wählen

Um die Pseudospalte „UserName“ zu verwenden, müssen Sie den Wert auf den LoginName des Benutzers setzen. Sie können den LoginNamen abrufen, indem Sie die Tabelle „Benutzer“ abfragen.

Einfügen

Um eine Rolle einzufügen, ist mindestens der Name erforderlich:

INSERT INTO Roles (Name) VALUES ('My Role')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Benutzer

Aktualisieren, löschen und Abfrage Benutzer aus SharePoint.

Tabellenspezifische Informationen

Wählen

Alle für das SharePoint-Konto erstellten Benutzer abrufen:

SELECT * FROM Users

Sie können Benutzer abrufen, die zu einer bestimmten Gruppe gehören. Geben Sie in diesem Fall den Gruppennamen an.

SELECT * FROM Users WHERE`[Gruppe] `= "GroupName"

Oder Sie können Benutzer abrufen, die eine bestimmte Rolle haben. Geben Sie in diesem Fall den Rollennamen an

SELECT * FROM Users WHERE`[Rolle] `= "RoleName"

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Erstellen, aktualisieren, löschen und Abfrage die verfügbaren Listen in SharePoint ab.

Tabellenspezifische Informationen

Ansichten ist eine spezielle Tabelle. Sie kann verwendet werden, um Ansichten aus einer angegebenen Liste abzurufen, zu aktualisieren, einzufügen und zu löschen.

Wählen

Um Ergebnisse aus Ansichten zurückzugeben, muss entweder die ID oder die Liste in der SELECT-Anweisung angegeben werden. Beispiel:

SELECT * FROM Views WHERE List = 'MyListName'

Einfügen

Die Spalten „Liste“, „Name“, „Typ“ und „Felder“ müssen in diese Tabelle eingefügt werden.

Spalten

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Häufig wird eine gespeicherte Prozedur* ist verfügbar, um die Daten zu aktualisieren, wenn diese Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre es eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich.

Dynamische Ansichten, wie Abfragen, die als Ansichten angezeigt werden, und Ansichten zum Nachschlagen bestimmter Kombinationen von Projektteam-Arbeitselementen werden unterstützt.

Jitterbit-Connector für Microsoft SharePoint-Ansichten

Dateiversionen

Listet die auf SharePoint verfügbaren Dateiversionen auf.

Ansichtsspezifische Informationen

Bibliothek und Datei müssen angegeben werden, um Ergebnisse aus dieser Ansicht zurückzugeben.

Spalten

GetValidTerms

Ruft eine Liste gültiger Begriffe für die angegebene Spalte in der angegebenen Tabelle ab.

Tabellenspezifische Informationen

GetValidTerms ist eine spezielle Ansicht. Sie kann verwendet werden, um gültige Begriffe für eine Taxonomie- oder verwaltete Metadatenspalte einer bestimmten Liste abzurufen. Um die Ansicht zu verwenden, geben Sie sowohl den Namen der Tabelle als auch die Spalte an, für die Sie gültige Begriffe abrufen möchten. Beispiel:

SELECT * FROM GetValidTerms WHERE List = 'MyListName' AND ColumnName = 'MyManagedMetadataColumn'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Listen

Listet die verfügbaren Listen in SharePoint auf.

Tabellenspezifische Informationen

Listen können verwendet werden, um die Tabellen in SharePoint aufzulisten. Dadurch werden nur tatsächliche Listen in SharePoint zurückgegeben und keine speziellen Tabellen, die mit dem Connector verknüpft sind.

Die folgenden Spalten können in der WHERE-Klausel verwendet werden: Titel und BaseTemplate.

Spalten

Berechtigungen

Die Berechtigungen für eine Site oder Liste. Hinweis: Wenn die ItemID leer ist, sollte der ObjectType auf List oder Web gesetzt werden (ein ObjectName muss angegeben werden, wenn der ObjectType eine Liste ist). Wenn nicht, muss der ObjectName zusammen mit der ItemID angegeben werden.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Unterwebsites

Hier werden die verfügbaren Unterwebsites aufgelistet.

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren* sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Microsoft SharePoint hinaus erweitern.

Gespeicherte Prozeduren* akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Microsoft SharePoint zurück, zusammen mit einer Angabe, ob der Vorgang erfolgreich war oder fehlgeschlagen ist.

Jitterbit-Connector für gespeicherte Prozeduren in Microsoft SharePoint

Anhang hinzufügen

Fügen Sie einem SharePoint-Listenelement einen Anhang hinzu.

Eingang

Ergebnissatzspalten

Liste hinzufügen

Erstellt eine Liste auf einer SharePoint-Site.

Eingang

Ergebnissatzspalten

Listenspalte hinzufügen

Fügt der angegebenen Liste eine neue Spalte hinzu.

Eingang

Ergebnissatzspalten

BenutzerZurGruppe Hinzufügen

Fügen Sie den Benutzer der angegebenen Gruppe hinzu.

Eingang

Ergebnissatzspalten

Benutzer zur Rolle hinzufügen

Fügen Sie den Benutzer der angegebenen Rolle hinzu.

Eingang

Ergebnissatzspalten

Dokument einchecken

Checkt ein Dokument in SharePoint ein und hebt die Sperre des Dokuments auf.

Eingang

Ergebnissatzspalten

Dokument auschecken

Checkt ein Dokument aus SharePoint aus.

Eingang

Ergebnissatzspalten

Dokument kopieren

Kopiert ein Dokument aus der SharePoint-Bibliothek.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für die Prozedur.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Geben Sie mehrere Instanzen eines indizierten Parameters wie folgt ein:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Eingang

Ergebnissatzspalten

Ordner erstellen

Fügt einer Dokumentbibliothek auf einer SharePoint-Site einen Ordner hinzu.

Eingang

Ergebnissatzspalten

Schema erstellen

Erstellt die Schema für die angegebene SharePoint-Liste. Die Schema kann manuell angepasst werden, um unerwünschte Spalten auszuschließen oder zusätzliche Informationen zu Spalten einzuschließen.

Eingang

Ergebnissatzspalten

Anhang löschen

Löschen Sie einen Anhang aus einem SharePoint-Listenelement.

Eingang

Ergebnissatzspalten

Dokument löschen

Löschen Sie ein Dokument in der SharePoint-Bibliothek.

Eingang

Ergebnissatzspalten

Liste löschen

Löscht eine Liste dauerhaft von einer SharePoint-Site.

Eingang

Ergebnissatzspalten

Listenspalte löschen

Löscht eine Spalte aus der angegebenen Liste.

Eingang

Ergebnissatzspalten

Benutzer aus Gruppe löschen

Löschen Sie den Benutzer aus der angegebenen Gruppe.

Eingang

Ergebnissatzspalten

Benutzer aus Rolle löschen

Löschen Sie den Benutzer aus der angegebenen Rolle.

Eingang

Ergebnissatzspalten

Auschecken von Dokumenten verwerfen

Verwirft das Auschecken eines Dokuments in SharePoint. Dadurch wird keine neue Datei in SharePoint eingecheckt. Es wird nur die Sperre des Dokuments aufgehoben.

Eingang

Ergebnissatzspalten

Anhang herunterladen

Laden Sie ein Dokument aus der SharePoint-Liste herunter.

Eingang

Ergebnissatzspalten

Dokument herunterladen

Laden Sie ein Dokument aus der SharePoint-Bibliothek herunter.

Eingang

Ergebnissatzspalten

Anhang oder Dokument verschieben

Verschiebt ein Dokument oder einen Anhang aus einem Quellordner in einen Zielordner.

Die MoveAttachmentOrDocument gespeicherte Prozedur* erfordert die Parameter List, SourceFileURL und DestinationFolderURL, um einen Anhang oder ein Dokument zu verschieben.

Beispiel:

EXEC MoveAttachmentOrDocument List = 'Test134', SourceFileURL = '/Shared Documents/Dummy.txt', DestinationFolderURL = '/Shared Documents/MySite'

Eingang

Ergebnissatzspalten

Anhang oder Dokument umbenennen

Benennt ein Dokument oder einen Anhang um.

Die RenameAttachmentOrDocument gespeicherte Prozedur* erfordert die Parameter List, SourceFileURL und NewFileName, um einen Anhang oder ein Dokument umzubenennen.

Beispiel:

EXEC RenameAttachmentOrDocument List = 'Test134', SourceFileURL = '/Shared Documents/Dummy.txt', NewFileName = 'Dummy1.txt'

Eingang

Ergebnissatzspalten

Liste aktualisieren

Aktualisiert eine Liste auf einer SharePoint-Site.

Eingang

Ergebnissatzspalten

Listenspalte aktualisieren

Aktualisiert eine Spalte der angegebenen Liste.

Eingang

Ergebnissatzspalten

Dokument hochladen

Laden Sie ein Dokument in die SharePoint-Bibliothek hoch.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für die Prozedur.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Geben Sie mehrere Instanzen eines indizierten Parameters wie folgt ein:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Eingang

Ergebnissatzspalten

REST-Datenmodell

Der Jitterbit Connector für Microsoft SharePoint modelliert Microsoft SharePoint-Entitäten in relationalen Tabellen, Ansichten und gespeicherten Prozeduren. Die Tabellendefinitionen werden dynamisch basierend auf Ihrer Microsoft SharePoint-Site abgerufen. Alle von Ihnen vorgenommenen Änderungen, z. B. das Hinzufügen eines benutzerdefinierten Felds oder das Ändern des Datentyps eines Felds, werden automatisch übernommen, wenn Sie eine Verbindung herstellen.

Tabellen

Tabellen beschreibt die verfügbaren Tabellen.

Listen auf Ihrer Microsoft SharePoint-Site werden dynamisch als relationale Tabellen angezeigt. Das bedeutet, dass jede Änderung, die Sie an Ihren Listen vornehmen, z. B. das Hinzufügen neuer Listen oder Felder, im Treiber widergespiegelt wird.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden schreibgeschützte Daten als Ansichten angezeigt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie bieten zusätzliche Funktionen der Microsoft SharePoint-API, beispielsweise das Suchen, Aktualisieren und Ändern von Informationen.

OData Standard verwenden

Da die REST- API auf OData basiert, werden serverseitige Filter mit dem OData-Standard durchgeführt. Der Treiber übernimmt also die Serverfilterung optimal, indem er die Metadatendatei liest und feststellt, welche Filter auf dem Server durchgeführt werden können.

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Häufig wird eine gespeicherte Prozedur* ist verfügbar, um die Daten zu aktualisieren, wenn diese Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre es eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich.

Dynamische Ansichten, wie Abfragen, die als Ansichten angezeigt werden, und Ansichten zum Nachschlagen bestimmter Kombinationen von Projektteam-Arbeitselementen werden unterstützt.

Jitterbit-Connector für Microsoft SharePoint-Ansichten

Anlagen

Anhänge für das angegebene Element in der angegebenen Liste lesen.

Tabellenspezifische Informationen

Wählen

Die Liste kann aus der Listenansicht (Spalte „Titel“) abgerufen werden.

SELECT * FROM Attachments WHERE List = 'TestApp' AND ItemID = 1

Spalten

Dateien

Fragen Sie die verfügbaren Dateien auf Ihrer SharePoint-Site ab.

Spalten

Gruppen

Fragen Sie die verfügbaren Gruppen auf Ihrer SharePoint-Site ab.

Tabellenspezifische Informationen

Wählen

SELECT * FROM Groups

Spalten

Listen

Fragen Sie die verfügbaren Listen auf Ihrer SharePoint-Site ab.

Spalten

Rollenzuweisungsmitglied

Web RoleAssignments-Mitglied erhalten.

Tabellenspezifische Informationen

Wählen

SELECT * FROM RoleAssignmentMember WHERE PrincipalId = 3
SELECT * FROM RoleAssignmentMember WHERE List = 'TestApp' AND PrincipalId = 3

SELECT * FROM RoleAssignmentMember WHERE PrincipalId = 5 AND list = 'KatsunariMatsumoto' AND ItemId = '3'

Spalten

Rollenzuweisungen

Web-Rollenzuweisungen erhalten.

Tabellenspezifische Informationen

Wählen

SELECT * FROM RoleAssignments WHERE List = 'TestApp'

SELECT * FROM RoleAssignments WHERE PrincipalId = 5 AND list = 'KatsunariMatsumoto' AND ItemId = '3'

Spalten

Rollendefinitionsbindungen

Bindung der Webrollendefinition abrufen.

Tabellenspezifische Informationen

Wählen

SELECT * FROM RoleDefinitionBindings WHERE PrincipalId = 3
SELECT * FROM RoleDefinitionBindings WHERE List = 'TestApp' AND PrincipalId = 3

SELECT * FROM RoleDefinitionBindings WHERE PrincipalId = 5 AND list = 'KatsunariMatsumoto' AND ItemId = '3'

Spalten

Rollen

Fragen Sie ab, welche Rollen Ihre Benutzer haben können.

Spalten

Unterwebsites

Hier werden die verfügbaren Unterwebsites aufgelistet.

Tabellenspezifische Informationen

Wählen

SELECT * FROM Subsites

Spalten

Benutzer

Fragen Sie die verfügbaren Benutzer auf Ihrer SharePoint-Site ab.

Tabellenspezifische Informationen

Wählen

SELECT * FROM Users // Fetch all the Users

SELECT * FROM Users WHERE GroupId = 5 // Fetch a user for a particular Group

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren* sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit Microsoft SharePoint hinaus erweitern.

Gespeicherte Prozeduren* akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von Microsoft SharePoint zurück, zusammen mit einer Angabe, ob der Vorgang erfolgreich war oder fehlgeschlagen ist.

Jitterbit-Connector für gespeicherte Prozeduren in Microsoft SharePoint

Anhang hinzufügen

Fügen Sie einen Anhang zu einer SharePoint-Liste hinzu.

Eingang

Ergebnissatzspalten

Dokument einchecken

Ein bestimmtes Dokument in der Dokumentbibliothek einchecken.

Eingang

Ergebnissatzspalten

Dokument auschecken

Schauen Sie sich ein bestimmtes Dokument in der Dokumentbibliothek an.

Eingang

Ergebnissatzspalten

Dokument kopieren

Kopiert die Datei zur Ziel URL.

Eingang

Ergebnissatzspalten

Ordner erstellen

Fügt einer Dokumentbibliothek auf einer SharePoint-Site einen Ordner hinzu.

Eingang

Ergebnissatzspalten

Anhang löschen

Löscht einen Anhang aus der Sharepoint-Liste.

Eingang

Ergebnissatzspalten

Dokument löschen

Löschen Sie ein Dokument aus der SharePoint-Dokumentenbibliothek.

Eingang

Ergebnissatzspalten

VerwerfenCheckOutDocument

Macht einen bestehenden Checkout für die Datei rückgängig.

Eingang

Ergebnissatzspalten

Anhang herunterladen {: #pg_restsp-downloadattachment}##### Stored Procedure* Spezifische Informationen

Laden Sie ein Dokument aus der SharePoint-Liste herunter.

Gespeicherte Prozedur* Spezifische Informationen

Einfügen

RemoteFile kann relativ zum Server sein oder die vollständige URL der Datei. Nachfolgend einige Beispiele:

EXECUTE DownloadAttachment File = 'C:/Users/User/Desktop/DownloadedFile.txt', RemoteFile = 'https://mysite.sharepoint.com/Lists/MyCustomList/Attachments/1/FileToDownload.txt';

EXECUTE DownloadAttachment File = 'C:/Users/User/Desktop/DownloadedFile.txt', RemoteFile = '/Lists/MyCustomList/Attachments/1/FileToDownload.txt';

Eingabe

Ergebnissatzspalten

DownloadDocument

Laden Sie ein Dokument aus der SharePoint-Bibliothek herunter.

Stored Procedure* Spezifische Informationen

Einfügen

RemoteFile kann relativ zur Bibliothek sein oder die vollständige URL der Datei. Nachfolgend einige Beispiele:

EXECUTE DownloadDocument File = 'C:/Users/User/Desktop/DownloadedFile.txt', Library = 'Shared Documents', RemoteFile = 'https://mysite.sharepoint.com/Shared Documents/newFolder/FileToDownload.txt';

EXECUTE DownloadDocument File = 'C:/Users/User/Desktop/DownloadedFile.txt', Library = 'Shared Documents', RemoteFile = '/newFolder/FileToDownload.txt';

Eingabe

Ergebnissatzspalten

GetAdminConsentURL

Ruft die Administratoreinwilligungs URL ab, die von einem Administrator einer bestimmten Domäne separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Nur erforderlich, wenn benutzerdefinierte OAuth-Anmeldeinformationen verwendet werden.

Eingabe

Ergebnissatzspalten

GetCurrentUser

Ruft Informationen über den aktuell angemeldeten Benutzer ab.

Ergebnissatzspalten

GetOAuthAccessToken

Ruft das OAuth-Zugriffstoken von SharePoint ab.

Input

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die SharePoint-Autorisierungs URL ab. Greifen Sie in einem Webbrowser auf die in der Ausgabe zurückgegebene URL zu. Dadurch wird das Zugriffstoken angefordert, das als Teil der Verbindungszeichenfolge zu SharePoint verwendet werden kann.

Eingabe

Ergebnissatzspalten

MoveAttachmentOrDocument

Verschiebt ein Dokument oder einen Anhang von einem Quellordner in einen Zielordner.

Die MoveAttachmentOrDocument gespeicherte Prozedur* erfordert die Parameter SourceFileURL und DestinationFolderURL, um einen Anhang oder ein Dokument zu verschieben.

Beispiel:

EXEC MoveAttachmentOrDocument SourceFileURL = '/Shared Documents/Dummy.txt', DestinationFolderURL = '/Shared Documents/MySite'

Eingabe

Ergebnissatzspalten

RefreshOAuthAccessToken

Aktualisiert das OAuth-Zugriffstoken, das für die Authentifizierung mit SharePoint verwendet wird.

Input

Ergebnissatzspalten

RenameAttachmentOrDocument

Benennt ein Dokument oder einen Anhang um.

Die RenameAttachmentOrDocument gespeicherte Prozedur* erfordert die Parameter SourceFileURL und NewFileName, um einen Anhang oder ein Dokument umzubenennen.

Beispiel:

EXEC RenameAttachmentOrDocument  SourceFileURL = '/Shared Documents/Dummy.txt', NewFileName = 'Dummy1.txt'

Eingabe

Ergebnissatzspalten

UploadDocument

Lädt ein Dokument in die SharePoint-Bibliothek hoch.

Input

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für Microsoft SharePoint zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt gespeicherte Prozedur* Parameter.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück, einschließlich Charge:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Kalendertabelle zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Calendar' 

Spalten

sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

sys_procedureparameters

Beschreibt gespeicherte Prozedur* Parameter.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur ListItems zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='ListItems' AND Direction=1 OR Direction=2

Spalten

sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Kalendertabelle ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Calendar'

Spalten

sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

sys_primarykeys

Beschreibt die Primärschlüssel.

Die folgende Abfrage ruft die Primärschlüssel aus allen Tabellen und Ansichten ab:

SELECT * FROM sys_primarykeys

Spalten

sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:sharepoint:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Entdecken Sie die SELECT-Funktionen der Datenquelle

Unten sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden. Andernfalls enthält die Spalte NO.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'