=============
Konfiguration
=============

In der Admin-Version der App befindet sich ein Menüpunkt ``Einstellungen``.
Über die dort vorhandenen Optionen wird die Funktionsweise der App festgelegt.

Filter und Gruppen
==================

.. thumbnail:: configuration_filtergroups.png

Definition der auswählbaren Filter und durchsuchbaren Telefon-Gruppen

Filter
------

Es können entweder alle Filter oder nur bestimmte Filter in der App angeboten werden.
Welche Filter in der App angeboten werden, entscheidet sich aufgrund der Einstellungen unter ``Präfix Anruffilter``.

**alle Filter**

Um alle in der PBX angezeigten Filter in der App zur Auswahl anzubieten, wird ``*`` eingetragen.
Dabei werden die Filter 1:1 wie in der PBX benannt in der App angezeigt.

**Filter mit Präfix**

Sollen nur bestimme Filter angeboten werden, können diese Filter in der PBX mit einem Präfix eingerichtet werden.
Wird zum Beispiel ``_`` als Präfix definiert, werden die in der PBX konfigurierten Filter ``_gesperrt``, ``_national`` oder ``_international`` zum Umschalten in der App angeboten.
In der App werden die Filter ohne das Präfix angezeigt. In diesem Beispiel als ``gesperrt``, ``national`` bzw. ``international``.

Gruppen
-------

Unter der Option ``Telefon-Gruppen`` wird festgelegt, welche Nebenstellen anhand einer Suche gefunden werden sollen.

Im Auslieferungszustand ist mit dem Wert ``___all___`` eingestellt, dass alle in der PBX vorhanden 
User-Objekte in die Suche mit einbezogen werden.
Das impliziert, dass auch alle so gefundenen User-Objekte über die App einen Filter gesetzt bekommen können.
Und das ist in den meisten Fällen vermutlich nicht gewünscht.

Daher kann eine beliebige Anzahl an Gruppen definiert werden.
Mehrere Gruppen werden kommagetrennt eingetragen.
Mit dieser Einstellung werden dann über die App nur noch die User-Objekte gefunden, die in mindestens einer dieser Gruppen enthalten sind.
Dabei reicht eine einfache Mitgliedschaft aus: ``static``, ``dyn-in`` oder ``dyn-out`` ist für diese App irrelevant.

Beispiel: In einem Krankenhaus sollen alle Telefone, die Patienten zu geordnet sind, in der App konfiguriert werden können.
Diese Telefone werden ggf. nach Häusern aufgeteilt und in der PBX den Gruppen ``PatientenHaus1`` und ``PatientenHaus2`` zugeordnet.
In der App wird in dem Feld ``Telefon-Gruppen`` daher ``PatientenHaus1,PatientenHaus2`` konfiguriert.
Damit werden über die Suche nur noch die Nebenstellen in einer dieser beiden Gruppen gefunden.

Suche
=====

.. thumbnail:: configuration_search.png

Konfiguration des Verhaltens der Suche

Maximale Anzahl an Ergebnissen
------------------------------

Definiert die Anzahl an Ergebnissen, die pro Suche angezeigt werden können.
Voreingestellt sind 100 Treffer, maximal möglich sind aus Leistungsgründen 1000.

Zeige Pbx und Node Namen in Suchergebnissen
-------------------------------------------

Wenn aktiviert, wird der Pbx Name und die Location/Node in Suchergebnissen zusätzlich zu der Rufnummer angezeigt.

Automatische Anzeige der ersten Ergebnisse
------------------------------------------

Wenn aktiviert, wird beim Öffnen der Suchseite eine Suche durchgeführt und die ersten Treffer angezeigt.
Wenn die Option deaktiviert ist, muss zur Anzeige von Suchtreffern mindestens ein Zeichen eingegeben werden.

Suchfelder
----------

Über einzelne Optionen kann eingestellt werden, in welchen Feldern gesucht wird.
Voreingestellt ist, dass in allen genannten Feldern gesucht wird.

+-----------------+-----------------------------------------------------------------------------------------------------+
| Option          | Funktion                                                                                            |
+-----------------+-----------------------------------------------------------------------------------------------------+
| Suche in DN     | Wenn aktiviert, wird der Anzeigename (DN) durchsucht und passende Einträge in der Suche aufgeführt. |
+-----------------+-----------------------------------------------------------------------------------------------------+
| Suche in CN     | Wenn aktiviert, wird der Anzeigename (DN) durchsucht und passende Einträge in der Suche aufgeführt. |
+-----------------+-----------------------------------------------------------------------------------------------------+
| Suche in H323   | Wenn aktiviert, wird das Feld H323/SIP durchsucht und passende Einträge in der Suche aufgeführt.    |
+-----------------+-----------------------------------------------------------------------------------------------------+
| Suche in E164   | Wenn aktiviert, wird das Feld E164 durchsucht und passende Einträge in der Suche aufgeführt.        |
+-----------------+-----------------------------------------------------------------------------------------------------+