„Server URL“

Die URL der Sharepoint Online Instanz, z.B.: https://mycompany.sharepoint.com

„Admin Server URL“

Die Admin URL der Sharepoint Online Instanz. Meistens ist es die Server URL mit einem -admin, z.B. https://mycompany-admin.sharepoint.com

„Site Relative URL“

Die relativen Pfade zu den Sites, die gecrawlt werden sollen, beginnend mit einem Schrägstrich, z.B.: /sites/mysite. Jede Zeile beinhaltet einen Pfad.

Wenn dieses Feld leergelassen wird, werden automatisch alle Sites im Sharepoint Online gefunden und indiziert. Wenn Sites angegeben werden, werden nur die Subsites der angegebenen Sites gefunden.

„Detect Yammer Attachment Sites“

Wenn diese Einstellung aktiviert ist, versucht der Crawler zusätzlich zu Ihren aktuell konfigurierten Site Discovery Settings jede SharePoint Site zu finden, die automatisch von Yammer erstellt wurde, um Anhänge zu speichern.

Wenn diese Einstellung aktiviert ist und keine Site Relative URLs definiert sind, werden nur Yammer Attachment Seiten gecrawlt.
Wenn Site Relative URLs definiert sind, werden sowohl diese definierten URLs als auch alle Yammer Attachment Seiten gecrawlt.

„Site Discovery Schedule“

Eine Extended Cron Expression, die angibt, wann die Site Discovery ausgeführt werden soll. Die Ergebnisse werden dann bei den nächsten Crawlruns verwendet. Dadurch muss die eventuell aufwändige Site Discovery nicht bei jedem Crawlrun wiederholt werden.

Eine Dokumentation und Beispiele zu Cron Expressions finden Sie hier.

“Background Site Discovery Parallel Request Count”
(Advanced Settings)

Maximale Anzahl an HTTP Requests die parallel von der Site Discovery gesendet werden.

“Site Discovery Strategy”
(Advanced Settings)

Die Methode, mit der die Site Discovery durchgeführt werden soll.

• Auto: Es wird anhand der Authentisierungsmethode automatisch entschieden, welche Methode verwendet werden soll.
• Admin API: Es wird die SharePoint Admin API für die Site Discovery verwendet. Dadurch werden ALLE Seiten der SharePoint Online Instanz gefunden. Hierfür muss entweder App-Only Authentication oder User-Based Authentication mit einem Admin User verwendet werden.
• Search: Es wird die SharePoint Online Suche für die Site Discovery verwendet. Dadurch können automatisch nur Seiten gefunden werden, auf die der Crawl User Zugriff hat.
• Für User Based Authentication ohne Admin User, kann nur diese Methode verwendet werden.

“Ignore Site Discovery Errors”
(Advanced Settings)

Wenn diese Option aktiviert ist, werden sämtliche Fehler bei der Site Discovery nur geloggt und ansonsten ignoriert.

Diese Option können Sie verwenden, wenn Sie eine große und sich stetig ändernde Anzahl an Sites haben, und dabei unerwartete Fehler auftreten.

“Do Not Crawl Root Site”

Wenn diese Option aktiviert ist, wird die Rootseite der Sharepoint Online Instanz (also z.B. mycompany.sharepoint.com) und deren Subseiten nicht gecrawlt.

„Included Sites URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Subsites gecrawlt werden sollen. Wenn diese Option leer gelassen wird, werden alle Subsites gecrawlt. Die Regex matched auf relative URLs. z.B. /sites/mysite

„Excluded Sites URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Subsites exkludiert werden sollen. Die Regex matched auf relative URLs. z.B. /sites/mysite

„Included Lists/Files/Folders URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Listen, Files und Folders inkludiert werden sollen. Verglichen wird das Metadatum „url“ (absolute URL). Wenn diese Option leer gelassen wird, wird alles inkludiert.

Anmerkung: Wenn Sie komplette Subsites aus inkludieren/exkludieren wollen, verwenden Sie bitte die Option „Included Sites URL (regex)“ oder „Excluded Sites URL (regex)“.

„Excluded Lists/Files/Folders URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Listen, Files und Folders exkludiert werden sollen. Verglichen wird das Metadatum „url“ (absolute URL).

Wenn Sie beispielsweise in der Mindbreeze Suche ein Dokument finden, das sie jedoch exkludieren möchten, können Sie die URL aus der „Öffnen“-Aktion kopieren und in der Option „Excluded Lists/Files/Folders URL (regex)“ verwenden.

“Included Metadata Names (regex)” (Advanced Settings)

Regular Expression, mit der generische Metadaten mit Namen des Metadatum inkludiert werden sollen. Wenn nichts angegeben ist, werden alle Metadaten inkludiert. Die Regex wird auf den Namen des Metadatums (ohne den sp_ Prefix) angewendet.

“Excluded Metadata Names (regex)” (Advanced Settings)

Regular Expression, mit der generische Metadaten mit Namen des Metadatum ausgeschlossen werden. Wenn nichts angegeben ist, werden alle Metadaten inkludiert. Die Regex wird auf den Namen des Metadatums (ohne den sp_ Prefix) angewendet.

“Index Complex Metadata Types (regex)”
(Advanced Settings)

Regular Expression, mit der komplexe Metadaten für die Indizierung inkludiert werden können. Per Default werden komplexe Metadaten (z.B. Metadateneinträge, die selbst wieder mehrere Metadaten haben) nicht indiziert.

Dieses Pattern bezieht sich auf den „Type“ des Metadatums, z.B. SP.FieldUrlValue für Link Felder oder SP.Taxonomy.TaxonomyFieldValue für verwaltete Metadaten.

“Included Content Types (regex)”
(Advanced Settings)

Regular Expression, mit der Content Types (z.B. File, Folder) via Namen des Content Types inkludiert werden. Wenn nichts angegeben ist, werden alle Content Types inkludiert. Der Content Type von Objekten steht im contenttype Metadatum.

“Excluded Content Types (regex)”
(Advanced Settings)

Regular Expression, mit der Content Types (z.B. File, Folder) via Namen des Content Types ausgeschlossen werden. Wenn nichts angegeben ist, werden alle Content Types inkludiert. Der Content Type von Objekten steht im contenttype Metadatum.

“[Deprecated] Use delta key format”
(Advanced Settings)

Diese Option ist deprecated und sollte immer aktiviert bleiben, damit die volle Funktionalität des Crawlers verwendet werden kann.

Wenn gesetzt, wird ein anderes Format für die Keys verwendet. Gewisse Funktionalitäten des Delta Crawlens (z.B. Umbenennen von Listen, Löschen von Attachment Files) funktionieren ohne diese Option nicht. Wenn diese Option geändert wird, sollte der Index neu indiziert werden.

“Enable Delta Crawl”

Wenn gesetzt, werden von der Sharepoint Online API nur Änderungen an Files abgeholt anstatt über die ganze Sharepoint Online Instanz zu crawlen. Für volle Funktionalität sollte „Use delta key format“ gesetzt werden.

“Skip Delta Errors”
(Advanced Settings)

Wenn gesetzt, werden Fehler beim Delta Crawl übersprungen. Ansonsten wird das Dokument, bei dem der Fehler aufgetreten ist, beim nächsten Crawlrun nochmal indiziert.

Achtung: Wenn diese Option aktiviert wird, kann es zu Unterschieden zwischen dem Mindbreeze Index und Microsoft SharePoint Online kommen. Aktivieren Sie diese Option nur temporär, falls beim Delta Crawlen persistente Fehler auftreten, die sich nach mehreren Crawlruns nicht beheben.

“Index Sites As Document”

Wenn gesetzt, werden alle SharePoint Online Sites auch selbst als Mindbreeze Dokument indiziert. Der Content dieser Dokumente ist die Welcome Page der Site.

Wenn diese Option deaktiviert wird, ist ein vollständiger Re-Index notwendig.

“Crawl hidden lists”

Wenn gesetzt, werden auch Listen, die als versteckt definiert sind, indiziert

“Crawl lists with property 'NoCrawl'”

Wenn gesetzt, werden auch jene Listen indiziert, die in Microsoft SharePoint Online die Eigenschaft „NoCrawl“ besitzen.

“Max Change Count Per Site”
(Advanced Settings)

Anzahl an Änderungen die beim Delta Crawl pro Seite abgearbeitet werden, bevor die nächste Seite bearbeitet wird. Die übrig gebliebenen Änderungen werden beim nächsten Crawlrun bearbeitet.

“Trust all SSL Certificates”
(Advanced Settings)

Erlaubt die Verwendung von nicht gesicherten Verbindungen, beispielsweise für Testsysteme.  Darf nicht in Produktion aktiviert werden.

„Parallel Request Count”

Maximale Anzahl an HTTP Requests die parallel vom Crawler gesendet werden.

„Page Size“

Maximale Anzahl an Objekten die pro Request an die API erhalten werden.

Ein hoher Wert führt sorgt für höhere Geschwindigkeit, aber auch zu größerem Speicherverbrauch während dem Crawlrun, ein kleiner Wert sorgt für weniger Speicherverbrauch, dafür verringert sich aber die Geschwindigkeit.

Wird der Wert auf 0 gesetzt, wird kein Paging verwendet, also der Crawler versucht mit Request alle Objekte auf einmal abzuholen.

„Max Content Length (MB)”

Begrenzt die maximale Dokumentgröße. Ist ein Dokument größer als dieses Limit, wird der Inhalt des Dokuments nicht heruntergeladen (die Metadaten bleiben erhalten). Der Standardwert ist 50 Megabytes.

„[Deprecated] Send User Agent“
(Advanced Settings)

Diese Option ist deprecated und sollte immer aktiviert bleiben. Der User Agent Header sollte immer mitgesendet werden. Passen Sie stattdessen die „User Agent“ Option an.

Wenn aktiv, wird der mit der Option „User Agent“ konfigurierte Header bei jedem HTTP-Request mitgesendet

„User Agent“
(Advanced Settings)

Der angegebene Wert wird im User-Agent Header bei HTTP-Request mitgesendet, wenn die Option „Send User Agent“ aktiv ist.

„Thumbnail Generation for Web Content“
(Advanced Setting)

Wenn gesetzt, werden Thumbnails für Webdokumente generiert. Es ist nicht empfohlen dieses Feature zu aktivieren, da es nur für öffentliche Seiten mit anonymem Zugriff funktioniert, welche bereits eingestellt wurden.

“Dump Change Responses”
(Advanced Setting)

Wenn gesetzt, werden die Antworten der Sharepoint API beim Deltacrawlen in ein Logfile geschrieben.

“Log All HTTP Requests”
(Advanced Setting)

Wenn gesetzt, werden alle HTTP-Requests, die im Laufe des Crawlruns vom Crawler versendet werden, in ein .csv-File geschrieben (sp-request-log.csv).

“Update Crawler State During Crawlrun”
(Advanced Setting)

Wenn gesetzt, wird der Crawlerstate während dem Crawlrun laufend geupdated (anstatt nur zu Beginn des Crawlruns), wodurch mehrfache Downloads desselben Files in gewissen Situationen verhindert werden können.

Diese Option ist nur bei Delta Crawls aktiv.

“Recrawl CSV File Path“
(Advanced Setting)

Wenn gesetzt, wird die angegebene Datei überwacht und bei Änderungen während des Crawlruns kann eine Reindizierung von gewissen Seiten, Listen oder Items/Dateien ausgelöst werden.

Die CSV Datei muss die folgende Kopfzeile haben:
siteRelativeUrl;list;item;forceReindex

Jede Zeile kann folgende Werte haben:

• Site Relative URL: Die relative URL der Seite, die indiziert werden soll
• List: Der Name oder die Id der Liste, die indiziert werden soll
• Item: Der Name oder die Id des Items, Files oder Folders der indiziert werden soll
• Force Reindex: Kann entweder true oder false sein. Wenn es auf true gesetzt wird, werden die angegebenen Dokumente immer indiziert, unabhängig vom Änderungsdatum oder anderen Daten

Nur die Site Relative URL wird benötigt, die restlichen Werte sind optional.

Beispielzeilen:

/sites/Marketing;Documents;Schedule.docx;true: Die Datei “Schedule.docx” in der Liste „Documents“ in der Seite „/sites/Marketing“ wird neu indiziert.

/sites/Marketing;SalesData;;: Die Liste “SalesData” in der Seite “/sites/Marketing” und alle ihre Items werden neu indiziert, falls sie noch nicht indiziert wurden oder sich ihr Änderungsdatum oder Berechtigungsinformation von der derzeit indizierten Version unterscheiden.

Nachdem die CSV Datei verarbeitet wurde, wird sie auf <Dateiname>.old umbenannt. Dann kann eine neue Datei mit neuen zu indizierenden Objekten angelegt werden.

Aus Performancegründen wird empfohlen, die CSV Datei in einen eigenen Ordner zu legen, ohne andere Dateien die oft editiert werden.

Hierfür benötigt der mes Benutzer zumindest Read, Write und Execute Berechtigungen auf den Ordner und Read und Write Berechtigungen auf die Datei.

Custom Delta CSV Path
(Advanced Setting)

Mit dieser Option kann ein Pfad zu einem .csv-File angegeben werden, mit dem eigene Deltapunkte angegeben werden können. Jede Zeile muss zwei mit Strichpunkten getrennte Einträge enthalten: Zuerst die Site Relative URL und dann ein Zeitpunkt im Format yyyy-MM-ddTHH:mm:ssZ.
Beispiel: /sites/MySite; 2019-10-02T10:00:00Z

Dieser State wird nicht übernommen, wenn bereits ein State vorhanden ist. Soll der alte State überschrieben werden, muss dieser aus dem DeltaState File gelöscht werden.

Update all ACLs
(Advanced Setting)

Wenn gesetzt, aktualisiert der Crawler alle ACLs von SharePoint Online Objekten. Diese Option sollte nur für Delta Crawlruns nach einem Plugin-Update verwendet werden, bei dem die Behandlung von ACLs verbessert wurde.

Diese Option sollte nach einem Crawlrun wieder abgeschaltet werden, da sie eventuell viel Zeit in Anspruch nimmt.

Check for Role Update within past Days
(Advanced Setting)

Mit dieser Einstellung prüft der Crawler auf Role Updates aller Sites in den letzten konfigurierten Tagen und verarbeitet diese.

Aufgrund von Limitationen der SharePoint Online getChanges API, ist der maximale Wert 59 Tage.

Dry Run Role Update Check
(Advanced Setting)

Wenn diese Option gesetzt ist, wird die Prüfung auf Role Updates seit dem oben konfigurierten Datum nur in einer Datei role-update.csv geloggt, anstatt vollständig verarbeitet zu werden.

„Ignore Sharepoint ACLs“ (Advanced Setting)

Wenn gesetzt, werden keine Zugriffsrechte zu Listen oder Dokumenten von Sharepoint geholt. Diese Option kann nur gesetzt werden, wenn mindestens eine Site ACL konfiguriert ist.

“Site ACL”

Mit dieser Option können eigene ACLs gesetzt werden. Das Site URL Pattern ist eine Regular Expression, für welche Seiten dieses Principal konfiguriert werden soll, mit Access Check Action kann ausgewählt werden, ob es sich um ein Grant oder Deny handelt und mit Principal wird die Gruppe/der User angegeben, für den das Principal gelten soll (z.B. everyone oder max.mustermann@mycompany.onmicrosoft.com).

China

https://login.partner.microsoftonline.cn

US Government

https://login.microsoftonline.us

„Use App-Only authentication“

Wenn diese Option ausgewählt wird, wird die App-Only-Authentisierung anstatt der User Based Authentisierung verwendet. Wenn diese Option auswählt wird, müssen außerdem „Client ID“ und „Client secret“ konfiguriert werden. Zusätzlich müssen alle untenstehenden Schritte „App-Registrierung in Sharepoint“ durchgeführt werden.

„App Credential“

Das Credential, welches im „Network“-Tab erstellt wurde und die, wie nachfolgend beschrieben, generierte Client ID und das Secret enthält.

„[Veraltet] Client ID“
(Advanced Settings)

Diese Option ist veraltet und sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die Einstellung „App Credential“.

Die Client ID, die, wie nachfolgend beschrieben, generiert wird.

„[Veraltet] Client secret“
(Advanced Settings)

Diese Option ist veraltet und sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die Einstellung „App Credential“.

Das Client Secret, das wie nachfolgend beschrieben, generiert wird.

“Do Not Request File Author Metadata”

Wenn aktiv, werden keine Metadaten für die Autoren von Listen, Items oder Files angefordert. Dies kann eine mögliche Abhilfe für den Sharepoint-Fehler „HTTP 500: User cannot be found" sein.

“Get Author From File Properties”

Wenn aktiv, werden die Autor Metadaten aus dem File/Properties Objekt abgeholt, anstatt von dem File/Author Objekt. Dadurch können Errors beim Crawlrun verhindert werden, wenn zum Beispiel der User inzwischen gelöscht wurde.

Damit diese Option korrekt angewendet werden kann, ist ein vollständiger Re-Index notwendig.

“List All Content Types“

Wenn aktiv, wird am Beginn eines Crawlruns eine all-content-types.csv Datei im Log-Verzeichnis erstellt, welche alle Content Types aller Listen von allen konfigurierten Seiten enthält.

“Analyse Completeness“

Wenn aktiviert, wird während des Crawlruns eine listenbasierte Vollständigkeitsanalyse des Indexes durchgeführt, die in die eine Datei CompletenessAnalysis.csv im Log Verzeichnis geschrieben wird.

Hinweis: Die Completeness Analyse überprüft nicht alle Sites in SharePoint Online, sondern nur jene die zur Indizierung konfiguriert sind.
Anhänge werden bei der Statistik nicht berücksichtigt.

“Include Unpublished Documents”

Wenn aktiv, werden alle Dokumente/Items immer in der aktuellsten Version indiziert, egal ob sie bereits gepublished wurden. Wird diese Option ausgeschaltet, werden nur published Sites und nur Major Versions(1.0, 2.0 etc., wird bei der Versionierung normalerweise mit jedem publish erstellt) indiziert.

“ASPX Content Metadata”

Mit dieser Option können eigene Metadaten als Content für .aspx Files gesetzt werden. Standardmäßig werden „WikiField“ und „CanvasContent1“ verwendet. Falls bei dieser Option Metadaten gesetzt sind, werden zuerst diese verwendet, falls sie vorhanden sind.

Damit diese Option korrekt angewendet werden kann, ist ein vollständiger Re-Index notwendig.

“Download OneNote Files as HTML via Graph API”
(Advanced Settings)

Wenn aktiviert, werden alle OneNote Dokumente (.one Dateien) über die Microsoft Graph API als HTML-Dokumente heruntergeladen. Dies ermöglichte eine genauere Interpretation der Dokumentinhalte. Die Dokumente werden weiterhin als .one Dateien angezeigt.

Hinweis: Um diese Funktion zu verwenden, müssen folgende Punkte berücksichtigt werden:

• Die zugehörigen Graph API Credentials müssen hier korrekt gesetzt werden.
• Die verbundene Graph Application benötigt die Berechtigungen Notes.Read.All und Sites.Read.All.
• Nach vollständiger Konfiguration dieser Option ist ein Re-Index notwendig.

“Graph Service Root”

Der Endpunkt/die URL der Microsoft Graph API. Standardmäßig „https://graph.microsoft.com“. Diese Einstellung nur ändern, wenn Sie eine nationale (nicht internationale) Microsoft Cloud verwenden. Eine Liste mit allen verfügbaren nationalen Cloud Endpunkten finden Sie weiter unten.

“Graph Tenant ID“

Die Tenant ID Ihrer Microsoft 365 Instanz. Diese können Sie auf der Overview Seite der erstellen App in Azure entnehmen.

“Graph App ID”

Die Application (Client) ID der in Azure erstellten App.

„Graph Client Secret“

Das im Network Tab angelegte Credential, welches das erstelle Client Secret enthält.

Globaler Service

https://graph.microsoft.com

China

https://microsoftgraph.chinacloudapi.cn

US Government L4

https://graph.microsoft.us

US Government L5 (DOD)

https://dod-graph.microsoft.us

„Server URL“

Die URL der Sharepoint Online Instanz, z.B.: https://mycompany.sharepoint.com

Sollte genauso wie im Crawler konfiguriert werden.

„Admin Server URL“

Die Admin URL der Sharepoint Online Instanz. Meistens ist es die Server URL mit einem -admin, z.B. https://mycompany-admin.sharepoint.com

Sollte genauso wie im Crawler konfiguriert werden.

„Regex for your organization“

Regulärer Ausdruck, der definiert, ob ein Benutzer der Organisation angehört oder nicht. Damit wird das Principal „everyone_except_external“ aufgelöst.

Achtung: Dies ist eine sicherheitsrelevante Einstellung!

Der reguläre Ausdruck kann sich dabei auf die E-Mail-Adresse, die ObjectSID oder die ObjectGUID aus LDAP beziehen.

Der Standardwert enthält keine Benutzer.

„Site Relative URL“

Die relativen Pfade zu den Sites, die gecrawlt werden sollen, beginnend mit einem Schrägstrich, z.B.: /sites/mysite. Jede Zeile beinhaltet einen Pfad.

Wenn dieses Feld leergelassen wird, werden automatisch alle Sites im Sharepoint Online gefunden und indiziert. Wenn Sites angegeben werden, werden nur die Subsites der angegebenen Sites gefunden.

Sollte genauso wie im Crawler konfiguriert werden.

„Site Discovery Schedule“

Eine Extended Cron Expression, die angibt wann die Site Discovery ausgeführt werden soll. Die Ergebnisse werden dann bei den nächsten Crawlruns verwendet. Dadurch muss die eventuell aufwändige Site Discovery nicht bei jedem Crawlrun wiederholt werden.

Eine Dokumentation und Beispiele zu Cron Expressions finden Sie hier.

“Background Site Discovery Parallel Request Count”
(Advanced Settings)

Maximale Anzahl an HTTP Requests die parallel von der Site Discovery gesendet werden.

“Site Discovery Strategy”
(Advanced Settings)

Die Methode, mit der die Site Discovery durchgeführt werden soll.

• Auto: Es wird anhand der Authentisierungsmethode automatisch entschieden, welche Methode verwendet werden soll.
• Admin API: Es wird die SharePoint Admin API für die Site Discovery verwendet. Dadurch werden ALLE Seiten der SharePoint Online Instanz gefunden. Hierfür muss entweder App-Only Authentication oder User-Based Authentication mit einem Admin User verwendet werden.
• Search: Es wird die SharePoint Online Suche für die Site Discovery verwendet. Dadurch können automatisch nur Seiten gefunden werden, auf die der Crawl User Zugriff hat.
• Für User Based Authentication ohne Admin User, kann nur diese Methode verwendet werden.

“Ignore Site Discovery Errors”
(Advanced Settings)

Wenn diese Option aktiviert ist, werden sämtliche Fehler bei der Site Discovery nur geloggt und ansonsten ignoriert.

Diese Option können Sie verwenden, wenn Sie eine große und sich stetig ändernde Anzahl an Sites haben, und dabei unerwartete Fehler auftreten.

“Do Not Crawl Root Site”

Wenn diese Option aktiviert ist, wird die Rootseite der Sharepoint Online Instanz (also z.B. mycompany.sharepoint.com) und deren Subseiten nicht gecrawlt.

Sollte genauso wie im Crawler konfiguriert werden.

„Included Sites URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Subsites gecrawlt werden sollen. Wenn diese Option leer gelassen wird, werden alle Subsites gecrawlt. Die Regex matched auf relative URLs. z.B. /sites/mysite

Sollte genauso wie im Crawler konfiguriert werden.

„Excluded Sites URL (regex)“

Regular Expression, mit der angegeben werden kann, welche Subsites exkludiert werden sollen. Die Regex matched auf relative URLs. z.B. /sites/mysite

Sollte genauso wie im Crawler konfiguriert werden.

„Enable Delta Update“

Wenn aktiviert, werden nach der ersten Cache-Erstellung nur die Änderungen an den Gruppen von Sharepoint Online abgeholt, anstatt jedes Mal alle Gruppen abzuholen. Dies ist vor allem bei sehr großen Sharepoint Instanzen empfohlen, da ein reguläres Cacheupdate ansonsten sehr lange dauern kann.

Delta Updating mit User Based Authentisierung wird nicht unterstützt – falls Delta Updating benötigt wird, muss App Only Authentisierung verwendet werden.

„Skip Cache Empty Check“
(Advanced Settings)

Wenn diese Option aktiviert wird, wird die Überprüfung, ob der Cache leer ist, um in diesem Fall ein vollständiges Update zu machen, übersprungen.

Achtung: Diese Option darf nur aktiviert werden, wenn der Cache schon einmal vollständig und erfolgreich aufgebaut wurde. Löschen Sie daher das Cache-Verzeichnis auf keinen Fall manuell, wenn sie diese Option aktiviert haben! Der Cache wird in diesem Fall nicht vollständig neu aufgebaut!

Diese Option sollte nur aktiviert werden, wenn es Performance Probleme mit sehr großen Caches gibt.

„[Deprecated] Send User Agent“
(Advanced Settings)

Diese Option ist deprecated und sollte immer aktiviert bleiben. Der User Agent Header sollte immer mitgesendet werden. Passen Sie stattdessen die „User Agent“ Option an.

Wenn aktiv, wird der mit der Option „User Agent“ konfigurierte Header bei jedem HTTP-Request mitgesendet

„User Agent“
(Advanced Settings)

Der angegebene Wert wird im User-Agent Header bei HTTP-Request mitgesendet.

„Dump Change Responses“

Wenn aktiviert werden die Changes, die wir von Sharepoint Online beim Delta Update erhalten, in ein File gedumpt. Dies ist zur Fehlersuche sehr hilfreich.

“Log All HTTP Requests”
(Advanced Setting)

Wenn gesetzt, werden alle HTTP-Requests, die im Laufe des Cache Updates vom Principal Resolution Service versendet werden, in ein .csv-File geschrieben (sp-request-log.csv).

„Parallel Request Count“

Mit dieser Option kann definiert werden, wie viele HTTP-Requests vom Crawler gleichzeitig abgeschickt werden. Umso höher der Wert, umso schneller sollte der Crawlrun sein, allerdings kann ein zu hoher Wert auch zu vielen „Too Many Requests“ Errors auf Seiten von Sharepoint führen. Ein Wert über 30 ist nicht empfohlen.

„Page Size“

Maximale Anzahl an Objekten die pro Request an die API erhalten werden.

Ein hoher Wert führt sorgt für höhere Geschwindigkeit, aber auch zu größerem Speicherverbrauch während dem Cache Update, ein kleiner Wert sorgt für weniger Speicherverbrauch, dafür verringert sich aber die Geschwindigkeit.

Wird der Wert auf 0 gesetzt, wird kein Paging verwendet, also der Crawler versucht mit Request alle Objekte auf einmal abzuholen.

“Trust all SSL Certificates”

Erlaubt die Verwendung von nicht gesicherten Verbindungen, beispielsweise für Testsysteme.  Darf nicht im Produktions-Betrieb aktiviert werden.

“Heap Dump On Out Of Memory”
(Advanced Settings)

Wenn diese Option aktiviert ist, macht der Principal Service einen Heap Dump falls er Out Of Memory läuft

China

https://login.partner.microsoftonline.cn

US Government

https://login.microsoftonline.us

Globaler Service

graph.microsoft.com

China

graph.chinacloudapi.cn

US Government L4

graph.microsoftazure.us

US Government L5 (DOD)

graph.microsoftazure.us

Deutschland

graph.cloudapi.de

China

https://login.partner.microsoftonline.cn

US Government

https://login.microsoftonline.us

„Tenant Context ID“

Der Tenantname der Microsoft Instanz, z.B. mycompany.onmicrosoft.com

„Application ID“

Die Application ID der im Azure Portal erstellten App

„Generated Key“

Das Secret der im Azure Portal erstellten App

„Protected Resource Hostname“

Falls Sie kein spezifisches nationales Cloud Deployment verwenden, ist der Protected Resource Hostname graph.windows.net

Falls Sie ein nationales Cloud Deployment verwenden, entnehmen Sie den Resource Hostname aus der untenstehenden Tabelle.

„Graph Page Size“

Die Anzahl an Graph Gruppen die pro Request and die Graph API abgeholt werden.

“Log All HTTP Requests”
(Advanced Setting)

Wenn gesetzt, werden alle HTTP-Requests, die im Laufe des Updates vom Cache versendet werden, in ein .csv-File geschrieben (sp-request-log.csv).

„User Agent“
(Advanced Settings)

Der angegebene Wert wird im User-Agent Header bei HTTP-Request mitgesende.

“Heap Dump On Out Of Memory”
(Advanced Settings)

Wenn diese Option aktiviert ist, macht der Principal Service einen Heap Dump falls er Out Of Memory läuft

Globaler Service

graph.microsoft.com

Deutschland

graph.microsoft.de

China

microsoftgraph.chinacloudapi.cn

US Government

graph.azure.us

„Server URL“

Die URL der Sharepoint Online Instanz, z.B.: https://mycompany.sharepoint.com

Sollte genauso wie im Crawler konfiguriert werden.

„SharePoint Online Email Regex“

Regexpattern für Email Adressen die in SharePoint Online verwendet werden.

Über dieses Pattern wird entschieden, welches Principal verwendet wird, um die Rechte in SharePoint Online zu überprüfen.

„Parallel Request Count“

Mit dieser Option kann definiert werden, wie viele HTTP-Requests vom Authorization Service gleichzeitig abgeschickt werden. Umso höher der Wert, umso schneller sollte der Authorizer sein, allerdings kann ein zu hoher Wert auch zu vielen „Too Many Requests“ Errors auf Seiten von Sharepoint führen. Ein Wert über 30 ist nicht empfohlen.

„[Deprecated] Send User Agent“
(Advanced Settings)

Diese Option ist deprecated und sollte immer aktiviert bleiben. Der User Agent Header sollte immer mitgesendet werden. Passen Sie stattdessen die „User Agent“ Option an.

Wenn aktiv, wird der mit der Option „User Agent“ konfigurierte Header bei jedem HTTP-Request mitgesendet

„User Agent“
(Advanced Settings)

Der angegebene Wert wird im User-Agent Header bei HTTP-Request mitgesendet, wenn die Option „Send User Agent“ aktiv ist.

China

https://login.partner.microsoftonline.cn

US Government

https://login.microsoftonline.us

„App Credential“

Das Credential, welches im „Network“-Tab erstellt wurde und die, wie nachfolgend beschrieben, generierte Client ID und das Secret enthält.

„[Veraltet] Client ID“
(Advanced Settings)

Diese Option ist veraltet und sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die Einstellung „App Credential“.

Die Client ID, die, wie nachfolgend beschrieben, generiert wird.

„[Veraltet] Client secret“
(Advanced Settings)

Diese Option ist veraltet und sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die Einstellung „App Credential“.

Das Client Secret, das wie nachfolgend beschrieben, generiert wird.

Endpoint

HTTP-Method

Beschreibung

<Azure Endpoint>/GetUserRealm.srf

POST

Falls der User ein ADFS User ist, wird mit diesem Endpoint der Authentisierungsserver abgeholt.

<ADFS Authorisierungsserver>

POST

Gegen den Server, der mit dem GetUserRealm Call abgeholt wurde, wird ein Loginrequest gemacht.

<Azure Endpoint>/rst2.srf

POST

Es wird ein Login-Token mit den eingetragenen Username/Password Credentials abgeholt.

<ServerURL>/_vti_bin/idcrl.svc/

<AdminServerURL>/_vti_bin/idcrl.svc/

GET

Mit dem zuvor abgeholten Token werden Logincookies abgeholt. Die Cookies der Admin-URL werden für die SiteDiscovery benötigt.

<AdminServerURL>/_vti_bin/sites.asmx

POST

Mit den zuvor abgeholten Cookies, wird noch ein Digest-Hash abgeholt, welcher für die SiteDiscovery benötigt wird.

<ServerURL>/_vti_bin/client.svc

<AdminServerURL>/_vti_bin/client.svc

GET

Dieser Endpoint wird verwendet, um Informationen über den Tenant zu bekommen, z.B. die TenantId.

<Azure Endpoint>/<Tenant Id>/tokens/OAuth/2

POST

Mit diesem Endpoint wird ein Access Token für die AppOnly Authorization erzeugt.

<AdminServerURL>/_api/ProcessQuery

POST

Mit diesem Endpoint werden alle Sites der Sharepoint Online Instanz gefunden, wenn AppOnly Authentisierung verwendet wird und die Site Discovery Strategy auf Auto gesetzt ist oder wenn die Site Discovery Strategy auf Admin API gesetzt ist.

<ServerURL>/_api/search/query

GET

Mit diesem Endpoint werden alle Sites der Sharepoint Online Instanz gefunden auf die der User Zugriff hat, wenn User Based Authentisierung verwendet wird und die Site Discovery Strategy auf Auto gesetzt ist oder wenn die Site Discovery Strategy auf Search gesetzt ist.

<ServerURL><SiteRelativeUrl>/_api/web/siteusers

GET

Mit diesem Endpoint werden alle Benutzer abgeholt, um herauszufinden welche Site Collection Administrators sind.

<ServerURL><SiteRelativeUrl>/_api/Web/getChanges

POST

Mit diesem Endpoint werden beim Delta Crawl alle Changes einer Seite abgeholt.

<ServerURL><SiteRelativeUrl>/_api/Site/getChanges

POST

Mit diesem Endpoint werden beim Delta Update alle Group Membership Changes einer Site abgeholt.

<ServerURL><SiteRelativeUrl>/_api/Web/webs

GET

Mit diesem Endpoint werden die direkten Subseiten von Seiten abgeholt.

<ServerURL><SiteRelativeUrl>/_api/Web/RegionalSettings/TimeZone

GET

Mit diesem Endpoint wird die eingestellte Zeitzone der Seite abgeholt.

<ServerURL><SiteRelativeUrl>/_api/Web

GET

Mit diesem Endpoint werden die Metadaten einer Site abgeholt.

<ServerURL><SiteRelativeUrl>/_api/web/lists

GET

Mit diesem Endpoint werden alle Listen einer Seite und einige zusätzliche Metadaten abgeholt, unter anderem auch das „RoleAssignments“ Feld, für welches die „Enumerate Permissions“ Rechte benötigt werden.

<ServerURL><SiteRelativeUrl>/_api/web/lists(guid’<ListId>’)

GET

Mit diesem Endpoint wird eine einzelne Liste abgeholt.

<ServerURL><SiteRelativeUrl>/_api/web/lists(guid’<ListId>’)/Items

GET

Mit diesem Endpoint werden alle Items einer Liste und einige zusätzliche Metadaten abgeholt, unter anderem auch das „RoleAssignments“ Feld, für welches die „Enumerate Permissions“ Rechte benötigt.

<ServerURL><SiteRelativeUrl>/_api/web/lists(guid’<ListId>’)/Items(<ItemId>)

GET

Mit diesem Endpoint wird ein einzelnes Item abgeholt.

<ServerURL><SiteRelativeUrl>/_api/web/GetFileByServerRelativeUrl(‘<FileRelativeUrl’)

<ServerURL><SiteRelativeUrl>/_api/web/GetFileById (‘<FileId>’)

<ServerURL><SiteRelativeUrl>/_api/web/GetFileById (‘<FileId>’)/ListItemAllFields

<ServerURL><SiteRelativeUrl>/_api/web/GetFileById (‘<FileId>’)/ListItemAllFields/Versions(<VersionId>)

GET

Mit diesen Endpoints werden die Metadaten eines Files abgeholt.

<Direkter Link auf eine Datei>/$value

GET

Mit diesem Endpoint wird der Inhalt einer Datei heruntergeladen.

<ServerURL><SiteRelativeUrl>/_api/Site

GET

Mit diesem Endpoint werden die Metadaten der Site Collection abgeholt.

<ServerURL><SiteRelativeUrl>/_api/Web/GetUserById(<Id>)

GET

Mit diesem Endpoint werden die Metadaten eines Users abgeholt.

<ServerURL><SiteRelativeUrl>/_api/web/sitegroups

<ServerURL><SiteRelativeUrl>/_api/web/sitegroups(<GroupId>)/users

GET

Mit diesem Endpoint werden alle Gruppen einer Seite und alle Benutzer in diesen Gruppen abgeholt. Für diesen Endpoint werden „Enumerate Permissions“ Rechte benötigt.