Microsoft SharePoint On Prem
Durchsuchen Sie Dokumente, die in einer lokalen Microsoft SharePoint-Datenquelle gespeichert sind.
IBM Cloud Pak for Data IBM Software Hub
Diese Informationen gelten nur für installierte Bereitstellungen. Weitere Informationen zum Herstellen einer Verbindung mit einer lokalen SharePoint-Site von einer verwalteten Bereitstellung aus finden Sie unter SharePoint On Prem.
Welche Dokumente werden gecrawlt
- Nur Dokumente, die von Discovery unterstützt werden, werden durchsucht; alle anderen werden ignoriert. Weitere Informationen finden Sie unter Unterstützte Dateitypen.
- Sicherheit auf Dokumentenebene wird unterstützt. Wenn diese Option aktiviert ist, können Ihre Benutzer denselben Inhalt durchsuchen und abfragen, auf den sie zugreifen können, wenn sie bei SharePoint angemeldet sind. Weitere Informationen finden Sie unter Unterstützung der Sicherheit auf Dokumentenebene.
- Wenn eine Quelle erneut durchsucht wird, werden neue Dokumente hinzugefügt, aktualisierte Dokumente werden auf die aktuelle Version geändert und gelöschte Dokumente werden aus dem Index der Sammlung gelöscht.
- Alle Discovery Datenquellenkonnektoren sind schreibgeschützt. Unabhängig von den Berechtigungen, die dem Crawl-Konto gewährt werden, schreibt, aktualisiert oder löscht Discovery niemals Inhalte in der ursprünglichen Datenquelle.
Datenquellenvoraussetzungen
Zusätzlich zu den Datenquellenanforderungen für alle installierten Bereitstellungen muss Ihre SharePoint On Prem-Datenquelle die folgenden Anforderungen erfüllen:
- Die Datenquellenverbindung unterstützt SharePoint 2013, 2016 oder 2019.
- Sie müssen alle erforderlichen Servicelizenzen für die Datenquelle erwerben, mit der Sie eine Verbindung herstellen möchten. Weitere Informationen zu Lizenzen erhalten Sie vom Systemadministrator der Datenquelle.
Weitere Informationen über SharePoint On Prem finden Sie in der Microsoft SharePoint Entwicklerdokumentation.
Vorausgesetzte Schritte
Bevor Sie eine SharePoint On Prem-Sammlung erstellen, müssen Sie die folgenden Schritte ausführen:
-
Arbeiten Sie mit dem Sharepoint-Administrator zusammen, um die Einrichtung eines vollständigen Lesezugriffs für die Webanwendung zu koordinieren.
Weitere Informationen finden Sie unter Berechtigungen für eine Webanwendung in Sharepoint Server verwalten.
-
Wenn Sie die Sicherheit auf Dokumentenebene aktivieren möchten, müssen Sie einige Schritte unternehmen, um sie einzurichten. Weitere Informationen finden Sie unter Unterstützung der Sicherheit auf Dokumentenebene.
Sie müssen die folgenden Informationen vom LDAP-Administrator einholen:
- URL des LDAP-Servers
- Der LDAP-Server URL, mit dem eine Verbindung hergestellt werden soll, z. B.
ldap://<ldap_server>:<port>
. - LDAP-Bindungs-Benutzername
- Der Benutzername, der zur Verknüpfung mit dem Verzeichnisdienst verwendet wird. In den meisten Fällen ist dieser Benutzername ein definierter Name (DN). Der Anmeldename kann manchmal für Active Directory funktionieren. Aber im Gegensatz zur allgemeinen Windows-Anmeldung wird die Groß-/Kleinschreibung beachtet. Der distinguierte Name funktioniert immer.
- Passwort für LDAP-Benutzer
- Das Passwort, das für die Verknüpfung mit dem Verzeichnisdienst verwendet wird.
- LDAP-Basis-DN
- Der Ausgangspunkt für die Suche nach Benutzereinträgen in LDAP, z. B.
CN=Users,DC=example,DC=com
. - LDAP-Benutzerfilter
- Der Benutzerfilter zum Durchsuchen von Benutzereinträgen in LDAP. Wenn keine Angabe gemacht wird, lautet der Standardwert
(userPrincipalName={0})
.
Wenn Sie die Version 2.2.1 oder eine frühere Version verwenden, müssen Sie einige zusätzliche Aufgaben erfüllen, bevor Sie eine Verbindung zur Datenquelle herstellen können. Weitere Informationen finden Sie unter SharePoint unter Prem prerequisite steps for prior releases.
Verbinden mit einer SharePoint On Prem Datenquelle
Führen Sie die folgenden Schritte für Ihr Discovery-Projekt aus:
-
Wählen Sie im Navigationsbereich Sammlungen verwalten.
-
Klicken Sie auf "Neue Kollektion ".
-
Klicken Sie auf SharePoint On Prem, und klicken Sie dann auf Next.
-
Benennen Sie die Sammlung.
-
Wenn die Sprache der Dokumente in SharePoint nicht Englisch ist, wählen Sie die entsprechende Sprache.
Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung.
-
Optional: Ändern Sie den Synchronisierungszeitplan.
Weitere Informationen finden Sie unter Kriechplanoptionen.
-
Füllen Sie im Abschnitt Eingabe Ihrer Zugangsdaten die folgenden Felder aus:
- Benutzername
- Der Benutzername des Benutzers SharePoint mit Zugriff auf alle Websites und Listen, die durchsucht und indiziert werden müssen.
- Kennwort
- Das Passwort des Benutzers SharePoint.
Dieser Wert wird nie zurückgegeben und nur verwendet, wenn Sie Anmeldeinformationen erstellen oder ändern.
-
Optional: Wenn Sie die auf Ansprüchen basierende Authentifizierung mit Security Assertion Mark-up Language (SAML) verwenden möchten, setzen Sie den Schalter SAML-Authentifizierung aktivieren auf
On
. Andernfalls wird die Windows NT LAN Manager (NTLM)-Authentifizierung verwendet. Fügen Sie Werte zu den folgenden Feldern hinzu:- Endpunkt des Identitätsanbieters
- Die URL des Identity Provider-Endpunkts, z. B.
https://adfs.server.example.com/adfs/services/trust/2005/UsernameMixed
. - Endpunkt der vertrauenswürdigen Partei
- Optional. Die URL des Relying Party Trust-Endpunkts. Wenn nicht anders angegeben, wird der folgende Wert verwendet:
https://<sharepoint_server>:<port>/_trust/
. - Kennung der vertrauenswürdigen Partei
- Die URL der Relying Party Trust-Kennung, z. B.
urn:sharepoint:sample
. Wenn nicht anders angegeben, wird der folgende Wert verwendet:https://<sharepoint_server>:<port>/_trust/
. Dieses Feature ist in den Versionen 2013, 2016 und 2019 verfügbar.
-
Fügen Sie im Abschnitt "Geben Sie an, was Sie crawlen möchten" den Webdienst SharePoint URL zum Feld "Webanwendungs-URL" hinzu. Zum Beispiel
https://<host>:<port>
. -
Optional: Wenn Sie einen Proxyserver für den Zugriff auf den Datenquellenserver verwenden, setzen Sie im Abschnitt Proxyeinstellungen den Schalter Proxyeinstellungen aktivieren auf
On
. Fügen Sie Werte zu den folgenden Feldern hinzu:- Benutzername
- Optional. Der Benutzername für die Authentifizierung am Proxyserver, falls der Proxyserver eine Authentifizierung erfordert. Wenn Sie Ihren Benutzernamen nicht kennen, können Sie ihn vom Administrator Ihres Proxy-Servers erhalten.
- Kennwort
- Optional. Das Passwort für den Proxyserver zur Authentifizierung, falls der Proxyserver eine Authentifizierung erfordert. Wenn Sie Ihr Kennwort nicht kennen, können Sie es vom Administrator Ihres Proxy-Servers erhalten.
- Hostname oder IP-Adresse des Proxyservers
- Der Hostname oder die IP-Adresse des Proxy-Servers.
- Portnummer des Proxy-Servers
- Der Netzwerkport, mit dem Sie sich auf dem Proxy-Server verbinden möchten.
-
Optional: Wenn Sie die Sicherheit auf Dokumentebene aktivieren möchten, setzen Sie im Abschnitt Sicherheit den Schalter Sicherheit auf Dokumentebene aktivieren auf
On
.Wenn diese Option aktiviert ist, können Ihre Benutzer denselben Inhalt durchsuchen und abfragen, auf den sie zugreifen können, wenn sie bei SharePoint angemeldet sind. Führen Sie die Voraussetzungsschritte aus, um Unterstützung hinzuzufügen.
Wenn Sie diese Option aktivieren, müssen Sie Werte für die folgenden Felder angeben:
- URL des LDAP-Servers
- Der LDAP-Server URL, mit dem eine Verbindung hergestellt werden soll, z. B.
ldap://<ldap_server>:<port>
. - LDAP-Bindungs-Benutzername
- Der Benutzername, der zur Verknüpfung mit dem Verzeichnisdienst verwendet wird. In den meisten Fällen ist dieser Benutzername ein definierter Name (DN). Der Anmeldename kann manchmal für Active Directory funktionieren. Aber im Gegensatz zur allgemeinen Windows-Anmeldung wird die Groß-/Kleinschreibung beachtet. Der distinguierte Name funktioniert immer.
- Passwort für LDAP-Benutzer
- Das Passwort, das für die Verknüpfung mit dem Verzeichnisdienst verwendet wird.
- LDAP-Basis-DN
- Der Ausgangspunkt für die Suche nach Benutzereinträgen in LDAP, z. B.
CN=Users,DC=example,DC=com
. - LDAP-Benutzerfilter
- Der Benutzerfilter zum Durchsuchen von Benutzereinträgen in LDAP. Wenn keine Angabe gemacht wird, lautet der Standardwert
(userPrincipalName={0})
.
-
Wenn Sie möchten, dass der Crawler Text aus Bildern auf der Website extrahiert, erweitern Sie Weitere Verarbeitungseinstellungen und setzen Sie optische Zeichenerkennung (OCR) anwenden auf
On
.Wenn OCR aktiviert ist und Ihre Dokumente Bilder enthalten, dauert die Verarbeitung länger. Weitere Informationen finden Sie unter Optische Zeichenerkennung.
-
Klicken Sie auf Beenden.
Die Sammlung ist schnell erstellt. Die Verarbeitung der Daten nimmt mehr Zeit in Anspruch, wenn sie der Sammlung hinzugefügt werden.
Wenn Sie den Fortschritt überprüfen möchten, gehen Sie auf die Seite Aktivität. Klicken Sie im Navigationsbereich auf Sammlungen verwalten und dann auf , um die Sammlung zu öffnen.
Voraussetzungsschritte für frühere Releases
Wenn Sie die Version 2.2.1 oder früher verwenden, müssen Sie diese zusätzlichen Schritte ausführen, bevor Sie eine Verbindung zur Datenquelle herstellen können:
- Beziehen Sie ein Webservice-Paket von Ihrem Discovery-Cluster. Dieses Paket für Web-Services ist ein angepasstes Modul, das der Crawler für den Abruf von Informationen verwendet, die für eine erfolgreiche Crawlersuche notwendig sind. Weitere Informationen finden Sie unter Holen Sie das Webservice-Paket.
- Stellen Sie das Webdienstpaket auf dem SharePoint-Server bereit. Weitere Informationen finden Sie unter Bereitstellen der Webdienste auf dem SharePoint-Server.
Holen Sie sich das Webservice-Paket
Um das Webservice-Paket von Ihrem Discovery-Cluster zu erhalten, führen Sie die folgenden Schritte aus:
-
Melden Sie sich am Discovery-Cluster an.
-
Geben Sie den folgenden Befehl ein, um Ihren Pod-Namen
crawler
zu erhalten:oc get pods | grep crawler
Möglicherweise wird eine Ausgabe ähnlich der folgenden Meldung angezeigt:
wd-discovery-crawler-57985fc5cf-rxk89 1/1 Running 0 85m
-
Geben Sie den folgenden Befehl ein, um die Datei
ESSPSolution.wsp
zu erhalten, und ersetzen Sie dabei{crawler-pod-name}
durch den Pod-Namencrawler
, den Sie im vorherigen Schritt erhalten haben:oc exec {crawler-pod-name} -- ls -l /opt/ibm/wex/zing/resources/ | grep ESSPSolution
Möglicherweise wird eine Ausgabe ähnlich der folgenden Meldung angezeigt:
-rw-r--r--. 1 dadmin dadmin 8600 Feb 3 08:23 ESSPSolution-${build-version}.wsp
-
Geben Sie den folgenden Befehl ein, um die Datei
ESSPSolution.wsp
auf den Hostserver zu kopieren, und ersetzen Sie dabei{build-version}
durch die Build-Versionsnummer aus dem vorherigen Schritt und{crawler-pod-name}
durch den Pod-Namencrawler
:oc cp {crawler-pod-name}:/opt/ibm/wex/zing/resources/ESSPSolution-${build-version}.wsp ESSPSolution.wsp
Stellen Sie die Webdienste auf dem SharePoint-Server bereit
Sie können die Web-Services entweder manuell auf dem SharePoint-Server bereitstellen oder ein Script ausführen, das sie automatisch implementiert.
So führen Sie das Skript aus, das die Webdienste automatisch bereitstellt:
-
Führen Sie das Script
ESSPSolution.wsp
auf dem SharePoint-Server aus, indem Sie das folgende Windows PowerShell-cmdlet eingeben:Add-SPSolution -LiteralPath C:\files\ESSPSolution.wsp
-
In SharePoint, öffnen Sie SharePoint Central Administration und öffnen dann die Systemeinstellungen.
-
Verteilen Sie das Paket mithilfe von Farmlösungen.
-
Wählen Sie die Lösung
esspsolution.wsp
aus und stellen Sie sie bereit.Nachdem die Bereitstellung abgeschlossen ist, wird die Farmlösung in der SharePoint-Administrationskonsole aufgelistet. Ein Administrator kann die Lösung aktivieren oder inaktivieren und Auslöser planen.
-
Optional: Unabhängig von der Methode, die Sie für die Bereitstellung der Webdienste verwendet haben, müssen Sie in einigen Umgebungen möglicherweise die folgenden Konfigurationen auf den Internetinformationsdienste-Server (IIS) anwenden, der den SharePoint-Server und die Webdienste hostet:
- Ermöglichen Sie .NET-Identitätswechsel unter IIS
- Ändern Sie die ASP.NET-Vertrauensebene in WSS_Medium
Sie können diese Konfigurationen im Internet Information Services Manager anwenden.