Setting the logging of the Mini Client 2

From version 2.7 on, the Nlog is used as default logger. The template file NLog.config can be copied into the root directory of the mini client directory tree and changed if necessary. 

In old releases, the parameter "BrowserLogFile" should be changed.

A path must be entered there. Then insert the following code after </userSettings> and before </configuration>. If necessary, the path of the log file must be adjusted in the initializeData parameter.

...
            <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...

...
            <setting name="BasePortalURL" serializeAs="String">
                <value>https://acd.jtel.de/CarrierPortal/mclogin/</value>
            </setting>
...

		<value name="BrowserUserAgentHeader" type="String">Edge/119.0.0.0</value>

(function ($) {
    console.log("javascript-shortcut-hotkey<{0}>");

    var clickSpecificFunction = function (elemType, elemId) {
        $(elemType).each(function (i, el) {
            var elm = $(el);
            var id = elm.attr('id');
            if (!id) return;
            if (id === elemId) {
                console.log("javascript-shortcut-hotkey - found element " + id);
                elm.click();
                return true;
            }
        });
        return false;
    }

    clickSpecificFunction('a', 'M:acdStatusButton_2');
})(window.ice.ace.jq);

"OK"

...
 
	<system.diagnostics>
		<trace autoflush="true" indentsize="4">
			<listeners>
				<add	name="myListener"
      					type="System.Diagnostics.TextWriterTraceListener"
      					initializeData="c:\tmp\miniclient.log" />
			</listeners>
		</trace>
	</system.diagnostics>

...

Anpinnen

Konfigurationsdatei

Die Einstellungen des Mini-Clients werden in der Datei ACDMiniClient.exe.config vorgenommen. Diese Datei ist im XML Format, eine Beispieleinstellung in der Datei sieht so aus:

...
            <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...

...
            <setting name="BasePortalURL" serializeAs="String">
                <value>https://acd.jtel.de/CarrierPortal/mclogin/</value>
            </setting>
...

Um die jeweilige Einstellung zu verändern, den Wert zwischen <value> und </value> verändern.

Um den Unterschied, zwischen zwei Konfigurationsdateien zu erkennen, nutzt man am besten ein XML Vergleichstool. Online ist eine sehr gute hier zu finden: http://prettydiff.com/ 

Einstellungen

Portal URL

BasePortalURL

URL des Systems.

Format: http(s)://[loadbalancer]:[port]/CarrierPortal/mclogin/[Reseller UID]/[Mandant UID]

Statuswechsel

ID des Buttons der automatisch geklicked werden soll, um den Statuswechsel beim Start des Clients zu vollziehen.

M:acdStatusButton_1 entspricht Abgemeldet

M:acdStatusButton_2 entspricht Anrufe und Medien

M:acdStatusButton_3 entspricht Pause

Beachte: Der Statuswechsel wird dann durchgeführt sobald der entsprechende Button von der Anwendung "gefunden" werden kann. Dies geschieht u. U. auch erst nach Anmeldung mit Benutzernamen und Passwort durch den Benutzer selbst.

ID des Buttons der automatisch geklicked werden soll, um den Statuswechsel beim Schließen der Anwendung zu vollziehen.

M:acdStatusButton_1 entspricht Abgemeldet

M:acdStatusButton_2 entspricht Anrufe und Medien

M:acdStatusButton_3 entspricht Pause

M:acdStatusButton_ gefolgt von der ID des AcdAgentStatus der verwendet werden soll.

ID des Buttons der automatisch geklicked werden soll, um den Statuswechsel bei der Bildschirmsperre zu vollziehen.

M:acdStatusButton_1 entspricht Abgemeldet

M:acdStatusButton_2 entspricht Anrufe und Medien

M:acdStatusButton_3 entspricht Pause

ID des Buttons der automatisch geklicked werden soll, um den Statuswechsel bei der Entsperrung des Bildschirmes zu vollziehen.

M:acdStatusButton_1 entspricht Abgemeldet

M:acdStatusButton_2 entspricht Anrufe und Medien

M:acdStatusButton_3 entspricht Pause

Die ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

Die ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

Die ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

Die ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

ID der Schaltfläche, die automatisch angeklickt wird, um den Status zu ändern, wenn der Bildschirm entsperrt wird.

M:acdStatusButton_1 entspricht Ausgeloggt

M:acdStatusButton_2 entspricht Aufrufe und Medien

M:acdStatusButton_3 entspricht Pause

Pop-ups and events

Layout

Basiseinstellungen

de-DE,de

en-GB,en

fr-FR,fr (Portal Release 3.09 ab 13.09.2017 - derzeit nur in diesen Release verfügbar)

Bitmaske: Kombination von 1 = DisableGpuAcceleration, 2 = SetOffScreenRenderingBestPerformanceArgs, 4 = WindowlessRenderingEnabled

Beispielsweise 3 = DisableGpuAcceleration UND SetOffScreenRenderingBestPerformanceArgs.

Die Einstellungen für die CEFSharp Engine. Manche Einstellungen haben eine Auswirkung, auf die Lauffähigkeit des Clients in Terminal-Server Umgebungen, beispielsweise Citrix.

Folgende Ausschnitte aus der Dokumentation für die CEFSharp Engine kommen zum Tragen:

DisableGpuAcceleration
Setzen Sie das Befehlszeilenargument, um die GPU-Beschleunigung zu deaktivieren, dadurch wird WebGL ausgeschaltet.

SetOffScreenRenderingBestPerformanceArgs
Befehlszeilenargumente für beste OSR (Offscreen und WPF) Rendering-Performance setzen Dies deaktiviert WebGL, schauen Sie sich den Quelltext an, um festzustellen, welche Flags Ihren Anforderungen am besten entsprechen.

 
WindowlessRenderingEnabled 
Setzen Sie diesen Wert auf true (1), um die Unterstützung für fensterloses Rendering (Off-Screen) zu aktivieren. Aktivieren Sie diesen Wert nicht, wenn die Anwendung kein fensterloses Rendering verwendet, da dies die Rendering-Leistung auf einigen Systemen verringern kann.

Ignoriert die Zertifikate beim Verbinden zum Exchange

Der Name des öffentlichen Ordners, unter dem die Kontakte gespeichert sind. Es ist auch möglich, mehrere Ordner durch Komma getrennt einzugeben. Zum Beispiel

"DevTestContacts, Subfolder1/DevTestContacts"

Hinweis: Wenn sich der Kontaktordner in einem Unterordner befindet, sieht der Eintrag wie "SubfolderName/ContactFolderName" aus.

Hotkey Wählvorbereitung

Wert der die Hotkey-Taste definiert, siehe https://msdn.microsoft.com/en-us/library/system.windows.forms.keys(v=vs.110).aspx für erlaubte Werte.

"None" wird genutzt, um keine Modifikation an den Hotkey zu definieren. Beispielsweise, None.F2 entspricht die Funktionstaste F2 alleine.

Die Tastenkombination, um die Hotkey-Funktion zu aktivieren.

Zusatzhotkeys

AdditionalHotkeys1

AdditionalHotkeys2

AdditionalHotkeys3

AdditionalHotkeys4

Wert der die Hotkey-Taste definiert, siehe https://msdn.microsoft.com/en-us/library/system.windows.forms.keys(v=vs.110).aspx für erlaubte Werte.

"None" wird genutzt, um keine Modifikation an den Hotkey zu definieren. Beispielsweise, None.F2 entspricht die Funktionstaste F2 alleine.

Mit diese vier Einstellungen, können bis zu vier weitere Hotkeys definiert werden.

Beispielsweise:

<value name="AdditionalHotkeys1" type="String">None.F8</value>

Hiermit wird ein Hotkey auf F8 registriert.

Wird diese Taste gedrückt, so sucht das System nach eine Javascript Datei im Mini-Client Verzeichnis mit den Namen des Hotkeys + ".js".

Für obige Definition, sucht das System nach der Datei "None.F8.js".

Diese Datei wird dann ausgeführt.

Hier ist eine Beispieldatei, womit man einen Statuswechsel in "Anrufe und Medien" (Status 2) durchführen kann:

(function ($) {
    console.log("javascript-shortcut-hotkey<{0}>");

    var clickSpecificFunction = function (elemType, elemId) {
        $(elemType).each(function (i, el) {
            var elm = $(el);
            var id = elm.attr('id');
            if (!id) return;
            if (id === elemId) {
                console.log("javascript-shortcut-hotkey - found element " + id);
                elm.click();
                return true;
            }
        });
        return false;
    }

    clickSpecificFunction('a', 'M:acdStatusButton_2');
})(window.ice.ace.jq);

"OK"

CRM URL

Eine Liste der erlaubten Protokollhandler, die vom Mini-Client verarbeitet werden.

Links im Mini-Client, die z.B. durch die CRM-URL bereitgestellt werden, werden mit dem Standard-Protokollhandler auf dem Client-Rechner geöffnet, wenn sie in dieser Liste angegeben sind. 

Wenn Ihr CRM-System z.B. URLs des Typs mycrm://xxx unterstützt, dann wird der Mini-Client, indem mycrm als eines der erlaubten Protokolle konfiguriert wird, lokal den Protokoll-Handler für die mycrm-URL aufrufen. Protokolle, die hier nicht angegeben sind, werden, mit Ausnahme des mailto-Protokolls, nicht geöffnet. 

Automatischer Workstation Login

Automatischer .EXE Aufruf

AutomaticEXECall

AutomaticEXECallCommand

AutomaticEXECallParameters

Parameter, die zu .EXE Datei übergeben werden.
Erlaubte Variablen:

Outlook Integration

Die Url des ExchangeServers.

Beachte: Der User muss sich beim ExchangeServer mit der Domainkennung anmelden können, da keine Anmeldedaten ( Username, Password ) eingegeben werden. Vor der ersten Anmeldung sollte überprüft werden, ob der User ein OWA zugriff hat, eventull müssen Zertifikate installiert werden. Wichtig: Anmeldung an OWA mit dem IE. 

Wenn True und falls kein Kontakt gefunden wurde, wird ein Kontakt ohne Länderkennung (siehe Parameter DefaultCountryCode )  durchsucht.

Hitergrund: 

1. Standardmäßig speichrt Outlook die Nummern mit der Länderkennung und einem Leerzeichen
   ( +49 891235689 ).
2. Unter besbestimmten Einstellung ist es möglich eine Nummer ohne Länderkennung einzugeben
   ( 0891235689 ). Diese sollen gegenfalls auch gefunden wurden.

Old Settings

The following settings are no longer supported as of Mini Client 2.

Setting the logging of the Mini Client 2

From version 2.7 on, the Nlog is used as default logger. The template file NLog.config can be copied into the root directory of the mini client directory tree and changed if necessary. The folder config.examples contains the File NLog.config. 

Step by Step:

• Navigate to Mini Client root directory (the .exe File "AcdMiniClient.exe" is here
• Navigate to "conf.examples"
• Copy "Nlog.conf"
• Navigate to Mini Client root directory
• Paste "NLog.conf"
• Restart Mini Client - Logging will be active

Location of Logfile - Mini Client V3.12 and below

The logfile can be found the folder \log\ in the mini client install directory. Example:

C:\jtelMiniClientV3\log\mc.log

Location of Logfile - Mini Client V3.12 and higher

From Mini Client V3.12 the logfile is written into a subdirectory of AppData in Windows. Example:

C:\Benutzer\MaxMustermann\AppData\Local\Temp\jtel\mc.log

AssistantTelephoneNumber, BusinessTelephonNumber, Business2TelephonNumber, BusinessFaxNumber, CallbackTelephoneNumber, CarTelephoneNumber, CompanyMainTelephoneNumber, HomeTelephoneNumber, Home2TelephoneNumber,HomeFaxNumber, ISDNNumber, MobileTelephoneNumber, OtherTelephoneNumber, OtherFaxNumber, PagerNumber, PrimaryTelephoneNumber, RadioTelephoneNumber, TelexNumber, TTYTDDTelephoneNumber,

Alte Einstellungen

Folgende Einstellungen werden ab Mini Client 2 nicht mehr unterstützt.

Einstellung des Loggings des Mini Client 2

Ab Version 2.7 wird das Nlog als Standardlogger verwendet. Die Vorlagendatei NLog.config kann in das Stammverzeichnis des Miniclient-Verzeichnisbaums kopiert und bei Bedarf geändert werden. 

In alten Releases sollte der Parameter BrowserLogFile geändert werden.

Dort muss ein Pfad eingetragen werden. Anschließend den folgenden Code nach  </userSettings> und vor </configuration> einfügen. ggf. muss der Pfad der Log-Datei bei dem Parameter initializeData angepasst werden.

...
            <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...

...
           

...
 
	<system.diagnostics>
		<trace autoflush="true" indentsize="4">
			<listeners>
				<add	name="myListener"
      					type="System.Diagnostics.TextWriterTraceListener"
      					initializeData="c:\tmp\miniclient.log" />
			</listeners>
		</trace>
	</system.diagnostics>

...

Pinup

Fichier de configuration

Les réglages du mini-client sont effectués dans le fichier ACDMiniClient.xml. Ce fichier est au format XML, un exemple de paramétrage dans le fichier ressemble à ceci:

... <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value> ...

... <setting name="BasePortalURL" serializeAs="String">
                <value>https://acd.jtel.de/CarrierPortal/mclogin/</value>
            </setting> 
...

Pour modifier le paramètre correspondant, changez la valeur entre <valeur> et </valeur>.

Um die jeweilige Einstellung zu verändern, den Wert zwischen <value> und </value> verändern.

Um den Unterschied, zwischen zwei Konfigurationsdateien zu erkennen, nutzt man am besten ein XML Vergleichstool. Online ist eine sehr gute hier zu finden: Pour voir la différence entre deux fichiers de configuration, il est préférable d'utiliser un outil de comparaison XML. Vous pouvez en trouver un très bon en ligne ici : http://prettydiff.com/ 

Einstellungen

		<value name="BrowserUserAgentHeader" type="String">Edge/119.0.0.0</value>

(function ($) {
    console.log("javascript-shortcut-hotkey<{0}>");

    var clickSpecificFunction = function (elemType, elemId) {
        $(elemType).each(function (i, el) {
            var elm = $(el);
            var id = elm.attr('id');
            if (!id) return;
            if (id === elemId) {
                console.log("javascript-shortcut-hotkey - found element " + id);
                elm.click();
                return true;
            }
        });
        return false;
    }

    clickSpecificFunction('a', 'M:acdStatusButton_2');
})(window.ice.ace.jq);

"OK"

Intégration de Outlook

L'URL du ExchangeServer.

Note: L'utilisateur doit pouvoir se connecter au serveur Exchange avec le nom de domaine, car aucune donnée de connexion (nom d'utilisateur, mot de passe) n'est saisie. Avant la première connexion, il convient de vérifier si l'utilisateur a un accès OWA, il se peut que des certificats doivent être installés.

Important: Connectez-vous à OWA avec IE. 

Si Vrai et si aucun contact n'a été trouvé, un contact sans code de pays (voir le paramètre DefaultCountryCode ) est recherché.

Contexte:

1. Par défaut, Outlook stocke les numéros avec le code du pays et un espace
   ( +49 891235689 ).
2. Dans certains cas, il est possible de saisir un numéro sans code pays
   ( 0891235689 ). Il faut également les trouver si nécessaire.

AssistantTelephoneNumber, BusinessTelephoneNumber, Business2TelephoneNumber, BusinessFaxNumber, CallbackTelephoneNumber, CarTelephoneNumber, CompanyMainTelephoneNumber, HomeTelephoneNumber, Home2TelephoneNumber,HomeFaxNumber, ISDNNumber, MobileTelephoneNumber, OtherTelephoneNumber, OtherFaxNumber, PagerNumber, PrimaryTelephoneNumber, RadioTelephoneNumber, TelexNumber, TTYTDDTelephoneNumber,

Automatischer Workstation Login

Ein zusätzlicher Parameter in der Konfigurationsdatei - UseWindowsPipes - wurde eingeführt, um die Verwendung der Kommandozeilen-Wählfunktionalität in einer Terminalserverumgebung zu ermöglichen:

AcdMiniClient.exe --dial

Automatischer .EXE Aufruf

AutomaticEXECall

AutomaticEXECallCommand

AutomaticEXECallParameters

Parameter, die zu .EXE Datei übergeben werden.
Erlaubte Variablen:

Outlook Integration

Der Name des öffentlichen Ordners, unter dem die Kontakte gespeichert sind. Es ist auch möglich, mehrere Ordner durch Komma getrennt einzugeben. Zum Beispiel

"DevTestContacts, Subfolder1/DevTestContacts"

Hinweis: Wenn sich der Kontaktordner in einem Unterordner befindet, sieht der Eintrag wie "SubfolderName/ContactFolderName" aus.

Die Url des ExchangeServers.

Beachte: Der User muss sich beim ExchangeServer mit der Domainkennung anmelden können, da keine Anmeldedaten ( Username, Password ) eingegeben werden. Vor der ersten Anmeldung sollte überprüft werden, ob der User ein OWA zugriff hat, eventull müssen Zertifikate installiert werden. Wichtig: Anmeldung an OWA mit dem IE. 

Wenn True und falls kein Kontakt gefunden wurde, wird ein Kontakt ohne Länderkennung (siehe Parameter DefaultCountryCode )  durchsucht.

Hitergrund: 

1. Standardmäßig speichrt Outlook die Nummern mit der Länderkennung und einem Leerzeichen
   ( +49 891235689 ).
2. Unter besbestimmten Einstellung ist es möglich eine Nummer ohne Länderkennung einzugeben
   ( 0891235689 ). Diese sollen gegenfalls auch gefunden wurden.

AssistantTelephoneNumber, BusinessTelephonNumber, Business2TelephonNumber, BusinessFaxNumber, CallbackTelephoneNumber, CarTelephoneNumber, CompanyMainTelephoneNumber, HomeTelephoneNumber, Home2TelephoneNumber,HomeFaxNumber, ISDNNumber, MobileTelephoneNumber, OtherTelephoneNumber, OtherFaxNumber, PagerNumber, PrimaryTelephoneNumber, RadioTelephoneNumber, TelexNumber, TTYTDDTelephoneNumber,

M:CallNumberForDotNet

Aus diesem Feld wird die Telefonnummer heraus gelesen, um folgend den Kontakt im Outlook zu öffnen.

M:CallNumberForDotNet - Nutzt die Servicerufnummer für den Popup

M:ANumberForDotNet - Nutzt die Nummer des Anrufers für den Popup

Protokoll-Handler

Register

Unregister (oder leer)

Registriert den Miniclient als Handler für beispielsweise den "tel:" URI-Schema (RFC5341).

Wenn Sie in einem externen Browser auf einen Link wie <a href=tel:01234567890>01234 567 890</a> klicken, wird der Miniclient vom Betriebssystem geöffnet und führt einen Anruf an diese Nummer aus.

Protokoll. Zum Beispiel:

tel

oder

callto

Das Protokoll für die der Miniclient als Protokoll-Handler registriert werden soll. 

Zustatzinformation in Datei Speichern

Speicherung von Information in eine Datei. True Aktiviert die Speicherung.

Hier wird eine kommaseparierte Liste der ID's der Elemente eingegeben.

z.B. M:AcdAgentCallInfo,M:GroupNameForDotNet,M:CallNumberForDotNet

Kommaseparierte Liste von Regulären Ausdrücken ( regular expressions ). Vorschrift mit der die Informationen aus den Feldern, die unter AdditionalInfoElementIDs eingegeben wurden, extrahiert werden.

Beispiele

M:CallNumberForDotNet

Le numéro de téléphone est lu à partir de ce champ pour ouvrir le contact dans Outlook.

M:CallNumberForDotNet - Utilise le numéro de service pour le popup

M:ANumberForDotNet - Utilise le numéro de l'appelant pour le popup

Enregistrer des informations supplémentaires dans le dossier

Enregistrez le Mini-client comme gestionnaire du 'tel:' protocole du schéma URI pour les navigateurs externes (RFC5341). Lorsque vous cliquez sur un lien tel que <a href=tel:01234567890>01234 567 890</a> dans un navigateur externe, le Miniclient sera ouvert par le système d'exploitation et effectuera un appel vers ce numéro.

La liste des gestionnaires d'URI pour lesquels le Miniclient sera enregistré comme gestionnaire de protocole.

Par exemple, l'obsolète 'callto:' peut être enregistré en plus.

Enregistrer des informations supplémentaires dans le dossier

Stockage des informations dans un fichier. Vrai Active le stockage.

Une liste séparée par des virgules des ID des éléments est saisie ici.

par exemple M:AcdAgentCallInfo,M:GroupNameForDotNet,M:CallNumberForDotNet

Une liste d'expressions régulières séparées par des virgules. Règle avec laquelle les informations sont extraites des champs qui ont été saisis sous AdditionalInfoElementIDs.

:

1.  ^.*[InsertedID=](.*[0-9])

1.  Extrahiert aus dem Ausdruck "Test 123  InsertedID=123546" die Ziffernfolge "123456"
2.  (.*)