Start/notes.ini Parameter/FT_USE_ATTACHMENT_WHITE_LIST

FT_USE_ATTACHMENT_WHITE_LIST

Parameter: FT_USE_ATTACHMENT_WHITE_LIST
Kurzbeschreibung: Aktiviert die Default-Whitelist beim FT-Indexieren von Anhängen; nur Endungen auf der Whitelist werden über den Tika-Filter indiziert.

Steckbrief

Parameter
FT_USE_ATTACHMENT_WHITE_LIST
Kategorie
Performance / Memory
Komponente
Server, Client
Verfügbar seit
9.0.1
Unterstützte Versionen
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Konfigurations-Dokument (NOTES.INI-Tab) bzw. Desktop Settings Policy → Custom Settings → notes.ini
Mögliche Werte
0 = nur Default-Ignore-Liste greift (Default), 1 = Default-Whitelist aktiv (zusätzlich erweiterbar via FT_INDEX_FILTER_ATTACHMENT_TYPES)

Beschreibung

FT_USE_ATTACHMENT_WHITE_LIST=1 aktiviert die Default-Whitelist des FT-Indexers. Diese Liste enthält die Datei-Endungen, die HCL Domino fest einprogrammiert als „sicher und nutzbringend zu indexieren" markiert hat (alle von Tika unterstützten Formate abzüglich der Default-Ignore-Liste wie *.exe, *.dll, *.zip, *.png, *.jpg etc.).
Im Gegensatz zu
FT_USE_MY_ATTACHMENT_WHITE_LIST wird die Default-Liste nicht verworfen, sondern als Basis genutzt. Über
FT_INDEX_FILTER_ATTACHMENT_TYPES kann sie um eigene Endungen ergänzt werden („Extending the white list").
Wirkungsweise: Mit aktivierter Whitelist wird ein Anhang nur dann vom Tika-Konversionsfilter erfasst, wenn seine Endung explizit auf der Whitelist steht. Das ist die strikteste Form der Steuerung — kollidieren Ignore-Liste und Whitelist, hat die Whitelist Vorrang.

Beispiel-Konfiguration

FT_USE_ATTACHMENT_WHITE_LIST=1
FT_INDEX_FILTER_ATTACHMENT_TYPES=*.csv,*.json,*.log
Laufzeit-Variante (Server-Konsole):
set config FT_USE_ATTACHMENT_WHITE_LIST=1

Hinweise & Stolperfallen

  • Whitelist greift gegenüber Ignore-Liste — bei Kollision (eine Endung steht auf beiden Listen) wird indiziert, nicht ignoriert.
  • Wirkt nur in Verbindung mit dem Apache-Tika-Konversionsfilter; bei „brute force text-stripping" greift die Whitelist nicht.
  • Änderung greift erst nach Rebuild des FT-Index (load updall -f).
  • Deployment auf vielen Servern am einfachsten via Konfigurations-Dokument → NOTES.INI-Tab, auf Notes-Clients via Desktop-Settings-Policy.

Quellen (HCL Product Documentation)