Setting the logging of the MiniClient2

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">http>https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...

...
            <setting name="BasePortalURL" serializeAs="String">
                <value>http<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>

...

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

...
            <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="BasePortalURL" type="String">http://test1/CarrierPortal/mclogin/jtel/jtel</value>
...

...
            <setting name="BasePortalURL" serializeAs="String">
                <value>http://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

(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"

de-DE,de

en-GB,en

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

Integer Werte, sinnvoller Bereich ca. 300 to 500.

Der Wert 0 ist ebenfalls möglich.

Legt die Breite des Mini-Clients fest.

Der Wert 0 ermöglicht es dem Client, sich die vorherige Breite bei der letzten Verwendung zu merken. Beim erneuten Öffnen wird die zuvor verwendete Größe wiederhergestellt.

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

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

Hotkey Wählvorbereitung

EinstellungStandardwertErlaubte WerteWirkungOpenOutlookContactPhoneSelectShortcutFalseTrue oder FalseWenn True, wird das Öffnen des Outlookkontakts erlaubt.ExchangeServerUrlUrl des ExchangeServers

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. 

DefaultCountryCode49LänderkennungenStandard Länderkennung für die Kontaktsuche (siehe AlternativeSearchWithoutCountryCode).AlternativeSearchWithoutCountryCodeTrueTrue oder False

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.

OutlookContactsOpenOnlyFirstMachTrueTrue oder FalseTheoretisch könnte ein Kontakt in mehreren Kontaktlisten vorkommen. True bedeutet, dass nur der zuerst gefundene Kontakt geöffnet wird. False, es werden alle Kontakte geöffnet.PhoneNumberType

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

Art der Telefonnummer z.B. "Geschäftlich" oder "Privat". Bleibt dieser Parameter leer ( empfolen ), so werden alle Arten durchsucht. Sie auch https://msdn.microsoft.com/de-de/library/office/ff868508.aspx.PhoneNumberElementID

M:CallNumberForDotNet

Telefonnummer

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

ContactFolderNameName des öffentlichen Kontaktordners

Der Name des öffentlichen Ordners, unter dem die Kontakte hinterlegt sind. Kommasepariert ist auch möglich mehrere Ordner anzugeben. Zum Beispiel:

"DevTestContacts, Unterordner1/DevTestContacts"

Beachte: Befindet sich der Kontaktordner in einem Unterordner, so sieht die Eingabe folgendermaßen aus "UnterordnerName/ContactFolderName".

Win.F2

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

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:

1.  ^.*[InsertedID=](.*[0-9]) Extrahiert aus dem Ausdruck "Test 123  InsertedID=123546" die Ziffernfolge "123456"
2.  (.*) Extrahiert die komplette Zeichenfolge aus dem Feld