Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
...   <system.diagnostics> <trace autoflush="true" indentsize="4"> <listeners> <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="c:\tmp\miniclient.log" /> </listeners> </trace> </system.diagnostics> ...

 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
Sv translation
languageen


Warning

Default values may vary, depending on the version that's downloaded


Pinup

Note
titlePin up

The mini client can only be pinned on the main screen.

Configuration File

Note
titleConfiguration file

Please note that since version 2.7 all parameters have been moved to the file conf/ACDMiniclient.xml. The ACDMiniClient.exe.config file now contains only the settings specific to the .NET platform. The names of the parameters have not been changed.

The settings of the mini client are made in the file ACDMiniClient.xml. This file is in XML format, a sample setting in the file looks like this:

Translations Ignore


Code Block
titleACDMiniClient.exe.config - Example setting from version 2.27
...
            <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...



Translations Ignore


Code Block
titleACDMiniClient.exe.config - Example setting before version 2.27
...
            <setting name="BasePortalURL" serializeAs="String">
                <value>https://acd.jtel.de/CarrierPortal/mclogin/</value>
            </setting>
...




To change the respective setting, change the value between <value> and </value>.

To see the difference between two configuration files, it is best to use an XML comparison tool. Online you can find a very good one here: http://prettydiff.com/ 

Settings

Portal URL

SettingDefault valueAllowed valuesEffect

BasePortalURL

https://localhost/CarrierPortal/mclogin/

URL of the system.

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

Set to the system you want to log on to - replace localhost with corresponding server name or IP address (and add :8080 as port if necessary).

Status Change

SettingDefault valueAllowed valuesEffect
StatusChangeOnStartClientFalseTrue or FalseWhen the client is started, whether a status change of the agent should be performed.
StatusChangeOnStartClientElementIDM:acdStatusButton_2M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button which is to be clicked automatically to perform the status change when the client starts.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

Note: The status change is performed as soon as the corresponding button can be "found" by the application. This may also only happen after the user himself has logged in with his user name and password.

StatusChangeOnCloseClientFalseTrue or FalseWhen the mini client is closed, whether a status change of the agent should be performed.
StatusChangeOnCloseClientElementIDM:acdStatusButton_1M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when closing the application.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnCloseClientWait3000Integer values, sensible range approx. 1000 to 10000.When exiting the application, some time must pass so that the automatic click of the button for the status change is also transmitted from the browser to the server. This parameter defines how long to wait before closing the application. Note: if the mini client has NO connection to the web server, there will be no logoff!
StatusChangeOnLockScreenFalseTrue or FalseWhen the screen on the client PC is locked, whether a status change of the agent should be performed.
StatusChangeOnLockScreenElementIDM:acdStatusButton_3

M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to perform the status change on screen lock.

M:acdStatusButton_1 corresponds to Logged out

 M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnUnlockScreenFalseTrue or FalseWhen the screen on the client PC is unlocked, whether a status change of the agent should be performed.
StatusChangeOnUnlockScreenElementIDM:acdStatusButton_2M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnRemoteConnectFalseTrue or FalseWhen a connection to the computer via remote happens, whether a status change of the agent should be performed.
StatusChangeOnRemoteConnectElementIDM:acdStatusButton_2M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnRemoteDisconnectFalseTrue or FalseWhen a connection to the computer via remote is closed, whether a status change of the agent should be performed.
StatusChangeOnRemoteDisconnectElementIDM:acdStatusButton_3M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnConsoleConnectFalseTrue or FalseWhen a connect via console happens, whether a status change of the agent should be performed.
StatusChangeOnConsoleConnectElementIDM:acdStatusButton_2M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnConsoleDisconnectFalseTrue or FalseWhen a disconnect via console happens, whether a status change of the agent should be performed.
StatusChangeOnConsoleDisconnectElementIDM:acdStatusButton_3M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnPowerModeSuspendFalseTrue or FalseWhen the, for example, laptop lid is closed, whether a status change of the agent should be performed.
StatusChangeOnPowerModeSuspendElementIDM:acdStatusButton_3M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

The ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

StatusChangeOnPowerModeResumeFalseTrue or FalseWhen the, for example, laptop lid is opened again, whether a status change of the agent should be performed.
StatusChangeOnPowerModeResumeElementIDM:acdStatusButton_2M:acdStatusButton_ followed by the ID of the AcdAgentStatus to be used

ID of the button to be clicked automatically to change the status when the screen is unlocked.

M:acdStatusButton_1 corresponds to Logged out

M:acdStatusButton_2 corresponds to calls and media

M:acdStatusButton_3 corresponds to pause

Pop-ups and events

SettingDefault valueAllowed valuesEffect
IncomingCallPopupFalseTrue or FalseIf True, a small popup window ("Toaster") is displayed when a call is received.
IncomingCallPopupDuration5IntegerDisplay duration in seconds of the call popup
IncomingEventPopupFalseTrue or FalseIf True, a small pop-up window ("Toaster") is displayed when a media event is received.
IncomingEventPopupDuration5IntegerDisplay duration in seconds of the event popup

Layout

SettingDefault valueAllowed valuesEffect
MinimizeOnlyInTrayTrueTrue or FalseIf True, the application disappears as an icon in the system tray (next to the clock) when minimized. If False, the application continues to be displayed as a window in the taskbar.
OpenWithExternalProgramExtentions.pdf,.eml,.xls,.csv,.xlsx.pdf,.eml,.xls,.csv,.xlsxThis parameter is required so that the reports can be opened in the miniClient.

Basic settings

SettingDefault valueAllowed valuesEffect
AcceptLanguagede-DE,de (oder leer)

de-DE,de

en-GB,en

fr-FR,fr (Portal Release 3.09 from 13.09.2017 - currently only available in this release)

The preferred language for the client.
PanelWidth400Integer values, sensible range approx. 300 to 500.Sets the width of the mini Client.
DefaultCountryCode49Country codesDefault country code for the contact search (see AlternativeSearchWithoutCountryCode)
PhoneSelectCountryCode 49Country code.The country code for the hotkey function when a phone number is dialled with 0.
PhoneNumberClipboardDelay50IntegerNumber of milliseconds the mini Client .EXE waits to grab the clipboard after Ctrl+C is sent to the active application
DisableCookieLoginFalseTrue oder FalseAllows the login with cookie.
BrowserCacheDirincognitoincognito or file pathSave browser cache. In incognito mode everything is in memory.
DisableSpellCheckTrueTrue or FalseIf True, the spell checker is turned off in the client. Otherwise, spell checking is active, using the language specified in the AcceptLanguage configuration setting.
CEFSettings0

Bitmask: combination of 1 = DisableGpuAcceleration, 2 = SetOffScreenRenderingBestPerformanceArgs, 4 = WindowlessRenderingEnabled

For example 3 = DisableGpuAcceleration AND SetOffScreenRenderingBestPerformanceArgs.

The settings for the CEFSharp Engine. Some settings have an effect on the client's ability to run in terminal server environments, for example, Citrix.

The following excerpts from the documentation for the CEFSharp Engine come into play:

DisableGpuAcceleration
Set command-line argument to disable GPU Acceleration, this will disable WebGL.

SetOffScreenRenderingBestPerformanceArgs
Set command-line arguments for best OSR (Offscreen and WPF) Rendering performance This will disable WebGL, look at the source to determine which of the flags best suite your requirements.

 
WindowlessRenderingEnabled 
Set to true (1) to enable windowless (off-screen) rendering support. Do not enable this value if the application does not use windowless rendering as it may reduce rendering performance on some systems.

IgnoreCertificateErrorsTrueTrue or False

Ignores the certificates when connecting to the Exchange.

BrowserLogFile
Path of the log fileFile for the error log of the browser.
ContactFolderName
Name of the public contact folder

The name of the public folder under which the contacts are stored. It is also possible to enter several folders separated by commas. For example:

"DevTestContacts, Subfolder1/DevTestContacts"

Note: If the contact folder is located in a subfolder, the entry looks like "SubfolderName/ContactFolderName".

Hotkey Dial Preparation

SettingDefault valueAllowed valuesEffect
PhoneSelectShortcutWin.F2

Value that defines the hotkey, see https://msdn.microsoft.com/en-us/library/system.windows.forms.keys(v=vs.110).aspx for allowed values

"None" is used to define no modification to the hotkey. For example, None.F2 corresponds to the function of key F2 alone.

The key combination to activate the hotkey function.

Additional hot keys

SettingDefault valueAllowed valuesEffect

AdditionalHotkeys1

AdditionalHotkeys2

AdditionalHotkeys3

AdditionalHotkeys4


Value that defines the hotkey, see https://msdn.microsoft.com/en-us/library/system.windows.forms.keys(v=vs.110).aspx for allowed values

"None" is used to define no modification to the hotkey. For example, None.F2 corresponds to the function of key F2 alone.

With these four settings, up to four additional hotkeys can be defined.

For example:

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

This registers a hotkey on F8.

When this button is pressed, the system searches for a Javascript file in the mini client directory with the name of the hotkey + ".js".

For the above definition, the system looks for the file "None.F8.js".

This file is then executed.


Here is an example file with which you can perform a status change to "Calls and Media" (status 2):

(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

SettingDefault valueAllowed valuesEffect
OpenPopupURLInExternalBrowserTrueTrue oder FalseOpen the CRM link in the standard external browser.
ProtocolHandlersmailtoAny comma-separated string of protocols. For example mail,myprotohandler

A list of allowed protocol handers which will be processed by the mini client.

Links in the mini client which are provided by the CRM URL, for example, will be opened using the standard protocol handler on the client machine if they are specified in this list. 


For example, if your CRM system supports URLs of the type mycrm://xxx then by specifying mycrm as one of the allowed protocols, the mini client will locally call the protocol handler for the mycrm URL. Protocols which are not specified here, apart from the mailto protocol, will not be opened. 

AutomaticallyOpenCRMUrlFalseTrue or FalseIf True, the CRM Url is automatically opened in the default browser.
AutomaticRESTCRMUrlFalseTrue or FalseIf True, instead of opening the CRM URL in the browser window, a REST call is made by GET on the URL. See also CurlRESTCommand.
CurlRESTCommandcygwin\curl.exe -m 3 -k -L --silent -i -X GET --header "Connection: Close" "$crmurl"curl call including parameters. $crmurl specifies the CRM URL.String, for the CURL call, if the CRM URL should be opened via REST.

Automatic Workstation Login

SettingDefault valueAllowed valuesEffect
AutomaticWorkstationLoginFalseTrue or FalseIf True, the computer name, IP address and client and current user name are transmitted to the webserver. If a matching entry is found in the Workstations table and the specified user name is configured as Windows Login Name in the Users table, the user is automatically logged in. If the option StatusChangeOnStartClient is additionally configured, the user is logged on to the phone number assigned in the Workstations table.
UseRemoteWorkstationNameFalseTrue or FalseIf True, if the mini client is running in an RDP or Citrix session, instead of the Workstation Name the Remote Client Name is used for login in combination with the option AutomaticWorkstationLogin.

Automatic .EXE call

SettingDefault valueAllowed valuesEffect

AutomaticEXECall

FalseTrue or FalseIf true, then by the following parameters an installed .EXE is run when a call is incoming.

AutomaticEXECallCommand


Path to the .EXE file on the local computer.Here you enter the path to the .EXE file. This can either be relative (to AcdMiniClient.exe) or absolute including drive and path. UNC paths are supported.

AutomaticEXECallParameters


Anything.

Parameters that are passed to the .EXE file.
Allowed variables:

ParameterMeaning
$ANumberThe A-participant's telephone number.

$CRMLink

The CRM link from the ACD configuration.
$ServiceNumberThe called service number.
$ServiceNameName of the called service number.
$CallIDThe jtel internal call ID (StatisticsPartA.ID)
$UsersUIDThe ID of the user (agent) who is logged into the mini client.
$UsersEMailThe email of the user (agent) who is logged into the mini client.
$DateTimeUTCThe current UTC date and time in the following format: yyyy-MM-ddThh:mm:ssZ
$DateTimeLocalThe current local date and time in the following format: yyyy-MM-ddThh:mm:ss


AutomaticEXECallHiddenFalseTrue or FalseIf true, then the EXE called will be created with a hidden window so it is not seen by the agent.
AutomaticEXECallWaitAndLogFalseTrue or FalseIf true, then the EXE called will be waited on by the mini client (using a separate thread) and any output from the EXE to the standard output or error streams will be logged to the mini client log file.
AutomaticEXECallTimeout30000Any integer value from 0 to the maximum size of a 32 bit signed integer.This defines the number of milliseconds the mini client waits for the call to the executable to complete before writing the log to the log file, and optionally killing the process (see next setting).
AutomaticEXECallKillAfterTimeoutFalseTrue or FalseIf true, the mini client kills the called EXE file if the timeout is reached.

Miniclient as Protocol Handler

SettingDefault valueAllowed valuesEffect
RegisterURLHandler

Register
Unregister (or empty)

Register theMiniclient as a handler of the specified URI schema protocol for external browsers (RFC5341).

When clicking on a link like <a href="tel:01234567890">01234 567 890</a> in an external browser, the Miniclient will be opened by the operation system and will make a call to this number.


RegisterURLHandlerProtocol

Protocol. For example:

tel

or

callto

The protocol handler for which the Miniclient will be registered.

Outlook Integration

SettingDefault valueAllowed valuesEffect
OpenOutlookContactFalseTrue or FalseIf True, opening the Outlook contact is allowed.
ExchangeServerUrl
Url of the ExchangeServer

The URL of the exchange server.

Note: The user must be able to log on to the Exchange server with the domain name, as no login data ( Username, Password ) are entered. Before the first logon, it should be checked if the user has OWA access, certificates may have to be installed.

Important: Login to OWA with IE. 

AlternativeSearchWithoutCountryCodeTrueTrue or False

If True and if no contact was found, a contact without country code (see parameter DefaultCountryCode ) is searched.

Background:

  1. By default, Outlook stores the numbers with the country code and a space
    ( +49 891235689 ).
  2. Under certain settings, it is possible to enter a number without country code
    ( 0891235689 ). These should also be found if necessary.
OutlookContactsOpenOnlyFirstMachTrueTrue or FalseTheoretically, one contact could appear in several contact lists. True means that only the contact found first will be opened. False, all contacts are opened.
PhoneNumberType

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


Type of telephone number e.g. "Business" or "Private". If this parameter remains empty ( recommended ), all types are searched. Also, see https://msdn.microsoft.com/de-de/library/office/ff868508.aspx.
PhoneNumberElementID

M:CallNumberForDotNet

Phone number

The phone number is read from this field to open the contact in Outlook.

M:CallNumberForDotNet - Uses the service number for the popup

M:ANumberForDotNet - Uses the caller's number for the popup

Save additional information to file

SettingDefault valueAllowed valuesEffect
SaveAdditionalInfoFalseTrue or False

Storage of information into a file. True Activates the storage.

FilePathForSavingAdditionalInfo

The storage location of the file.
AdditionalInfoElementIDs

A comma separated list of the ID's of the elements is entered here.

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

RegExprForSavingAdditionalInfo

A comma-separated list of regular expressions. Rule with which the information is extracted from the fields that were entered under AdditionalInfoElementIDs.

Examples:

  1.  ^.*[InsertedID=](.*[0-9]) Extracts the sequence of digits "123456" from the expression "Test 123 InsertedID=123546
     (.*) Extracts the complete character string from the tile

Old Settings

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

SettingDefault valueAllowed valuesEffect

Zoom

100Percentage values, also > 100 allowed.

Sets the zoom factor of the embedded browser (same function as zoom in the browser itself)

This setting does not exist in miniClient2. With the key combination CTRL + or CTRL - each agent can set the desired zoom for itself. (Or CTRL *Mouse wheel down/*up)

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.

Translations Ignore
Code Block
titleACDMiniClient.exe.config - Example setting
Sv translation
languagede

Anpinnen

Note
titleAnpinnen

Der Mini-Client kann nur auf dem Hauptbildschirm angepinnt werden.

Konfigurationsdatei

Note
titleKonfigurationsdatei

Bitte beachten Sie, dass ab Version 2.7 alle Parameter in die Datei conf/ACDMiniclient.xml verschoben wurden. Die Datei ACDMiniClient.exe.config enthält jetzt nur die für die .NET-Plattform spezifischen Einstellungen. Die Namen der Parameter wurden nicht geändert.

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:

Translations Ignore


Code Block
titleACDMiniClient.exe.config - Beispieleinstellung ab Version 2.27
...
            <value name="BasePortalURL" type="String">https://test1/CarrierPortal/mclogin/jtel/jtel</value>
...



Translations Ignore


Code Block
titleACDMiniClient.exe.config - Beispieleinstellung vor Version 2.27
...
            <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

EinstellungStandardwertErlaubte WerteWirkung

BasePortalURL

https://localhost/CarrierPortal/mclogin/

URL des Systems.

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

Einstellen auf das System auf den man sich anmelden möchte - localhost mit entsprechender Server-Namen oder IP-Adresse ersetzen (und ggf. :8080 für Port hinzufügen).

Statuswechsel

EinstellungStandardwertErlaubte WerteWirkung
StatusChangeOnStartClientFalseTrue oder FalseWenn der Client gestartet wird, ob ein Statuswechsel des Agenten durchgeführt werden soll.
StatusChangeOnStartClientElementIDM:acdStatusButton_2M:acdStatusButton_ gefolgt von der ID des AcdAgentStatus der verwendet werden soll.

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.

StatusChangeOnCloseClientFalseTrue oder FalseWenn der Mini-Client geschlossen wird, ob ein Statuswechsel des Agenten durchgeführt werden soll.
StatusChangeOnCloseClientElementIDM:acdStatusButton_1M:acdStatusButton_ gefolgt von der ID des AcdAgentStatus der verwendet werden soll.

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

StatusChangeOnCloseClientWait3000Integerwerte, sinnvoller Range ca. 1000 bis 10000.Beim Beenden der Anwendung, muss etwas Zeit verstreichen damit das automatische Klicken des Buttons für den Statuswechsel auch vom Browser an den Server übermittelt wird. Dieser Parameter definiert wie lange gewartet wird, bevor die Anwendung geschlossen wird. Beachte: wenn der Mini-Client KEINE Verbindung zum Webserver hat, erfolgt auch keine Abmeldung!
StatusChangeOnLockScreenTrueTrue oder FalseWenn der Bildschirm am Client-PC gesperrt wird, ob ein Statuswechsel des Agenten durchgeführt werden soll.
StatusChangeOnLockScreenElementIDM:acdStatusButton_3

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

StatusChangeOnUnlockScreenTrueTrue oder FalseWenn der Bildschirm am Client-PC entsperrt wird, ob ein Statuswechsel des Agenten durchgeführt werden soll.
StatusChangeOnUnlockScreenElementIDM:acdStatusButton_2M:acdStatusButton_ gefolgt von der ID des AcdAgentStatus der verwendet werden soll.

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

StatusChangeOnRemoteConnectFalseTrue or FalseWenn eine Verbindung zum Computer per Fernzugriff erfolgt, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnRemoteConnectElementIDM:acdStatusButton_2M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

StatusChangeOnRemoteDisconnectFalseTrue or FalseWenn eine Verbindung zum Computer per Fernzugriff geschlossen wird, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnRemoteDisconnectElementIDM:acdStatusButton_3M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

StatusChangeOnConsoleConnectFalseTrue or FalseWenn eine Verbindung über die Konsole erfolgt, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnConsoleConnectElementIDM:acdStatusButton_2M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

StatusChangeOnConsoleDisconnectFalseTrue or FalseWenn eine Verbindungsunterbrechung über die Konsole erfolgt, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnConsoleDisconnectElementIDM:acdStatusButton_3M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

StatusChangeOnPowerModeSuspendFalseTrue or FalseWenn z.B. der Laptop-Deckel geschlossen ist, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnPowerModeSuspendElementIDM:acdStatusButton_3M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

StatusChangeOnPowerModeResumeFalseTrue or FalseWenn z.B. der Laptop-Deckel wieder geöffnet wird, ob eine Statusänderung des Agenten durchgeführt werden soll.
StatusChangeOnPowerModeResumeElementIDM:acdStatusButton_2M:acdStatusButton_ gefolgt von der ID des zu verwendenden AcdAgentStatus

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

EinstellungStandardwertErlaubte WerteWirkung
IncomingCallPopupFalseTrue or FalseWenn True, wird ein kleines Popup-Fenster ("Toaster") angezeigt, wenn ein Anruf eingeht.
IncomingCallPopupDuration5IntegerAnzeigedauer des Anruf-Popups in Sekunden
IncomingEventPopupFalseTrue or FalseWenn True, wird ein kleines Popup-Fenster ("Toaster") angezeigt, wenn ein Medienereignis empfangen wird.
IncomingEventPopupDuration5IntegerAnzeigedauer des Ereignis-Popups in Sekunden

Layout

EinstellungStandardwertAllowed valuesEffect
MinimizeOnlyInTrayTrueTrue or FalseWenn True, verschwindet die Anwendung beim Minimieren als Symbol in der Taskleiste (neben der Uhr). Wenn False, wird die Anwendung weiterhin als Fenster in der Taskleiste angezeigt.
OpenWithExternalProgramExtentions.pdf,.eml,.xls,.csv,.xlsx.pdf,.eml,.xls,.csv,.xlsxDieser Parameter wird benötigt, damit die Reports im miniClient geöffnet werden können.

Basiseinstellungen

EinstellungStandardwertErlaubte WerteWirkung
AcceptLanguagede-DE,de (oder leer)

de-DE,de

en-GB,en

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

Die bevorzugte Sprache für den Client.
PanelWidth400Integer Werte, sinnvoller Bereich ca. 300 to 500.Legt die Breite des Mini-Clients fest.
DefaultCountryCode49LändervorwahlenStandard-Ländervorwahl für die Kontaktsuche (siehe AlternativeSearchWithoutCountryCode)
PhoneSelectCountryCode 49Ländervorwahl.Die Ländervorwahl für die Hotkey-Funktion, wenn eine Telefonnummer mit 0 gewählt wird.
PhoneNumberClipboardDelay50IntegerAnzahl von Millisekunden, die der Mini-Client .EXE wartet, um die Zwischenablage zu greifen, nachdem Strg+C an die aktive Anwendung gesendet wurde
DisableCookieLoginFalseTrue oder FalseErlaubt die Anmeldung mit Cookie.
BrowserCacheDirincognitoincognito oder DateipfadSpeichern von Browsercache. Im Incognito Modus befindet sich alles im Speicher.
DisableSpellCheckTrueTrue oder FalseWenn True, wird die Rechtschreibprüfung im Client ausgeschaltet. Ansonsten ist die Rechtschreibprüfung aktiv, und zwar mit der Sprache laut Konfigurationseinstellung AcceptLanguage.
CEFSettings0

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.

IgnoreCertificateErrorsTrueTrue oder False

Ignoriert die Zertifikate beim Verbinden zum Exchange

BrowserLogFile
Pfad der Log-DateiDatei für den Fehlerlog des Browsers.
ContactFolderName
Name des öffentlichen Kontaktordners

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

EinstellungStandardwertErlaubte WerteWirkung
PhoneSelectShortcutWin.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

EinstellungStandardwertErlaubte WerteWirkung

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

EinstellungStandardwertErlaubte WerteWirkung
OpenPopupURLInExternalBrowserTrueTrue oder FalseÖffnen des CRM-Links im externem Standartbrowser.
ProtocolHandlersmailtoBeliebige durch Komma getrennte Zeichenfolge von Protokollen. Zum Beispiel: mail,myprotohandler

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. 

AutomaticallyOpenCRMUrlFalseTrue oder FalseWenn True, so wird die CRM Url automatisch im Standardbrowser geöffnet.
AutomaticRESTCRMUrlFalseTrue oder FalseWenn True, wird anstatt die CRM URL im Browser Fenster zu öffnen, ein REST Aufruf per GET auf die URL durchgeführt. Siehe auch CurlRESTCommand.
CurlRESTCommandcygwin\curl.exe -m 3 -k -L --silent -i -X GET --header "Connection: Close" "$crmurl"curl Aufruf inkl. Parameter. $crmurl gibt die CRM URL an.String, für den CURL Aufruf wenn die CRM URL per REST geöffnet werden soll.

Automatischer Workstation Login

EinstellungStandardwertErlaubte WerteWirkung
AutomaticWorkstationLoginFalseTrue oder FalseWenn True, wird der Rechnername, IP Adresse und des Clients sowie aktueller Benutzername an den Webserver übermittelt. Wird ein passender Eintrag in die Workstations Tabelle gefunden, und der angegebene Benutzername ist als Windows Login Name in der Users Tabelle konfiguriert, so wird der Benutzer automatisch angemeldet. Ist zusätzlich die Option StatusChangeOnStartClient konfiguriert, so wird der Benutzer an der in der Workstations zugeordnete Telefonnummer angemeldet.
UseRemoteWorkstationNameFalseTrue oder FalseWenn True, wird anstatt der Workstation Name ggf., falls der Mini-Client in einer RDP oder Citrix Session ausgeführt wird, der Remote-Client Name für die Anmeldung genutzt in Kombination mit der Option AutomaticWorkstationLogin.

Automatischer .EXE Aufruf

EinstellungStandardwertErlaubte WerteWirkung

AutomaticEXECall

FalseTrue oder FalseWenn True, wird anhand der folgenden Parameter ein auf den lokalen Rechner installierte .EXE aufgerufen wenn ein Anruf eingehend ist.

AutomaticEXECallCommand


Pfad zu einer .EXE Datei am lokalen Rechner.Hier geben Sie den Pfad zur .EXE Datei an. Dieser kann entweder relativ (zu AcdMiniClient.exe) sein, oder absolut inkl. Laufwerk und Pfadangabe. UNC Pfade werden unterstützt.

AutomaticEXECallParameters


Beliebig.

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

ParameterBedeutung

$ANumber

Die A-Teilnehmer Rufnummer.

$CRMLink

Der CRM Link aus der ACD Konfiguration.
$ServiceNumberDie gerufene Service-Rufnummer.
$ServiceNameName der gerufene Service-Rufnummer.
$CallIDDie jtel interne Call-ID (StatisticsPartA.ID)
$UsersUIDDie ID des Users (Agenten) der im Mini-Client angemeldet ist.
$UsersEMailDie E-Mail des Benutzers (Agenten), der im Mini-Client angemeldet ist.
$DateTimeUTCDas aktuelle UTC-Datum und die Uhrzeit im folgenden Format: yyyyy-MM-ddThh:mm:ssZ
$DateTimeLocalDas aktuelle lokale Datum und die Uhrzeit im folgenden Format: yyyyy-MM-ddThh:mm:ss


AutomaticEXECallHiddenFalseTrue oder FalseWenn dies zutrifft, dann wird die aufgerufene EXE mit einem verborgenen Fenster erstellt, so dass sie vom Agenten nicht gesehen wird.
AutomaticEXECallWaitAndLogFalseTrue oder FalseWenn true, dann wird die aufgerufene EXE vom Mini-Client (unter Verwendung eines separaten Threads) gewartet, und jede Ausgabe von der EXE auf die Standard-Ausgabe- oder Fehler-Streams wird in der Protokolldatei des Mini-Clients protokolliert.
AutomaticEXECallTimeout30000Jeder Ganzzahlwert von 0 bis zur maximalen Größe einer 32-Bit-Ganzzahl mit Vorzeichen.Dies definiert die Anzahl von Millisekunden, die der Mini-Client auf den Abschluss des Aufrufs der ausführbaren Datei wartet, bevor er das Protokoll in die Protokolldatei schreibt und optional den Prozess beendet (siehe nächste Einstellung).
AutomaticEXECallKillAfterTimeoutFalseTrue oder FalseWenn true, tötet der Mini-Client die aufgerufene EXE-Datei, wenn die Zeitüberschreitung erreicht ist.

Outlook Integration

EinstellungStandardwertErlaubte WerteWirkung
OpenOutlookContactFalseTrue oder FalseWenn True, wird das Öffnen des Outlookkontakts erlaubt.
ExchangeServerUrl
Url 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. 

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

Protokoll-Handler

EinstellungStandardwertErlaubte WerteWirkung
RegisterURLHandler

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.

RegisterURLHandlerProtocol

Protokoll. Zum Beispiel:

tel

oder

callto

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

Zustatzinformation in Datei Speichern

EinstellungStandardwertErlaubte WerteWirkung
SaveAdditionalInfoFalseTrue oder False

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

FilePathForSavingAdditionalInfo

Speicherort der Datei.
AdditionalInfoElementIDs

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

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

RegExprForSavingAdditionalInfo

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

Alte Einstellungen

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

EinstellungStandardwertErlaubte WerteWirkung

Zoom

100Prozentwerte, auch > 100 erlaubt.

Stellt den Zoom-Faktor des eingebetteten Browsers ein (gleiche Funktion wie Zoom im Browser selbst).

Diese Einstellung existiert im MiniClient2 nicht. Mit der Tastenkombination STRG + bzw. STRG - kann jeder Agent für sich den Gewünschten Zoom einstellen.

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.

Translations Ignore


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

...



...