Dashboard-Anzeige im Client & Anrufer-Toast#
Ein Dashboard kann je nach gewählter Anzeige-Option im XPhone Client oder im Anrufer-Toast angezeigt werden.
Dashboard-Anzeige in der Kontaktkarte#
Dashboard-Anzeige in der Konversation#
Dashboard-Anzeige im Anrufer-Toast#
Dashboard-Anzeige in der Detail-Ansicht des Anrufjournals#
Automatisches Aktivieren der Dashboardansicht#
Die Dashboardanzeige kann automatisch aktiviert werden. Der Administrator kann das Verhalten des Clients in der Web-Web-Administration unter Benutzerverwaltung > <Standort/Konfigurationsgruppe > Connect Client > Dashboard für die Benutzer einer Gruppe vorbelegen.
Der Benutzer kann die Vorgabe im Einstellungsdialog des XPhone Clients unter Allgemein > Dashboard überschreiben.
Aktivieren des Dashboards und Ausführen der Dashboardsuche#
Die Dashboardfunktion wird aktiviert, indem der Administrator unter Benutzerverwaltung > Standort/Konfigurationsgruppe > Connect Client > Dashboard die Option Dashboard verwenden aktiviert.
Authentifizierung am Connect Directory#
Der Zugriff auf das XPhone Directory erfolgt über das Client Interface AppLink, der Benutzerkontext ist im Default Anonym.
Hinweis
Durch Ändern des Standard-AppLink-URL auf den Pfad applink2 statt appLink kann die integrierte Windows-Anmeldung aktiviert werden. Dies gilt auch für Verwendung des URL aus einem Browser.
Eine Berechtigungsvergabe ist dann über die Berechtigungen der Datenquellen des XPhone Directory möglich.
Mehrfachtreffer und Kontaktselektor#
Der XPhone Client sucht das Dashboard im Default stets exakt für den Kontakt, der in der Kontaktkarte oder Konversation angezeigt wird. Bei Mehrfachtreffern über den Kontaktselektor wird auch das Dashboard entsprechend aktualisiert:
Optional kann das Verhalten geändert werden, indem die folgende Einstellung in den erweiterten Einstellungen für den XPhone Client im Standort oder für eine Konfigurationsgruppe gesetzt wird. Der Client sucht das Dashboard für einen Kontakt dann nicht über die Kontakt-ID, sondern startet eine erneute Suche über die Rufnummer. Mehrfachtreffer können dann über den Kontaktselektor innerhalb des Dashboards aufgelöst werden:
Wechseln Sie zu Benutzerverwaltung > Standort/Konfigurationsgruppe > Connect Client > Erweiterte Einstellungen
Fügen Sie folgenden Wert hinzu:
Dashboard.ForceCallnoSearch = True
Fügen Sie folgenden Wert für die Auswahl im Toast hinzu:
Dashboard.ForceCallNoSearchToast = True
Achtung
Der Kontakt in der Konversation ändert sich nur durch den Kontaktselektor im XPhone Client, also ohne die Einstellung Dashboard.ForceCallnoSearch.
Skript ausführen bei Gesprächsstart und- ende#
Der XPhone Connect-Client ist in der Lage bei Gesprächsstart, bei Gesprächsende und wenn die Verbindung zustande kommt, eine Batch-Datei ausführen. Es gelten die gleichen Regeln wie bei der Ausführung von Actions mit der Application-ID BATCH. Siehe Batch-Datei ausführen (Clientseitige Skripte).
Aktivieren#
Die Ausführung muss in der Server-Administration unter den Erweiterten Einstellungen der Konfigurationsgruppe aktiviert werden.
Die Batch-Dateien erhalten den kompletten Datenkontext über Umgebungsvariable. Alle Code-Beispiele gelten auch für diese Art der Kommandoausführung (siehe Beispiele Client-Skripte).
Der Parameter ActionString entspricht dem Parameter Link-URL einer Action. Er kann ebenfalls einen Params-Wert enthalten (Beispiel: Name=Endcall.bat|Params=myFile.txt).
Weitere Parameter#
Da der Datenkontext für die jeweilige Aktion von der Anrufersuche abhängt, wird diese vor der Ausführung abgewartet. Die maximale Wartezeit lässt sich über die folgenden Parameter verändern (die gezeigten Werte entsprechen dem Default):
Timeout.PartnerNumber=2000
Timeout.ContactSearch=5000
Prinzipiell lassen sich auch andere Aktionen als „Batch-Datei ausführen“ aufrufen. Daher können die Parameter ApplicationId und ActionId bei Bedarf ebenfalls verändert werden:
StartCall.ApplicationId=”BATCH”
StartCall.ActionId=”RUN”
EndCall.ApplicationId=”BATCH”
EndCall.ActionId=”RUN”
Anrufstatus prüfen#
Die Unterscheidung, ob ein Skript beim „Klingeln“ des Anrufs aufgerufen wurde oder wenn die Verbindung zustande kommt, lässt sich mit dem Skript Anrufstatus prüfen.
Dashboardsuche auch ohne identifzierten Kontakt anzeigen#
Der XPhone Connect-Client sucht im Default nur nach Dashboards, wenn ein identifizierter Kontakt vorliegt. In manchen Fällen ist es notwendig, dass ein Dashboard auch angezeigt wird, wenn keine Kontaktdaten ermittelt werden konnten. Dies ist beispielsweise dann der Fall, wenn nur die Rufnummer eines Anrufs an eine Geschäftsanwendung übergeben werden soll. Dieser Modus wird über eine erweiterte Einstellung in der Konfigurationsgruppe der betreffenden Anwender eingestellt (Benutzerverwaltung > Standort/Konfigurationsgruppe > Connect Client > Erweiterte Einstellungen).
Fügen Sie dort die folgenden Parameter hinzu:
- Anzeige des Dashboards während des Gesprächs
Name:
Dashboard.ForceEmptySearchWert:
true
- Anzeige des Dashboards im Toast
Name:
Dashboard.ForceEmptySearchToastWert:
true
Dashboardsuche mit alternativem Rufnummernformat#
Wenn man die Option Dashboard.ForceCallnoSearch=true in den erweiterten Client-Einstellungen setzt, sucht der Client Dashboards bei Konversationen aufgrund der Partner-Rufnummer,
das Format der Suche ist dabei displayNumberInternal.
Problem: Ruft ein interner Anrufer an, ist die übermittelte Rufnummer (nur Durchwahl) evtl. sehr kurz und die Suche findet z.B. in CRM-Systemen eine große Anzahl von Kontakten.
Lösung: Verwendung des Parameters Dashboard.ForceCallnoSearchFmt.
Dieser kann folgende Werte annehmen:
0 , DisplayNumber
1 , DisplayNumberInternal (Default)
2 , DisplayNumberInternational
2 , GetSearchNumber()
Hinweis
Der Parameter Dashboard.CallnoFmt beeinflusst das Rufnummernformat im Kontext der Dashboard-Anrufe in gleicher Weise.
Dashboard Datenübertragung per HTTPS#
Die Übertragung über HTTPS ist im Standard deaktiviert. Weitere Hinweise finden Sie unter Webserver der Dashboard-Anwendung.
Fehlersuche: Daten einer Action anzeigen#
Die Aufrufparameter einer Action lassen sich anzeigen, indem man die Action mit der rechten Maustaste anklickt und den Befehl In neuem Fenster öffnen auswählt.
Die Adresszeile des Browsers zeigt die übergebenen Parameter z.B.:
https://google.com/?q=Germering+Deutschland+weather
WebView2#
Die Darstellung des Dashboards erfolgt ab XPhone-Windows-Client nicht mehr im Microsoft Internet Explorer Control, sondern im Microsoft Edge WebView2. Diese Komponente wird nicht vom XPhone-Setup mit installiert, sondern muss als Teil des Betriebssystems von der Systemadministration bereitgestellt werden. Es wird die Evergreen-Variante des Webview2 vorausgesetzt (siehe https://docs.microsoft.com/en-us/microsoft-edge/webview2/concepts/distribution). Ist die Webview2-Komponente nicht installiert, erhält der Anwender einen Hinweis beim Starten des XPhone-Clients, eine Dashboard-Darstellung findet nicht statt.
Webserver der Dashboard-Anwendung#
Die Webanwendung des Dashboard-Servers befindet sich auf der Maschine des XPhone Connect-Servers. Um Zugriff auf die Einstellungen des Webservers zu bekommen, verwenden Sie den IIS-Manager. Es werden zwei Web-Anwendungen zur Verfügung gestellt:
AppLink
Applink2
AppLink wird für den anonymen Zugriff auf XPhone Connect Datenquellen und AppLink2 für den Zugriff über integrierte Windows-Anmeldung verwendet.
Achtung
Wenn Sie aus Sicherheitsgründen den anonymen Zugriff auf den Dashboard-Webserver unterbinden möchten:
Aktivieren Sie über den IIS Manager den Zugriff auf das AppLink-Web für Windows-Authentifizierung
und deaktivieren Sie die Anonyme Authentifizierung.
Zugriff per HTTPS#
Um den Dashboard-Zugriff auf HTTPS umzustellen, gehen Sie wie folgt vor:
Beschaffung eines SSL-Zertifikats für den von Ihnen verwendeten Dashboard-Web-Server-Host (Beispiel my-company.com) von einer Zertifizierungsstelle, die von Browsern als vertrauenswürdig eingestuft wird.
Aktivierung der HTTPS-Bindung für die Default Web-Site mit dem beschafften Zertifikat.
In den SSL-Einstellungen der Webs AppLink und AppLink2 die Option SSL akzeptieren oder SSL erforderlich aktivieren.
Für den XPhone Client: Den Dashboard-URL in der XPhone Server Admiministration unter Benutzerverwaltung > Standort/Konfigurationsgruppe > Connect Client > Dashboard auf AppLink2 setzen.
Internet-Freigabe in Proxy/Firewall#
Einen Zugriff auf die XPhone-Dashboard-Webanwendung aus dem Internet sollten Sie aus Sicherheitsgründen nicht erlauben.
Sicherheitseinstellungen des Internet-Explorers#
Das Fenster in dem ein Dashboard angezeigt wird enthält das Microsoft Webview2-Steuerelement. Der XPhone Connect Server wird als Teil eines URL verwendet, um per HTTP (oder HTTPS) und mit integrierter Windows-Anmeldung auf den Webserver des XPhone Connect Servers zuzugreifen. Das Internet-Explorer-Steuerelement führt eine Zonenprüfung für diese Anfrage durch. Der XPhone Connect Server muss in der Zone der Intranet-Web-Sites liegen, damit der HTTP-Zugriff funktioniert. Diese Zuweisung muss vom Administrator für jeden Arbeitsplatz vorgenommen werden (vorzugsweise per Gruppen-Sicherheitsrichtlinie). Enthält der Servername keine Punkt-Zeichen (nur Hostname statt Fully Qualified Domain Name), wird die Zone im Default der Windows-Internet-Optionen als Intranetzone interpretiert. Diese gehört standardmäßig zu den vertrauenswürdigen Sites. Wenn möglich, sollte demnach die „punktlose“ Notation des Servers verwendet werden. Verhindern die Sicherheits-Policies des Systems den HTTP-Zugriff auf den XPhone Connect Server, so muss der XPhone Connect Server in die Liste der „Intranet-Sites“ aufgenommen werden (Gruppen-Sicherheitsrichtlinie oder manuelle Konfiguration). Erkennbar ist dieser Zustand meist daran, dass trotz aktiviertem Online-Logging keine Log-Schaltfläche im Anzeigebereich des Dashboards sichtbar wird.
Das passende Dashboard anzeigen#
Üblicherweise werden Sie in einem Unternehmen eine Reihe von Dashboards konfigurieren. Ein wichtiger Anwendungsfall sind dabei auch Dashboards, die aktuell in der Entwicklung und noch nicht freigegeben sind. Eine Übersicht, welche Dashboards existieren und welche Auswahlkriterien eingestellt sind, finden Sie, indem Sie den Dialog Priorität öffnen.
Welches Dashboard angezeigt wird hängt von folgenden Kriterien ab: - Priorität der Datenquelle im XPhone Connect Directory, mit der der Kontakt identifiziert wird. Die Priorität entspricht der Sortierung der Datenquellen unter ausgewählte Datenquelle(n). - Dashboard-Priorität. Die Dashboard Priorität können Sie im Menü unter Priorität anpassen - Bedingungen, wann ein Dashboard angezeigt werden soll
Anzeige-Ort (XPhone Client oder Anrufer-Toast)
Client-Sprache
Benutzerdefinierte Bedingungen
Im einfachsten Fall gibt es ein Dashboard pro Datenquelle, das im XPhone Client angezeigt wird und bei dem nicht nach der Anwendersprache unterschieden wird. In diesem Fall ist die Einrichtung „geradeaus“ und weitgehend selbsterklärend. Komplexere Anwendungsfälle werden über die benutzerdefinierten Bedingungen im Reiter Bedingungen eines Dashboards abgedeckt. Sie sollten, soweit möglich, immer eine oder mehrere spezifische Datenquellen angeben. Dies senkt die Fehleranfälligkeit, dass Dashboards in den falschen Situationen erscheinen. Die Option Beliebige Datenquelle sollte also nur dann verwendet werden, wenn die benutzerdefinierten Bedingungen die Dashboard-Verwendung exakt definieren. In den meisten Fällen werden die benutzerdefinierten Bedingungen dazu verwendet, um Dashboards aufgrund der Rollen eines Anwenders im Unternehmen anzuzeigen. Hierzu wird der Kontext des angemeldeten Benutzers in den Filteroperationen geprüft (Zur Erinnerung: Der angemeldete Benutzer wird aufgrund seiner E-Mail-Adresse im XPhone Directory ermittelt). Als Prüfkriterium bietet sich z.B. der Abteilungsname oder eines der benutzerdefinierten Felder an.
Die Operandenprüfung arbeitet nicht case-sensitiv. Werden komplexere Filter benötigt, lassen sich über die Schaltflächen Add group und Add rule auch weitere Bedingungen hinzufügen, die nach den Regeln der bool’schen Algebra und- bzw. oder- verknüpft werden können.
Die Auflistung der zur Auswahl stehenden Kontextvariablen finden Sie unter Variablenbenzeichnungen der Datenfelder.
Ein weiterer Anwendungsfall ist die Anzeige eines Dashboards abhängig von der Rufnummer eines Anrufers. So kann z.B. das Bild einer (geeigneten) Türkamera als iFrame-Element in ein Dashboard eingebettet werden.
Die Filterbedingung dazu könnte so aussehen:
Call.CALLNO ends wtih 777
Die Überprüfung der Operanden wird als nicht-case-sensitiver Textvergleich durchgeführt. Zu beachten ist, dass Rufnummern mit Hilfe von Leerzeichen formatiert sein können. Dies kann einen Vergleich erschweren. Aus diesem Grund sind kurze Fragmente, die auf das Ende der Variablen angewendet werden von Vorteil.
Deaktivieren eines Dashboards#
Deaktivieren Sie ein Dashboard, indem Sie die Option Dashboard aktivieren deselektieren. Veröffentlichen Sie anschließend die Änderung.
Dashboard Priorität anpassen#
Bei der Definition von Bedingungen für die Anzeige eines Dashboards ist es gängige Praxis, Standardfälle zu definieren und von diesen wiederum Ausnahmefälle. Damit die Bedingungen dafür mit möglichst wenigen Operationen formuliert werden können, ist eine Priorisierung möglich. Die Bewertung der Bedingungen für Dashboards wird in der Reihenfolge der Priorität durchgeführt. Sind die Bedingungen erfüllt, wird das entsprechende Dashboard angezeigt und keine weitere Prüfung durchgeführt. Die Dashboards sind ihrer Priorität nach absteigend in der Navigationsleiste sortiert. Die Priorität kann über den Menüpunkt Priorität angepasst werden.
Dashboards, die oben in der Liste stehen, haben die höchste Priorität bei der Bewertung der Bedingungen:
Konfliktwarnung#
Möglicherweise sind mehrere Dashboards für die gleichen Datenquellen und die gleiche Anzeige-Option (XPhone Client oder Anrufer-Toast) konfiguriert. Dies würde bedeuten, dass sich die Dashboard-Anzeige nicht wie gewünscht verhält, da die Prüfung der Bedingungen kein eindeutiges Ergebnis liefert. In diesem Fall wird daher im Reiter Datenquellen unterhalb der Datenquellen-Liste eine Warnmeldung mit Verweis auf den möglichen Konfliktpartner angezeigt. Beispiel:
Die Warnmeldung erscheint auch, wenn die Dashboard-Auswahl über zusätzliche Bedingungen definiert wird und deshalb wie gewünscht funktionieren kann. Die Konfliktprüfung kann die zusätzlichen Bedingungen jedoch nicht bewerten, da dies erst zur Laufzeit mit den realen Laufzeitdaten möglich ist. Die Warnmeldung kann in diesen Fällen ignoriert werden.