Über Suchindexe konfigurieren Sie, welche Daten aus Datentabellen für die Suche indexiert und an den Suchdienst übergeben werden. Der Suchdienst ist ein für die Daten-Indexierung und Suche optimierter serverseitiger Dienst.
Suchindexe werden für Datentabellen angelegt. Für eine Datentabelle kann es mehrere Suchindexe geben. Die Indexierung der Datensätze erfolgt automatisch durch einen Hintergrundprozess. Die Indexe werden aktualisiert bei Änderung der Datensätze oder in den Datensätzen verwendeter referenzierter Daten anderer Datensätze oder Konfigurationen (wie beispielsweise in Relation stehende Datensätze, Auswahllistenwerte, Übersetzungen). Bei Änderung eines Suchindexes werden ebenfalls alle Datensätze neu indexiert. Der Hintergrundprozess prüft periodisch nach durchzuführenden Aktualisierungen. Die Periode kann über einen Customer.Config-Parameter bestimmt werden. Der Default liegt bei einer Minute.
Informationen über die Suche befinden sich hier: Suche.
Eigenschaften des Suchindexes
| Eigenschaft | Beschreibung |
|---|---|
| Allgemeine Einstellungen | |
| Name | Vergeben Sie einen Namen für dieses Element. Der Name wird in der Anwendung nirgendwo angezeigt und nur in der Anwendungskonfiguration verwendet. |
| Vor Aktualisierung schützen | Dieses Element bei Importen nicht aktualisieren. |
| Titel | Geben Sie den Titel des Steuerelements so an, wie er in der Anwendung angezeigt wird. Achten Sie bei Bedarf auf Übersetzungen in alle Sprachen. Sie können den Titel auch leer lassen. |
| Datentabelle | Wählen Sie die Datentabelle, welche dieser Suchindex-Konfiguration zugrunde liegt. |
| Aktiv | Aktivieren Sie diese Suchkonfiguration, damit sie bei der Suche berücksichtigt wird. |
| Beschreibung | Beschreiben Sie dieses Element. |
| Anzeige | |
| Sortierreihenfolge | Geben Sie hier eine Zahl ein, nach der alle aktiven Suchkonfigurationen bei der Darstellung der Suchergebnisse sortiert werden. Suchkonfigurationen ohne Suchergebnisse werden immer nach unten sortiert. |
| Icon | Die Suchergebnisse werden mit dem Datentabellen-Icon angezeigt. Wählen Sie alternativ eine Auswahlliste, deren Icons verwendet werden. |
| Titel | Hinterlegen Sie hier die Formel zur Berechnung der ersten Zeile des Suchergebnisses je Eintrag. Wenn Sie dieses Feld leer lassen, wird standardmäßig der EntityTitle verwendet. Wenn Sie in der Formel Datenspalten aus anderen Datentabellen verwenden als diejenige, für welche der Suchindex konfiguriert ist, müssen diese Datentabellen über Relations-Steuerelemente im Suchindex konfiguriert werden, um das Formelergebnis bei Änderung von Datensätzen der anderen Datentabellen zu aktualisieren. Verwenden Sie statt eines festen Textes eine GUID, um diese beim Anzeigen in die Benutzersprache zu übersetzen. |
| Beschreibung 1 | Hinterlegen Sie hier die Formel zur Berechnung der zweiten Zeile des Suchergebnisses je Eintrag. Wenn Sie dieses Feld leer lassen, wird diese Zeile nicht im Ergebnis angezeigt. Wenn Sie in der Formel Datenspalten aus anderen Datentabellen verwenden als diejenige, für welche der Suchindex konfiguriert ist, müssen diese Datentabellen über Relations-Steuerelemente im Suchindex konfiguriert werden, um das Formelergebnis bei Änderung von Datensätzen der anderen Datentabellen zu aktualisieren. Verwenden Sie statt eines festen Textes eine GUID, um diese beim Anzeigen in die Benutzersprache zu übersetzen. |
| Beschreibung 2 | Hinterlegen Sie hier die Formel zur Berechnung der dritten Zeile des Suchergebnisses je Eintrag. Wenn Sie dieses Feld leer lassen, wird diese Zeile nicht im Ergebnis angezeigt. Wenn Sie in der Formel Datenspalten aus anderen Datentabellen verwenden als diejenige, für welche der Suchindex konfiguriert ist, müssen diese Datentabellen über Relations-Steuerelemente im Suchindex konfiguriert werden, um das Formelergebnis bei Änderung von Datensätzen der anderen Datentabellen zu aktualisieren. Verwenden Sie statt eines festen Textes eine GUID, um diese beim Anzeigen in die Benutzersprache zu übersetzen. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diesen Suchindex benutzen können. Wenn Sie nichts wählen, ist dieser Suchindex grundsätzlich für alle benutzbar. |
| Datensätze | |
| Datensatz öffnen in | Wählen Sie, ob die Suchergebnisse in einem neuen Tab oder einem Dialog geöffnet werden. Treffer aus ‘Zuletzt verwendet’ werden wieder so geöffnet, wie sie zuletzt geöffnet worden waren. |
| Anzeigemaske | Wählen Sie, mit welcher Maske die Suchergebnisse geöffnet werden. Geben Sie hier keine Maske an, um die Standardmaske der Datentabelle zu verwenden. Treffer aus ‘Zuletzt verwendet’ werden wieder in der Maske geöffnet, in der sie zuletzt geöffnet worden waren. Ist dies nicht möglich, wird der gleiche Mechanismus angewendet. |
| Aktiv-Status beachten | Typ der Datensätze, die bei der Suche auf Basis des Aktiv-Status berücksichtigt werden. |
| Datensatz-Filter | Geben Sie eine Formel an, nach der die durchsuchten Datensätze dieser gefiltert werden. In der Dokumentation finden Sie Verweise zur Syntax. |
Steuerelemente für Datenspalten
Die Steuerelemente aus dieser Gruppe fügen Datenspalten der Datentabelle in den Suchindex hinzu. Die Datenspalten kommen entweder aus dem aktuellen Datensatz oder können unter Relations-Steuerelemente geschoben werden und beziehen sich dann auf die dort konfigurierten Datensätze.
Berechnete Spalte
Dieses Steuerelement ermöglicht die Suchindizierung von berechneten Spalten.
| Eigenschaft | Beschreibung |
|---|---|
| Spalte | |
| Name | Geben Sie der berechneten Spalte einen Namen. Der Name wird in der Anwendung nirgendwo angezeigt. |
| Formel | Geben Sie die Formel zur Berechnung des Wertes an. In der Dokumentation finden Sie einen Verweis zur Syntax. Wenn Sie in der Formel Datenspalten aus anderen Datentabellen verwenden als diejenige, für welche der Suchindex konfiguriert ist, müssen diese Datentabellen über Relations-Steuerelemente im Suchindex konfiguriert werden, um das Formelergebnis bei Änderung von Datensätzen der anderen Datentabellen zu aktualisieren. Das Formelergebnis wird in allen konfigurierten Sprachen gespeichert um durchsuchbar zu sein. Verwenden Sie für Texte BATranslate mit der GUID des Textes als Parameter. Die Texte werden in allen Systemsprachen gespeichert und damit durchsuchbar und über die GUID bei Änderung der Übersetzung aktualisiert. |
| Formatierung | Wählen Sie aus, ob das Feld eine Anzeigeformatierung hat. |
| Anzeigeformat | Wählen Sie entweder eine Formatierung aus den Standardformatierungen oder wählen Sie ‘Eigene Formatierung’, um die Formatierung individuell festzulegen. |
| Eigene Formatierung | Geben Sie die Definition für die Anzeigeformatierung des Feldwertes ein. Sie finden alle Möglichkeiten hierfür in der Dokumentation. |
| Nullwert | Geben Sie an, was angezeigt wird, wenn das Ergebnis der Wertberechnung ein Nullwert ist. |
| Gewichtung | Geben Sie eine Zahl an, welche die Gewichtung dieses Feldes gegenüber anderen Feldern dieses Suchindexes bestimmt. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
Dateianhänge
Dieses Steuerelement ermöglicht die Suchindizierung von Anhängen.
| Eigenschaft | Beschreibung |
|---|---|
| Spalte | |
| Datenspalte | Wählen Sie die zum Steuerelement passende Spalte aus der der Maske zu Grunde liegenden Datentabelle aus. |
| Gewichtung | Geben Sie eine Zahl an, welche die Gewichtung dieses Feldes gegenüber anderen Feldern dieses Suchindexes bestimmt. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
Die Anwendung unterstützt über verschiedene „Attachment-Parser” unterschiedliche Typen von Anhängen, welche sie über ihre Dateiendung erkennt. Die Zuordnung der Dateiendungen zu den Parsern kann über den Customer.Config-Parameter „BA:Search.AttachmentParsers” geändert und erweitert werden.
Gepackte ZIP-Archive werden entpackt, um die enthaltenen Dateien zu durchsuchen.
| Attachment-Parser | Standard Dateiendungen |
|---|---|
| CSVParser | .csv |
| DxDocumentServerParser | .pdf,.doc,.dot,.dotm,.docx,.dotx,.docm,.rtf,.odt |
| HtmlParser | .html, .htm |
| LeaveUnchangedParser | .txt,.xml,.log |
| PowerpointParser | .pptx,.pptm |
| ExcelParser | .xlsx,.xlsm |
| ReturnEmptyStringParser | Automatisch für alle anderen Dateiendungen |
| ZipParser | .zip |
Teildatensätze
Dieses Steuerelement ermöglicht die Suchindizierung von Teildatensätzen.
| Eigenschaft | Beschreibung |
|---|---|
| Spalte | |
| Datenspalte | Wählen Sie die zum Steuerelement passende Spalte aus der der Maske zu Grunde liegenden Datentabelle aus. |
| Gewichtung | Geben Sie eine Zahl an, welche die Gewichtung dieses Feldes gegenüber anderen Feldern dieses Suchindexes bestimmt. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
| Datensatzauswahl | |
| Teildatensatz-Auswahl | Wählen Sie optional aus, ob Sie einen konkreten Teildatensatz, aus welchen Sie eine Spalte anzeigen, über seine Position oder – falls vorhanden – seinen eindeutigen Schlüssel ermitteln. Wenn Sie das Feld leer lassen, werden alle Teildatensätze verwendet. |
| Eindeutiger Schlüssel | Wählen Sie den Schlüssel aus, anhand dessen der Teildatensatz ermittelt wird. |
| Position | Wählen Sie die Position des Teildatensatzes aus. |
Text
Dieses Steuerelement ermöglicht die Suchindizierung von einfachen Textspalten.
| Eigenschaft | Beschreibung |
|---|---|
| Spalte | |
| Datenspalte | Wählen Sie die zum Steuerelement passende Spalte aus der der Maske zu Grunde liegenden Datentabelle aus. |
| Gewichtung | Geben Sie eine Zahl an, welche die Gewichtung dieses Feldes gegenüber anderen Feldern dieses Suchindexes bestimmt. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
Wert aus Auswahlliste (Referenz)
Dieses Steuerelement ermöglicht die Suchindizierung von Werten aus Auswahllisten.
| Eigenschaft | Beschreibung |
|---|---|
| Spalte | |
| Datenspalte | Wählen Sie die zum Steuerelement passende Spalte aus der der Maske zu Grunde liegenden Datentabelle aus. |
| Gewichtung | Geben Sie eine Zahl an, welche die Gewichtung dieses Feldes gegenüber anderen Feldern dieses Suchindexes bestimmt. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
Steuerelemente für Relationen
Die Steuerelemente aus dieser Gruppe erlauben, Datenspalten aus über Relationen ermittelbaren anderen Datentabellen in den Suchindex aufzunehmen.
Quellrelation
Dieses Steuerelement definiert einen oder mehrere Datensätze, die Quelle einer Relation sind. Es kann mehrfach geschachtelt werden. Ordnen Sie die konkreten Datenspalten unter diesem Steuerelement an.
| Eigenschaft | Beschreibung |
|---|---|
| Relationsdefinition | Wählen Sie die Relationsdefinition aus, über die der Datensatz ermittelt wird, aus dem der Spaltenwert angezeigt wird. |
| Alle Datentabellen | Wählen Sie, ob die Ermittlung der Quelldatensätze, aus denen eine Datenspalte angezeigt wird, auf ausgewählte Datentabellen beschränkt ist. |
| Datentabellen | Wählen Sie die Datentabellen aus. Wenn Sie nur genau eine Datentabelle wählen, können Sie neben den gemeinsamen Datenspalten auch alle anderen Datenspalten der jeweiligen Datentabelle verwenden. |
| Quelldatensätze | Wählen Sie für hierarchische Relationsdefinitionen aus, wie die Quelldatensätze ermittelt werden. Einige Auswahlmöglichkeiten implizieren den primären Relationspfad. In den anderen Fällen können Sie den Filter auf den primären Relationspfad optional setzen. |
| Nur primäre Relation | Wählen Sie, ob nur primäre Relationen für die Ermittlung der Quelldatensätze berücksichtigt werden. |
| Ebene | Geben sie die Hierarchie-Ebene ein, die je nach Art der Ermittlung der Quelldatensätze benötigt wird. |
| Berechtigungen | |
| Sichtbar für | Wählen Sie die Rollen oder Benutzer, die diese Spalte im Suchindex durchsuchen können. Wenn Sie nichts wählen, ist diese Spalte grundsätzlich für alle benutzbar, die den Suchindex benutzen dürfen. |
Optionen zur Ermittlung der Quelldatensätze
Das Steuerelement erlaubt für hierarchische Relationsdefinitionen verschiedene Optionen, um die Quelldatensätze zu ermitteln. Da es Relationen beliebig oft zwischen Datensätzen geben kann, gibt es mehrere Möglichkeiten, die Quelldatensätze einzuschränken. Neben der Beschränkung auf bestimmte Datentabellen ist hier vor allem die Einstellung zu den „Quelldatensätzen” zu nennen. Für nicht-hierarchische Relationsdefinitionen verhält sich das Steuerelement vergleichbar zu der Option „Direkter Vorgänger”.
| Option | Beschreibung |
|---|---|
| Direkte Vorgänger | Die Relation wird genau einen Schritt verfolgt. Bei mehreren Relationen auf Basis der gleichen Relationsdefinition können mehrere Quelldatensätze ermittelt werden. Die ermittelten Datensätze werden, wenn er zu einer angegebenen Datentabelle gehören, zurückgegeben. |
| Alle Vorgänger | Es werden alle Vorgänger aller Relationsebenen und Relationen der angegebenen Datentabellen ermittelt. |
| Vorgänger bis zu Ebene [n] | Es werden alle Vorgänger aller Relationen mit den angegebenen Datentabellen ausgehend vom aktuellen Datensatz über [n] Hierarchie-Ebenen ermittelt. |
| Vorgänger oberster [n] Ebenen (primär) | Es werden alle Vorgänger der passenden Datentabellen des primären Relationspfades der [n] Hierarchie-Ebenen ausgehend vom Start der Hierarchie oder wenn angegeben vom obersten Vorkommen der angegebenen Datentabellen ermittelt. |
| Vorgänger aus Ebene [n] | Es werden alle Vorgänger der angegebenen Datentabellen aller Relationen einer spezifischen Relationsebene [n] ermittelt. |
| Nähester primärer Vorgänger | Ausgehend vom aktuellen Datensatz wird auf dem primären Relationspfad in Richtung Quelle der näheste Vorgänger der angegebenen Datentabelle ermittelt. |
| Oberster primärer Vorgänger | Ausgehend vom aktuellen Datensatz wird auf dem primären Relationspfad in Richtung Quelle der oberste Vorgänger der angegebenen Datentabelle ermittelt. |
Zielrelation
Dieses Steuerelement definiert alle Datensätze, die Ziel einer Relation sind. Es kann mehrfach geschachtelt werden. Ordnen Sie die konkreten Datenspalten unter diesem Steuerelement an.
| Eigenschaft | Beschreibung |
|---|---|
| Relationsdefinition | Wählen Sie die Relationsdefinition aus, über die der Datensatz ermittelt wird, aus dem der Spaltenwert angezeigt wird. |
| Alle Datentabellen | Wählen Sie, ob die Ermittlung der Zieldatensätze, aus denen eine Datenspalte angezeigt wird, auf ausgewählte Datentabellen beschränkt ist. |
| Datentabellen | Wählen Sie die Datentabellen aus. Wenn Sie nur genau eine Datentabelle wählen, können Sie neben den gemeinsamen Datenspalten auch alle anderen Datenspalten der jeweiligen Datentabelle verwenden. |