Directory#

Hinweis

Sehen Sie sich unser Video-Tutorial zum Thema Kontakte (Directory) an.

XPhone Connect Directory ist ein integrierter Verzeichnisdienst, der zentralen Zugriff auf verteilte Kontaktdaten ermöglicht. Sie können verschiedene Datenquellen anbinden und direkt auf Ihre Kontakte und Adressen zugreifen. Die Daten müssen nicht repliziert werden; Sie greifen direkt auf Ihre Originaldaten zu. Anwendungen und Endgeräte kommunizieren über LDAP/HTTP bzw. LDAPS/HTTPS mit sogenannten Client Interfaces, über die Authentifizierung und Suchanfragen laufen, um so auf Ihre Kontaktdaten zugreifen zu können. Mit XPhone Connect Directory werden für einige Datenquellen Standard-Schemata ausgeliefert, die in der Regel so direkt verwendet werden können. Um die Daten aber speziellen Kundenbedürfnissen anzupassen, kann das jeweilige Schema jedoch auch modifiziert werden.

dirgeneral-dark

dirgeneral-light

XPhone Connect Directory bietet eine einfach zu bedienende Benutzeroberfläche, über die Sie schnell neue Datenquellen und Client Interfaces hinzufügen können.

Voraussetzungen#

Einstellungen an der Firewall

Beim Einsatz einer Firewall, muss der Zugriff von außerhalb auf den XPhone Connect Server gewährleistet sein. Richten Sie die Firewall so ein, dass sie den Zugriff auf den Dienst atlasservice.exe zulässt.
Verwendete Ports
Der Zugriff auf folgende Ports muss gewährleistet sein:
- 2230 für die Directory Administrationsoberfläche.
- alle weiteren Ports, die von Client Interfaces verwendet werden.
Software
Die Administrationsoberfläche kann durch die ClickOnce-Technologie mittels eines Links installiert werden. ClickOnce hat folgende Voraussetzungen:
- Windows Installer 5.0
- .NET Framework 4.8
Die Administrationsoberfläche ist eine Windows Presentation Foundation (WPF)-Anwendung. WPF-Anwendungen verwenden Hardwarebeschleunigung für das Rendering der grafischen Oberfläche. Deshalb wird empfohlen, gegebenenfalls den Grafikkartentreiber zu aktualisieren.

Öffnen#

Starten Sie die Administrationsoberfläche entweder direkt auf dem XPhone Connect Server über den Server Manager oder durch die Verknüpfung XPhone Connect Directory im Startmenü, sofern Sie (lokal) die ClickOnce-Anwendung heruntergeladen haben.

Menüleiste#

Die Menüleiste enthält folgende Schaltflächen:

Logging
- Hier können Sie lokale Logs aktivieren. Den Speicherort der Logdateien öffnen Sie über die Schaltfläche Ordner öffnen.
  
  Hinweis
  
  Das Logging für Datenquellen und Client Interfaces wird hier aktiviert.
Hilfe
- Verwenden Sie die Schaltfläche Hilfe, um die Online Hilfe aufzurufen.
Quick Guide
- Verwenden Sie die Schaltfläche Quick Guide, um die Quick Guide Leiste ein- oder auszublenden.

Zuordnungsbereich#

Der Zuordnungsbereich ist in drei vertikale Bereiche unterteilt:

Datenquellen

Der linke Bereich enthält eine Übersicht über die verfügbaren Datenquellen. Sie können hinzugefügt, bearbeitet und gelöscht werden.

Feldzuordnungsschema

Der mittlere Bereich enthält eine Übersicht über die Feldzuordnungsschemas für alle Datenquellen und Client Interfaces. Hier können Sie die Zuordnungen der Datenquellenfelder zum Directory Feld-Schema bearbeiten sowie die Zuordnungen der Felder aus dem XPhone Connect Directory Feld-Schema zu den Feldern des Client Interface bearbeiten.

Client Interfaces

Der rechte Bereich enthält eine Übersicht über die verfügbaren Client Interfaces. Sie können hinzugefügt, bearbeitet und gelöscht werden.

Funktionen für Datenquellen und Client Interfaces#

Sie können über die Administrationsoberfläche Datenquellen und Client Interfaces einrichten, bearbeiten und löschen. Die folgenden Abschnitte geben Ihnen einen Überblick über die wichtigsten Funktionen.

Hinzufügen#

Um eine neue Datenquelle bzw. ein neues Client Interface hinzuzufügen, klicken Sie Datenquelle hinzufügen bzw. Client Interface hinzufügen add_button_green . Der jeweilige Konfigurationsassistent wird gestartet.

Hinweis

Wenn Sie eine neue Datenquelle speichern, ohne die Pflichtfelder auszufüllen, erscheint eine entsprechende Meldung. Zusätzlich werden die einzelnen Schritte im Konfigurationsassistent mit einem Ausrufezeichen markiert, bei denen wichtige Angaben fehlen.

Export und Import#

Bearbeiten#

Um die Einstellungen einer Datenquelle oder eines Client Interfaces zu bearbeiten, klicken Sie auf den jeweiligen Namen. Dadurch wird der entsprechende Konfigurationsassistent geöffnet.

Deaktivieren (bzw. Aktivieren)#

Sie können Datenquellen bzw. Client Interfaces deaktivieren. So verringern Sie beispielsweise die Last auf dem Server (sofern Sie diese Datenquelle nicht benötigen). Die Einstellungen der Datenquelle bzw. des Client Interface gehen dabei nicht verloren.

Klicken Sie auf das Pfeil-Symbol der Datenquelle bzw. des Client Interfaces.
Klicken Sie auf das Pfeil-Symbol neben der Schaltfläche und wählen Deaktivieren bzw. Aktivieren.

Hinweis

Wenn Sie eine Datenquelle bzw. ein Client Interface deaktivieren, sorgt die Option Bei Start des XPhone Connect Servers automatisch aktivieren dafür, dass die entsprechende Datenquelle bzw. das Client Interface bei einem Dienst- oder Serverneustart wieder aktiviert wird.

Löschen#

Klicken Sie bei der Datenquelle oder dem Client Interface auf den Pfeil-Button .
Öffnen Sie das Menü, indem Sie innerhalb der Datenquelle oder des Client Interfaces auf den zweiten Pfeil-Button klicken.
Wählen Sie im Menü Löschen.

Index aktualisieren#

Um die Suchen möglichst effizient zu gestalten, wird je Datenquelle ein Index erstellt. Wenn sich viele Datensätze in der Datenquelle geändert haben, können Sie mit Index aktualisieren eine sofortige Aktualisierung durchführen.

Klicken Sie auf das Pfeil-Symbol der Datenquelle bzw. des Client Interfaces.
Klicken Sie auf das Pfeil-Symbol neben der Schaltfläche und wählen Index aktualisieren.

Status#

Ein Informationssymbol auf dem Verbindungspfeil zwischen Datenquelle (bzw. Client Interface) und Feld-Schema zeigt den Status der Datenquelle bzw. des Client Interfaces an. Fahren Sie mit dem Mauszeiger über das Informationssymbol, um Details zum Status anzuzeigen:

:: Datenquelle oder Client Interface ist aktiviert und bereit Anfragen zu bearbeiten bzw. Treffer zu liefern.
:: Datenquelle oder Client Interface ist deaktiviert, d.h., es werden keine Anfragen bearbeitet und keine Treffer zurückgeliefert.
:: Datenquelle oder Client Interface konnte nicht aktiviert werden und befindet sich im Fehlerzustand. Mögliche Ursachen können u.a. sein: eine fehlerhafte Konfiguration, fehlerhafte Feldzuordnung, die Quelldatenbank ist nicht erreichbar oder fehlende Lizenzen.
:: Dienst ist in Bearbeitung - wird aktiviert bzw. deaktiviert. In diesem Zustand steht die Datenquelle bzw. das Client Interface zur Verarbeitung von Suchen nicht zur Verfügung.

Statistik-Informationen#

Wenn Sie mit dem Mauszeiger über die zuvor beschriebenen Informationssymbole fahren, erscheint eine Statistik-Ansicht.

stat

Die folgenden Informationen werden angezeigt:

Status

Hier sehen Sie, seit wann die Datenquelle bzw. das Client Interface aktiv ist (z.B. seit der Neuanlage bzw. des letzten Dienst-Neustarts).
Index (nur bei Datenquellen)

Standardmäßig wird ein Index über aller Datensätze erstellt. Hier sehen Sie, wann der Index zuletzt aktualisiert wurde (standardmäßig stündlich), wie lange der Index-Abgleich gedauert hat, wann die nächste Aktualisierung ansteht und wie viele Datensätze sich im Index befinden.
Suchstatistik

Hier sehen Sie die Anzahl von Suchanfragen, Suchtreffer und Suchdauer in bestimmten Zeiträumen.

Datenquellen#

Hinweis

Dieses Kapitel beschreibt die allgemeinen Konfigurationsdialoge für Datenquellen. Anleitungen zur Konfiguration spezifischer Datenquellen finden Sie im Kapitel Integration.

Die grundsätzliche Konfiguration einer Datenquelle folgt immer einem ähnlichen Ablauf. Unterschiede bestehen meist in Verbindung und Authentifizierung.

Sie können den Konfigurationsassistenten auf unterschiedliche Weise bedienen:

Verwenden Sie die Schaltflächen Weiter und Zurück, um zwischen den Konfigurationsschritten zu wechseln.
Wählen Sie die einzelnen Schritte im Konfigurationsassistent direkt aus.

Im Folgenden werden die in der Konfiguration regelmäßig verwendeten Dialoge erläutert.

Grundeinstellungen#

In diesem Schritt können Sie die Grundeinstellungen für die Datenquelle festlegen.

Name
- Geben Sie einen Namen zur Identifizierung der Datenquelle ein. Er ist Teil der Identifizierung von Datensätzen. Wird er geändert, werden persistent gespeicherte Referenzen auf Datensätze ungültig. Dieser Name wird später auf der XPhone Connect Directory Administrationsoberfläche angezeigt.
Eindeutige Kennung
- Die Eindeutige Kennung beschreibt eine Datenquelle eindeutig. Sie wird verwendet, um eine eindeutige Referenz auf Kontakteinträge erzeugen zu können.
- Ändern Sie diese Kennung nur in besonderen Fällen z.B. wenn eine Datenquelle gelöscht und durch eine neue ersetzt wurde.
  In diesem Fall kann die Kennung der alten Datenquelle ersetzt werden.
  
  Die Kennung einer gelöschten Datenquelle finden Sie in der Löschnachricht im Event-Log oder in den exportierten Einstellungen.
Beschreibung
- Geben Sie hier optional eine Beschreibung ein.
Bei Start des XPhone Connect Servers automatisch aktivieren
- Wenn die Datenquelle beim Start des XPhone Connect Servers nicht automatisch verbunden werden soll, deaktivieren Sie das Kontrollkästchen (Default: aktiv ). Beim Start des XPhone Connect Servers wird umgehend eine Verbindung zur Datenquelle hergestellt.

Index Zeitplan#

In diesem Dialog können Sie festlegen, an welchen Wochentagen und zu welcher Uhrzeit der Index der Datenquelle aktualisiert werden soll.

Der Index wird aus den indizierten Feldern aller Datensätze aufgebaut, die aus den Datenquellen ausgelesen werden. XPhone Connect Directory nutzt diesen Index, um bei Suchanfragen Daten in den Datenquellen schneller zu finden. Benutzer erhalten als Suchergebnis nicht die Daten aus dem Index, sondern die Originaldaten der Datenquelle. Es findet (außer bei CSV-Dateien) keine Replikation der Originaldaten in der XPhone Connect Directory Datenquelle statt.

Damit die Daten im Index möglichst aktuell bleiben, können Sie über Start- und Endzeit sowie ein frei wählbares Intervall festlegen, wann und wie oft der Index automatisch aktualisieren werden soll.

Wochentage

Aktivieren Sie die Wochentage, an denen der Index aktualisiert werden soll.
Startzeit

Wählen Sie die Uhrzeit der erstmaligen Aktualisierung.
Endzeit

Wählen Sie die Uhrzeit der letztmaligen Aktualisierung. (Endzeit >= Startzeit)
Intervall

Wählen Sie die Häufigkeit der Index-Aktualisierung (Format: HH:MM, 00:00 bedeutet einmalige Ausführung zur Startzeit).

Achtung

Haben Sie mehrere Datenquellen hinzugefügt, kann eine gleichzeitige Aktualisierung der jeweiligen Indexeinträge zu Performance-Problemen führen.
Achten Sie auch darauf, dass die Index-Aktualisierungen und Konnektor Synchronisation wenn möglich nicht parallel ausgeführt werden. Dies kann zu hoher CPU Auslastung führen.

Datenzugriff#

In diesem Abschnitt können Sie festlegen, ob Sie die kurzzeitige Speicherung von Suchergebnissen aktivieren wollen.

Cache aktivieren

Die kurzzeitige Speicherung von Suchergebnissen (Cache) entlastet die angeschlossene Datenquelle und verkürzt die Ausführungszeit einer Suche für den Fall, dass während der Dauer der Speicherung viele Suchanfragen dieselben Treffer ergeben, da für bereits gespeicherte Treffer kein Zugriff auf die angeschlossene Datenquelle stattfindet.
Speicherdauer (Minuten)

Anschließend kann konfiguriert werden, wie lange die Suchergebnisse gespeichert werden sollen. Die Dauer der Speicherung stellt einen Kompromiss zwischen Aktualität der Treffer, Entlastung der angeschlossenen Datenquelle und Beschleunigung der Suchen dar.

Hinweis

Die Aktivierung des Caches ist dann sinnvoll, wenn Einträge in der Datenquelle nicht ständig aktualisiert werden. Insbesondere für langsame Datenquellen ist es empfehlenswert, diese Funktion zu nutzen.

Rufnummernkonvertierung#

In diesem Schritt können Sie einen Wahlparameter pro Datenquelle bzw. Client Interface festlegen, mit dem Rufnummern automatisch vervollständigt werden. Wahlparameter werden verwendet, um Rufnummern der Kontakte aus unterschiedlichen Datenquellen zu normieren, d. h., in ein einheitliches Format zu bringen. Nur so kann sichergestellt werden, dass die Benutzer bei einer Suche die richtigen Kontaktdaten finden. Die folgenden Beispiele geben einen Überblick über die Verwendung von Wahlparametern.

Wählen Sie eine Rufnummernkonvertierung aus: Wählen Sie aus der Liste einen Wahlparameter, um die Rufnummern aus der Datenquelle in das gewünschte Format zu vervollständigen. Es wird eine Vorschau des Rufnummernformats angezeigt.

Berechtigung#

In diesem Schritt können Sie festlegen, welche Benutzer und Benutzergruppen auf die Datenquellen zugreifen dürfen. Sie können festlegen, wie der Zugriff auf die Datenquellen geregelt sein soll:

Priorität#

In diesem Schritt können Sie festlegen, welche Priorität die Treffer dieser Datenquelle haben sollen.

Sortierung von Treffern

Die Sortierung der Treffer wird durch den XPhone Connect Client vorgenommen und ist zweistufig:

Die Treffer der Datenquelle mit der höchsten Priorität (größte Zahl) werden an den Anfang der Liste gestellt.
Alle anderen Treffer werden danach aufgelistet, dabei ist diese Reihenfolge unabhängig von der Priorität.

Hinweis

Möglichst viele Datenquellen mit gleicher Priorität erhöhen die Such-Performance.

Priorität

Es sind Werte zwischen 1 und 999 zulässig (die größte Zahl entspricht der höchsten Priorität). Bei mehreren Datenquellen wird die Reihenfolge anhand der aktuellen Priorität angezeigt. Sobald die Priorität verändert wird, aktualisiert sich auch die Anzeige der Reihenfolge.

Näherungssuche#

Die Näherungssuche versucht eine Firmennummer zu ermitteln, wenn keine passende Durchwahl gefunden werden kann. Ein Kontakt muss folgende Voraussetzungen erfüllen um als Näherungstreffer herangezogen zu werden:

Zentralen müssen entweder einen Wert in Firma und keine Werte in Name und Vorname,
Oder einen Wert in Name und keinen Wert in Firma und Vorname,
Oder einen Wert in Name und den gleichen Wert in Firma und keinen Wert in Vorname haben.
Anruferidentifizierung

Wird das Kontrollkästchen aktiviert, so wird bei unbekannter Durchwahl die Nummer der Zentrale angezeigt. Erforderliches Rufnummernformat im Adressbuch, z.B.: +49(89)12345-0

Übersicht#

In diesem Schritt können Sie die Einstellungen überprüfen, die Sie für die Datenquelle vorgenommen haben.

Übersicht

Vergewissern Sie sich, dass alle getätigten Einstellungen korrekt sind.
Speichern

Klicken Sie Speichern, um die Konfiguration abzuschließen und die Datenquelle hinzuzufügen.
Abbrechen

Klicken Sie Abbrechen, um die Konfiguration zu verwerfen.
Datenquellen-Felder dem XPhone Directory Schemata zuordnen.
- Klicken Sie Datenquellen-Felder zum XPhone Connect Directory zuweisen, um die Zuordnung der Felder aus der Datenquelle zu den Feldern des XPhone Connect Directory Zuordnungsschemas anzupassen.
- Wenn Sie eine neue Konfiguration angelegt haben, werden Sie aufgefordert, die Konfiguration zuerst zu speichern.
- Wenn Sie eine bestehende Konfiguration geöffnet haben, können Sie mit der Zuordnung fortfahren.

XPhone Connect Directory versucht beim Speichern, eine Verbindung zur Datenquelle herzustellen.

Im Erfolgsfall wird das Informationszeichen info_green , zwischen Datenquelle und Mapping, grün dargestellt. Positionieren Sie den Mauszeiger über dem Informationszeichen um den Tooltip mit weiteren Informationen darstellen zu lassen. Bei einer fehlerhaften Konfiguration erscheint die Fehlermeldung Configuration error im Tooltip und das Symbol zeigt info_red . Kann keine Verbindung zur Datenquelle hergestellt werden, erscheint das Symbol Nicht verbunden warning .

Client Interfaces#

Hinweis

Dieses Kapitel beschreibt die allgemeinen Konfigurationsdialoge für Client Interfaces. Anleitungen zur Konfiguration spezifischer Client Interfaces finden Sie im Kapitel Integration.

Die grundsätzliche Konfiguration eines Client Interfaces folgt immer einem ähnlichen Ablauf. Im Detail können Unterschiede bestehen.

Sie können den Konfigurationsassistenten auf unterschiedliche Weise bedienen:

Verwenden Sie die Schaltflächen Weiter und Zurück, um zwischen den Konfigurationsschritten zu wechseln.
Wählen Sie die einzelnen Schritte im Konfigurationsassistent direkt aus.

Im Folgenden werden die in der Konfiguration regelmäßig verwendeten Dialoge erläutert.

Grundeinstellungen#

In diesem Schritt können Sie die Grundeinstellungen für das Client Interface festlegen. Sie können einen Namen und eine Beschreibung vergeben und festlegen, ob das Client Interface automatisch verbunden werden soll, wenn XPhone Connect Directory gestartet wird.

Name
Geben Sie einen Namen für das Client Interface ein, das Sie hinzufügen möchten. Dieser Name wird später auf der XPhone Connect Directory Administrationsoberfläche angezeigt.
Beschreibung
Geben Sie hier optional eine Beschreibung des Client Interfaces ein.
Bei Start des XPhone Connect Servers automatisch aktivieren
Wenn das Client Interface beim Start des XPhone Connect Servers nicht automatisch verbunden werden soll, deaktivieren Sie das Kontrollkästchen (Default: ).

IP & Port#

Ein großer Teil der Client Interfaces basiert auf Protokollen (z.B. LDAP), für deren Betrieb eine IP-Adresse und ein Port benötigt werden. In diesem Schritt können Sie die Verbindungseinstellungen für das Client Interface festlegen. Sie können eine IP-Adresse und eine Portnummer angeben, über die die Benutzer mit ihren Clients (Anwendung bzw. Endgerät) auf den XPhone Connect Server zugreifen. Sie können neue Verbindungseinstellungen hinzufügen add_button_green , vorhandene Verbindungseinstellungen bearbeiten edit und vorhandene Verbindungseinstellungen löschen delete .

Authentifizierung#

In diesem Schritt können Sie festlegen, wie sich die Benutzer mit Ihren Clients (Anwendung bzw. Endgerät) am Server anmelden. Abhängig vom Client Interface sind u.U. nicht alle Authentifizierungsarten möglich.

Keine Anmeldung notwendig
Aktivieren Sie das Kontrollkästchen Keine Anmeldung notwendig, wenn die Benutzer sich nicht authentifizieren müssen. Es findet keine Überprüfung statt, wer auf den XPhone Connect Server zugreift. Haben Sie bei der Konfiguration der Datenquellen den Zugriff über Berechtigungen eingeschränkt, dann können Benutzer nicht auf alle Daten zugreifen, wenn dieses Kontrollkästchen aktiviert ist.
Angabe von Name und Kennwort
Aktivieren Sie das Kontrollkästchen Angabe von Name und Kennwort, wenn die Benutzer sich durch ihren Benutzernamen und Kennwort authentifizieren müssen. Bei dieser Authentifizierungsmethode können Sie wählen, welche Anmeldedaten abgefragt werden sollen:
- Benutzer können sich durch Angabe ihrer XPhone Connect Server Anmeldedaten oder durch Angabe ihrer Active Directory Anmeldedaten anmelden. Die Felder BENUTZERNAME und KENNWORT müssen hier LEER bleiben.
- Benutzer müssen einen vorgegebenen Benutzernamen und Kennwort eingeben. Legen Sie hierzu im Feld BENUTZERNAME einen Benutzernamen und im Feld KENNWORT ein Kennwort fest.
- Teilen Sie den Benutzern anschließend den Benutzername und das Kennwort mit.

Aktivieren Sie das Kontrollkästchen Integrierte Windowsanmeldung (Es ist nicht bei allen Client Interfaces vorhanden), wenn die Windows-Anmeldedaten der Benutzer verwendet werden sollen. Die Anmeldedaten werden automatisch weitergegeben, wenn die Benutzer auf den XPhone Connect Server zugreifen. Die Benutzer müssen beim Zugriff über einen Client ihre Anmeldedaten nicht erneut eingeben.

Hinweis

Falls Benutzer beim Zugriff auf ein Client Interface ihre Anmeldedaten aus dem Active Directory eingeben, muss der Benutzername im Format <Domäne>\<Benutzername> eingegeben werden.

Sicherheit#

In diesem Schritt können Sie festlegen, ob Sie den Zugriff auf XPhone Connect Directory nur für bestimmte IP-Adressen der Clients zulassen wollen. Sie können einzelne IP-Adressen für Clients angeben oder IP-Adressbereiche für Clients festlegen, die auf XPhone Connect Directory zugreifen dürfen. Sie können neue IP-Adressen bzw. IP-Adressbereiche hinzufügen, vorhandene IP-Adressen bzw. IP-Adressbereiche bearbeiten und vorhandene IP-Adressen bzw. IP-Adressbereiche löschen.

Suche#

In diesem Kapitel können Sie festlegen, ob die Datenquellen-Priorisierung aktiv ist und wie öffentliche Verzeichnisse einbezogen werden sollen.

Priorität der Datenquellen berücksichtigen
Aktivieren Sie das Kontrollkästchen, um die Datenquellen-Priorisierung zu aktivieren.

Öffentliche Verzeichnisse

In Anruferidentifizierung mit einbeziehen
Wenn öffentliche Verzeichnisse für die Anruferidentifizierung mit einbezogen werden sollen, so aktivieren Sie dieses Kontrollkästchen.
Bei Kontaktsuche durchsuchen
Einstellung, ob bzw. wie öffentliche Verzeichnisse für die Kontaktsuche verwendet werden sollen (Immer / Nie / Nur für Suchanfragen, die mit einem Punkt beginnen).

Rufnummernkonvertierung#

In diesem Schritt können Sie einen Wahlparameter pro Client Interface festlegen, mit dem Rufnummern automatisch vervollständigt werden. Die Wahlparameter werden verwendet, um Rufnummern der Kontakte aus unterschiedlichen Datenquellen zu normieren, d. h., in ein einheitliches Format zu bringen.

Wählen Sie eine Rufnummernkonvertierung aus
Wählen Sie den Wahlparameter aus, der das Rufnummernformat am Standort der Anwender, welche dieses Client Interface verwenden, beschreibt. Er dient dazu, z.B. eine Rufnummer im internationalen Format in die kürzest mögliche Darstellungsform umzuwandeln um die bestmögliche Lesbarkeit für den Anwender zu erreichen.
Formatierung auswählen
Wählen Sie aus der Liste ein Format aus, in welchem die Rufnummern dargestellt werden sollen.

Treffermengenbegrenzung#

In diesem Schritt können Sie die maximale Größe der Treffermenge festlegen.

Die Begrenzung der Treffermenge entlastet die hinzugefügten Datenquellen. Eine zu große Anzahl an Suchergebnissen kann von den Anwendern nicht mehr vollständig erfasst werden und deutet auf zu allgemein gehaltene Suchkriterien hin.

Übersicht#

In diesem Schritt können Sie die Einstellungen überprüfen, die Sie für das Client Interface vorgenommen haben. Vergewissern Sie sich, dass alle getätigten Einstellungen korrekt sind.

Klicken Sie Speichern, um die Konfiguration abzuschließen und das Client Interface hinzuzufügen.
Klicken Sie Abbrechen, um die Konfiguration zu verwerfen.
Mit der Feldzuordnung fortsetzen
Klicken Sie Mit der Feldzuordnung fortsetzen, um die Felder des Client Interface zuzuordnen.
- Wenn Sie eine neue Konfiguration angelegt haben, werden Sie aufgefordert, die Konfiguration zuerst zu speichern.
- Wenn Sie eine bestehende Konfiguration geöffnet haben, können Sie mit der Zuordnung fortfahren.

Feld-Schemas#

Damit die Kontakte Ihrer Datenquellen korrekt verarbeitet und auf verschiedenen Geräten sowie in Anwendungen anzeigen werden, müssen die Felder Ihrer Datenquellen und Client Interfaces dem Directory Schema zugeordnet werden.

Für verschiedene Datenquellentypen, wie beispielsweise Microsoft Outlook-Kontaktordner, sowie unterschiedliche Client-Interface-Typen sind bereits zahlreiche Standardzuordnungsschemata vorhanden, in denen die Kontaktfelder automatisch verknüpft sind.

Wenn Sie Datenquellen hinzufügen, für die kein Feld-Schema existiert, müssen Sie die Felder manuell zuordnen.
Ordnen Sie in diesem Fall mindestens die Felder Name, Telefonnummer und EntryID zu.
Das Feld EntryID ist im Feld-Schema das Schlüsselfeld. Es wird benötigt, um in den Datenquellen Einträge zu finden.

Das Feld EntryID muss immer zu einem entsprechenden Schlüsselfeld (zum Beispiel EntryID, ID, guiID, ObjectID) in der Datenquelle zugeordnet werden. Der Feldinhalt muss eindeutig sein. Dies ist beispielsweise mit einer eindeutigen Kundennummer realisierbar.

Achtung

Ist das Feld EntryID in mehreren Kontakten nicht gepflegt, d.h. leer, so ist es nicht eindeutig. Dann findet XPhone Connect Directory in den Datenquellen keine Einträge. Wenn die Datenquelle kein eindeutiges Schlüsselfeld hat, kann ein Schlüsselfeld durch die Kombination mehrerer Datenquellenfelder definiert werden.
Im Fenster Datenquellen Felder zuweisen sind bestimmte Felder mit einem i vor dem Feldnamen markiert. Dies kennzeichnet die Felder, die indiziert werden.

Aus den indizierten Feldern wird ein Index aufgebaut. Bei Suchanfragen wird dieser Index durchsucht, um Daten in den Datenquellen schneller zu finden.

Zuordnen#

Um die Standardzuordnung der Felder zu ändern, klicken Sie mittig auf die Schaltfläche für die Feldzuordnung:

field_mapping_button

Unterscheiden Sie dabei zwischen den Feld-Schemas für Datenquellen (linke Seite) und für Client Interfaces (rechte Seite).

Einzelne Felder#

Sie können im Feld-Schema ein Feld aus der Datenquelle oder des Client Interfaces einem Directory-Feld zuweisen.

Markieren Sie ein Feld aus der Datenquelle oder des Client Interfaces und ziehen Sie es per Drag & Drop auf das gewünschte Feld im XPhone Directory Schema.

Sie können Felder von der linken auf die rechte Seite ziehen oder umgekehrt.
Klicken Sie Speichern, um die Änderungen zu übernehmen.

Ein Pfeil zeigt an, welche Felder einander zugeordnet sind. Wenn Sie ein Feld markieren, werden der Pfeil und das zugeordnete Feld farblich hervorgehoben.

Mehrere Felder#

Löschen#

Sie können Feldzuordnungen löschen, wenn sie z.B. falsch zugeordnet wurden, oder wenn Sie die Zuordnung nicht benötigen.

Markieren Sie das Feld aus der Datenquelle oder der Client interfaces, dessen Zuordnung Sie löschen möchten.

Der Zuordnungspfeil wird farblich hervorgehoben.
Klicken Sie das rote X auf dem Pfeil, um die Zuordnung aufzuheben.
Klicken Sie Speichern.

Hinweis

Sie können nur Feldzuordnungen löschen, bei denen der Pfeil mit einem roten X markiert ist. Zuordnungen mit einem schwarzen X im Zuordnungspfeil sind schreibgeschützt und können nicht gelöscht werden.

Zurücksetzen#

Sie können die Feldzuordnungen, die Sie manuell geändert haben, wieder auf die ursprünglich eingestellten Zuordnungen zurücksetzen.

Klicken Sie Zurücksetzen.
Klicken Sie Speichern, um die Änderungen zu übernehmen.

Ansicht anpassen#

Sie können wählen, welche Felder Sie anzeigen möchten, oder die Sortierreihenfolge der Felder ändern. Sie können zum Beispiel nur die Felder anzeigen, die noch nicht zugeordnet sind, oder die Felder alphabetisch sortieren.

Klicken Sie die Auge-Schaltfläche.
Um die Anzeige der Felder zu ändern, wählen Sie alle Felder, zugewiesene Felder oder nicht zugewiesene Felder.
Um die Sortierreihenfolge der Felder zu ändern, wählen Sie nach Zuordnung oder nach Feldnamen.

Sie können auch nach Feldnamen sortieren. Klicken Sie dazu in der Kopfzeile der Datenquelle, der Client Interfaces oder des XPhone Directory Schemas auf Feldname.

Vorschau und blättern#

Sie können eine Vorschau auf Ihre Kontaktdaten anzeigen und durch die Kontakte in Ihrer Datenquelle blättern.

Klicken Sie in der Spalte Beispiel die Pfeile < bzw. >, um durch die Kontakte zu blättern.

Diese Funktion ist nur in der Tabelle mit den Datenquellenfeldern verfügbar.
Klicken Sie in der rechten Spalte auf Zugewiesen zu bzw. Beispiel um zwischen einer Vorschau auf Ihre Kontaktdaten und den zugeordneten Feldnamen umzuschalten.

Diese Funktion ist nur in der Tabelle mit den Feldern des XPhone Directory Schema verfügbar.

Erweiterte Bearbeitung von Feldern#

Wenn Datenfelder mehrere Werte enthalten, können Sie bearbeitet, ersetzt, in ihrer Reihenfolge und Darstellung angepasst und/oder durch Trennzeichen ergänzt werden.

Um dieses Verhalten zu demonstrieren können z.B. mehrere Felder einer Datenquelle zu einem Feld im XPhone Directory Schema zugewiesen werden.
Das Trichter-Symbol öffnet den Dialog Datenbankfelder verbinden.
Im oberen Bereich werden die ausgewählten Datenbankfelder mit Feldname, ID und Beispiel aufgelistet.
Über die Pfeiltasten, kann zwischen den Beispieldatensätzen vor- und zurücknavigiert werden.
In dem Reiter Verketten können die ausgewählten Datenbankfelder in der Reihenfolge der Verkettung verändert oder aus der Verkettung entfernt werden.

Im Feld Trennzeichenkette kann ein beliebiges Trennzeichen für die Datenbankfelder eingegeben werden z.B. , oder ;. Das Ergebnis der formatierten Verkettung wird im unteren Bereich dargestellt.
In dem Reiter Bearbeiten kann neben Bestimmung der Reihenfolge (s. o. Verketten) in der mittleren Drop-Down-Liste ausgewählt werden, ob der Inhalt des Datenbankenfeldes kopiert (Copy), mittig (Mid), links (Left) oder rechts (Right) platziert, gesplittet (Split) oder durch einen regulären Ausdruck (RegEx) ersetzt werden soll.
- Bei der Auswahl von Mid, Left oder Right können unter dem Feld die Seitenbegrenzungen und Längen angegeben werden.
- Bei der Auswahl von Split kann unter dem Feld ein Trennzeichen, sowie die nullbasierte Position der Teilzeichenfolge angegeben werden (nullbasiert: die erste Teilzeichenfolge ist 0, die zweite 1, …), z.B: Mustermann-Max-Musterstr. 5-Musterstadt.
  Trennzeichen: -
  
  Nummer der Teilzeichenfolge: 1
  
  Ergebnis: Max
- Bei RegEx kann unter dem Feld angegeben werden, welcher Ausdruck (Match) ersetzt werden soll (Replace).
In dem Reiter Programmieren, kann benutzerdefinierter C# Quelltext erstellt werden, der definiert wie die einzelnen Felder bearbeitet und miteinander verknüpft werden.

Dazu bearbeiten Sie die bereits vorhandene Methode Transfer. Durch die Schaltfläche Übersetzen kann anschließend überprüft werden, ob der Quelltext übersetzt werden kann und das korrekte Ergebnis liefert.
Um die Eingaben zu übernehmen oder zu verwerfen drücken Sie Speichern bzw. Abbrechen.

Weitere Attribute anlegen#

Das Fenster Datenquellen Felder zuweisen bietet bei den LDAP-basierenden Client Interfaces eine zusätzliche Schaltfläche, mit der Sie zusätzliche Attribute für das Client Interface anlegen können. Diese Funktion ist dann hilfreich, wenn Sie in Ihrer Anwendung oder auf Ihrem Endgerät ein Feld mit einer bestimmten Bezeichnung benötigen, das unter diesem Namen im mitgelieferten XPhone Connect Directory Feld-Schema aber nicht existiert. In diesem Fall können Sie ein weiteres Feld mit der gewünschten Bezeichnung anlegen und anschließend ein Feld aus dem XPhone Connect Directory Feld-Schema zuordnen.

Klicken Sie die Schaltfläche Neues Attribut hinzufügen.
Geben Sie den neuen Feldnamen ein und klicken Sie Ok.

Suche mit Umlauten#

Standardmäßig berücksichtigt die Suche auch alternative Schreibweisen von Umlauten (z.B. ae, oe oder ue). Dieses Standardverhalten lässt sich in der Datenquelle ändern:

Starten Sie dazu das Microsoft SQL Management Studio (SSMS) mit vollen Administrator-Rechten.
Öffnen Sie die SQL-Instanz in der die XPVDIR-Datenbank läuft. Dies ist im Standard die Instanz XPCONNECT.

Wie Sie bei Bedarf den Zugang auf die Instanz bekommen, können Sie hier nachlesen: Datenbanksicherheit
Öffnen Sie die Eigenschaften von VDir_Default_Catalog unterhalb von Storage > Full Text Catalogs und setzen Sie für Accent Sensitive den Wert True:
Die Suche berücksichtigt anschließend nur noch Treffer mit echten Umlauten.