Instance URL*

Die URL zur ServiceNow Instanz, z.B. https://mycompany.service-now.com/

Token URL*

Die URL zum Token Endpoint, z.B. https://mycompany.service-now.com/oauth_token.do

Grant Type*

Der Grant Type zum Abholen des OAuth2 Tokens (normalerweise „password“)

Client Id*

Die Client ID der in ServiceNow konfigurierten OAuth2 Application

Client Secret*

Das Client Secret der in ServiceNow konfigurierten OAuth2 Application

Username*

Der Username des Crawler Users

Password*

Das Passwort des Crawler Users

Page Size

Die Page Size der REST API Bulk Requests (default 1000)

Index <<TABLE_NAME>>

Wenn aktiv, wird die Tabelle indiziert (z.B. wenn „Index Knowledge Articles“ aktiv ist, werden Knowledge Articles gecrawlt)

Constraint Query for <<TABLE_NAME>>

Eine Constraint Query, um einzuschränken, welche Records einer Tabelle indiziert werden (mittles ServiceNow Filter, siehe Appendix: Constraint Queries)

Generic Tables

Wenn andere Tabellen außer Knowledge Articles, Catalog Items, Incidents oder Problems indiziert werden sollen, kann dies hier konfiguriert werden:

Use Access Control Lists

Rollen von ServiceNow ACLs werden auf Mindbreeze Dokumente gesetzt. Dabei werden nur ACLs auf Tabellen-Ebene (kein Support auf Spalten-Ebene) berücksichtigt. Außerdem werden die Felder „Condition“ und „Script“ in den ServiceNow ACLs nicht berücksichtigt.

Verwenden Sie diese Option, wenn Sie im Principal Resolution Service die Option „Resolve ACLs“ verwenden.

Use User Criteria

ServiceNow User Criteria werden als Mindbreeze ACLs auf Knowledge Articles und Catalog Items gesetzt. Das Feld “Script” wird dabei nicht unterstützt.

Verwenden Sie diese Option, wenn Sie im Principal Resolution Service die Option „Resolve User Criteria“ verwenden.

Extended User Criteria Conditions

Extended User Criteria Conditions, welche im ServiceNow Caching Principal Resolution Service aufgelöst werden.

Wenn es in ServiceNow Extended User Criteria Conditions gibt, die hier nicht angegeben sind, können Dokumente die diese Conditions verwenden, nicht gefunden werden. Da in diesem Fall mehr Requests gegen die ServiceNow API gemacht werden müssen, kann sich dies auch negativ auf die Crawl Geschwindigkeit auswirken.

Wichtig: Konfigurieren Sie diese Option identisch zu der Option im ServiceNow Caching Principal Resolution Service. Ansonsten kann die Zugriffsstruktur nicht korrekt abgebildet werden.

KB Article Principals Size Optimization

Reduziert die Anzahl der Principal Containers, wenn User Criteria verwendet werden. Diese Option ist standardmäßig aktiv und sollte normalerweise nicht deaktiviert werden. Wenn Sie jedoch trotzdem deaktiviert werden soll, dann muss sie auch im CachingServiceNowPrincipalResolutionService deaktiviert werden, damit die Berechtigungen korrekt funktionieren.

Dynamic Constraint Source Expr

category:Undefined

Dynamic Constraint Pattern

NOT aclReference:true

Dynamic Constraint Static Fraction

NOT aclReference:true

Log Objects to CSV (advanced setting)

Wenn aktiv, werden prozessierte Objekte mitprotokolliert

Log Level (advanced setting)

3 Levels:

• INFO: Auch erfolgreich prozessierte Objekte mitprotokolliert.
• WARNING, ERROR: nicht erfolgreich prozessierte Objekte (nicht unterstütze User Criteria, siehe oben) mitprotokolliert.

Diese Einstellung ist nur effektiv, wenn „Log Objects to CSV“ aktiv ist.

Dump User Criteria to CSV

Wenn aktiv, werden CSV Dump Files im aktuellen Log-Verzeichnis abgelegt:

• catalog-category-dump.csv
• catalog-item-dump.csv
• knowledge-article-dump.csv
• knowledge-base-dump.csv

Open URL Template*

Ein Template für die URL, die zum Öffnen eines Suchresultats verwendet wird. Die Platzhalter {{instnace_url}}, {{table}} und {{sys_id}} können dabei verwendet werden, z.B.:
{{instance_url}}/nav_to.do?uri=%2F/{{table}}.do?sys_id={{sys_id}}

Instance URL*

Die URL zur ServiceNow Instanz, z.B. https://mycompany.service-now.com/

Token URL*

Die URL zum Token Endpoint, z.B. https://mycompany.service-now.com/oauth_token.do

Grant Type*

Der Grant Type zum Abholen des OAuth2 Tokens (normalerweise „password“)

Client Id*

Die Client ID der in ServiceNow konfigurierten OAuth2 Application

Client Secret*

Das Client Secret der in ServiceNow konfigurierten OAuth2 Application

Username*

Der Username des Crawler Users

Password*

Das Passwort des Crawler Users

Page Size

Die Page Size der REST API Bulk Requests (default 1000)

Constraint Query for Users

Eine Constraint Query, um einzuschränken, welche User beim Updaten des Caches von ServiceNow abgeholt werden. (mittels ServiceNow Filter, siehe Appendix: Constraint Queries)

Mit dieser Option kann der Cache auf relevante User eingeschränkt werden.

Achtung: Dies ist eine Performance Option. Verwenden Sie diese Option z.B. zum exkludieren von inaktiven Usern oder Usern die die Mindbreeze Suche nicht verwenden.
Dies ist KEINE Berechtigungsoption.
Exkludierte User können unter Umständen dennoch Dokumente finden (wenn diese in ServiceNow berechtigt sind).

Resolve ACLs

Rollen von ServiceNow ACLs werden aufgelöst. Dabei werden nur ACLs auf Tabellen-Ebene (kein Support auf Spalten-Ebene) berücksichtigt. Außerdem werden die Felder „Condition“ und „Script“ in den ServiceNow ACLs nicht berücksichtigt.

Verwenden Sie diese Option, wenn Sie im Crawler die Option „Use Access Control Lists“ verwenden.

Resolve User Criteria

Users, Groups, Roles, Companies, Locations und Departments von User Criteria werden aufgelöst. Das Feld “Script” wird dabei nicht berücksichtigt.

Verwenden Sie diese Option, wenn Sie im Crawler die Option „Use User Criteria“ verwenden.

Extended User Criteria Conditions

Extended User Criteria Conditions, welche aufgelöst werden sollen.

Die Conditions können entweder mit dem internen Spaltennamen angegeben werden (z.B. „u_my_condition“) oder mit dem Anzeigenamen (z.b. „My Condition“).

Wichtig: Konfigurieren Sie diese Option identisch zu der Option im ServiceNow Crawler. Ansonsten kann die Zugriffsstruktur nicht korrekt abgebildet werden.

Resolve Knowledge Article User Criteria

Wenn diese Option aktiviert ist, werden die User Criteria für Knowledge Article aufgelöst. Für bessere Performance oder Berechtigungskontrolle können Sie diese Option deaktivieren, wenn Sie keine Knowledge Articles indizieren.

Constraint Query for Knowledge Articles

Eine Constraint Query, um einzuschränken, welche Knowledge Article User Criteria aufgelöst werden (mittles ServiceNow Filter, siehe Appendix: Constraint Queries)

Diese Option sollte identisch zum Crawler konfiguriert sein.

Resolve Catalog Item User Criteria

Wenn diese Option aktiviert ist, werden die User Criteria für Catalog Items aufgelöst. Für bessere Performance oder Berechtigungskontrolle können Sie diese Option deaktivieren, wenn Sie keine Catalog Items indizieren.

Constraint Query for Catalog Items

Eine Constraint Query, um einzuschränken, welche Category Item User Criteria aufgelöst werden (mittles ServiceNow Filter, siehe Appendix: Constraint Queries)

Diese Option sollte identisch zum Crawler konfiguriert sein.

Resolve HR Criteria

Aktivieren Sie diese Option, wenn Sie zusätzlich zu User Criteria auch HR Criteria verwenden. Diese Option hat keine Auswirkung, wenn Resolve User Criteria deaktiviert ist.

KB Article Principals Size Optimization
(Advanced Settings)

Reduziert die Anzahl der Principal Containers, wenn User Criteria verwendet werden. Diese Option ist standardmäßig aktiv und sollte normalerweise nicht deaktiviert werden. Wenn Sie jedoch trotzdem deaktiviert werden soll, dann muss sie auch im ServiceNow Crawler deaktiviert werden, damit die Berechtigungen korrekt funktionieren.

Resolve Empty User Criteria to All Users
(Advanced Settings)

Wenn diese Option aktiviert ist, werden alle leere User Criteria (User Criteria ohne gesetzte Kriterien) auf alle ServiceNow Benutzer aufgelöst. Das bildet das Verhalten in ServiceNow ab.

Sie können diese Option deaktivieren, wenn Sie keine leere User Criterias verwenden.

Advanced User Criteria Resolution
(Advanced Settings)

Siehe nächster Abschnitt.

UC Selection: Column Name

Die User Criteria Spalte / Feld in ServiceNow, auf die das „UC Selection: Column Pattern“ angewandt wird.

UC Selection: Column Pattern

Das Pattern, das auf die User Criteria Spalte / Feld („UC Selection: Column Name“) angewandt wird. Das Pattern ist eine Java Regex, bei der „.“ (Punkt) auch auf \n\r matcht (z.B. für Feld script relevant). Achten Sie darauf, dass ein vollständiger Match auf das Feld erfolgen muss, sodass die „Result Action“ für ein übereinstimmendes User Criteria durchgeführt wird.

Z.B. würde auf den Feldwert „My User Criteria“

• „My User“ nicht matchen, aber
• “My User.*” schon matchen

Resolution Action

Hier können Sie definieren, wie die User Criteria aufgelöst werden, für die „UC Selection: Column Name / Patter“ übereinstimmen.

Log Objects to CSV

Wenn aktiviert, werden Statistiken in der Datei "objects-log.csv" im aktuellen Log-Verzeichnis geschrieben.

Log All Objects

Wenn aktiviert, werden auch erfolgreich verarbeitete Objekte in die CSV-Datei geschrieben. Wirkt sich nur aus, wenn Log Objects to CSV aktiv ist.

Dump User Criteria to CSV

Wenn aktiv, werden alle User Critera in die CSV-Datei „user-criteria-dump.csv“ im aktuellen Log-Verzeichnis geschrieben.

Dump HR Criteria to CSV

Wenn aktiv, werden alle HR Critera in die CSV-Datei „hr-criteria-dump.csv“ im aktuellen Log-Verzeichnis geschrieben.