# Erweiterte Suche

RealmJoin führt einen überarbeiteten Suchmechanismus ein, der den Echtzeit-Zugriff auf Mandantendaten ermöglicht. Diese Verbesserung gewährleistet eine effiziente Leistung selbst für Mandanten mit einer großen Anzahl von Benutzer-, Geräte- und Gruppenobjekten.

{% hint style="success" %}
Die Advanced Search-Funktion ist für die Tabellen Users, Groups, Devices und Packages verfügbar. \
Sehen Sie sich die Unterseite Use Cases an, um Beispiele zu finden, die Ihnen helfen, mehr Wert aus Ihren Mandantendaten zu ziehen. 
{% endhint %}

Tabellen können mit der *einfachen* oder der *erweiterten* Suchfunktion durchsucht werden. 

{% hint style="info" %} <mark style="color:Standard;background-color:yellow;">**Alle Suchen müssen bestätigt werden, indem entweder das**</mark><mark style="color:Standard;background-color:yellow;">**&#x20;**</mark>*<mark style="color:Standard;background-color:yellow;">**Eingabetaste**</mark>*<mark style="color:Standard;background-color:yellow;">**&#x20;**</mark><mark style="color:Standard;background-color:yellow;">**oder der**</mark>  <img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FHli0RfKsBzt7a91EpdOv%2Fimage.png?alt=media&#x26;token=eadfefc7-d7b2-485c-9902-6fa6c94f8ee4" alt="" data-size="line"> <mark style="color:Standard;background-color:yellow;">**Symbol verwendet wird.**</mark>&#x20;
{% endhint %}

### Einfaches Suchen

Die einfache Suche verwendet die Graph API, um Mandantendaten direkt abzufragen und Ergebnisse in Echtzeit bereitzustellen.&#x20;

Die einfache Suche ist immer als Fallback verfügbar, wenn die erweiterte Suche nicht verfügbar ist. Sie erscheint auch während des ersten Ladens der zwischengespeicherten Tabelle, sodass Benutzer sofort suchen können – noch bevor der Cache vollständig aufgebaut ist.

### Erweiterte Suche

Die erweiterte Suchfunktion von RealmJoin verwendet Caching und Tokenisierung, wodurch Suchen schnell und zuverlässig werden, und unterstützt Unicode-Zeichen wie Ø. Diese Tokenisierung ermöglicht Teilnamenssuchen, sodass eine Abfrage wie "Ma Mu" einen Benutzer namens "Maren Müller" finden kann.&#x20;

Außerdem sind auch Informationen durchsuchbar, die nicht in der Tabelle angezeigt werden, wie Postleitzahlen oder UPN.&#x20;

<figure><img src="https://2298793958-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FpPoUYZyJG9anFKPfehrX%2Fimage.png?alt=media&#x26;token=f27e3c2f-2fa8-41c1-8941-f90c1e6763fe" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Bitte verwenden Sie den "Reload-Button" oben rechts nur dann, wenn Ihnen sehr kürzlich hinzugefügte Informationen aus Entra / Intune fehlen.
{% endhint %}

### Überblick über die Syntax der erweiterten Suche

Die erweiterte Suche ermöglicht Abfragen über alle verfügbaren Tabellenwerte hinweg mit einer flexiblen und leistungsstarken Syntax. Nachfolgend sind die wichtigsten Funktionen und Regeln aufgeführt:

{% hint style="success" %}
Klicken Sie [hier](https://docs.realmjoin.com/de/analysieren-and-exportieren/advanced-search/advanced-search-syntax) für weitere Beispiele und Anwendungsfälle
{% endhint %}

* **Tokenisierte Suche**:\
  Suchbegriffe werden automatisch tokenisiert, um die Treffgenauigkeit zu verbessern. Wenn Sie beispielsweise `lu sk` eingeben, werden Namen wie **Luke Skywalker**gefunden. Die Suche verwendet immer einen **starts-with** -Ansatz statt einer Volltext- oder "contains"-Suche. Das bedeutet, dass eine Suche nach `walk` nicht **Skywalker** zurückgeben würde. **Skywalker**.
* **Logisches UND**:\
  Alle Filter werden mit dem logischen **AND**verknüpft. Jede Bedingung muss erfüllt sein.\
  Beispiel: `Luke Skywalker country:france` sucht nach Luke Skywalker, bei dem das **country** mit "france" beginnt.
* **Spaltenspezifische Suche**:\
  Verwenden Sie `column:` um in einer bestimmten Spalte zu suchen.\
  Beispiel: `country:france` sucht nach Einträgen, bei denen das **country** mit "france" beginnt.
* **Operatoren**:
  * `:` → **startsWith** -Suche\
    Beispiel: `name:jo` passt zu "John", "Joanna" usw.
  * `=` → **ist gleich** -Suche\
    Beispiel: `city=Stuttgart` passt exakt zu "Stuttgart"
  * `!=` oder `!:` → **Negation**\
    Beispiel: `city!=Stuttgart`oder `city!:Stuttgart` schließt "Suttgart" aus
* **Besonderes Verhalten**:
  * **Umlautersetzung**:\
    Umlaute werden normalisiert (z. B. **Björn** kann durch die Suche nach **Bjorn**).
  * **Unicode-Unterstützung**:\
    Unicode-Zeichen werden in Suchbegriffen unterstützt.
  * **Klammern () werden ignoriert** bei startsWith-Suchen.
  * **Suche nach leerem Wert**:
    * `zip:""` sucht nach leeren Werten
    * `zip:` sucht nach einem beliebigen Wert
* **Unterstützte Spalten**:
  * Aliase für Spaltennamen können vorhanden sein und werden in Klammern aufgeführt
  * Benutzertabelle:
    * `name, upn, language (lang), jobtitle (job), city, country, zip (plz), enabled, department (dept)`
      * `enabled:` → akzeptiert `true` oder `false` (`enabled:true`)
  * Gruppentabelle
    * `name`
  * Gerätetabelle
    * `name, operatingsystem (os), manufacturer (manu), model`

### FAQ

#### Wie oft werden die Daten zwischengespeichert?

Die Tabelle wird nach einem Zeitplan zwischengespeichert, derzeit auf 1 Stunde eingestellt.&#x20;

#### Kann ich die Daten manuell aktualisieren?

Oben rechts in jeder Tabelle gibt es eine Schaltfläche, um die zwischengespeicherten Daten zu aktualisieren.

#### Können andere Benutzer meine aktualisierten Daten verwenden?

Die Tabelle ist für alle Benutzer in derselben RealmJoin-Portalinstanz verfügbar. Daher gilt ein ausgelöster Neuaufbau für alle diese Benutzer.&#x20;

#### Was ist eine RealmJoin-Portalinstanz?

Das RealmJoin-Portal verfügt aus Gründen des Load Balancings und der Redundanz über drei verschiedene Instanzen.&#x20;

#### Wie lange dauert ein Neuaufbau / eine Aktualisierung der erweiterten Suche?

Die Dauer des Neuaufbaus hängt von der Größe des Mandanten und der Anzahl der Objekte ab. Es ist nicht ungewöhnlich, dass der Neuaufbau mehrere Minuten dauern kann. Während des Neuaufbaus ist nur die einfache Suche verfügbar. Alle Daten werden dann direkt über Graph abgefragt, wodurch die Möglichkeiten beim Filtern und die Geschwindigkeit reduziert werden.