Default values may vary, depending on the version that's downloaded
Pinup
Pin up
The mini client can only be pinned on the main screen.
Configuration File
Configuration 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:
... <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> ...
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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
StatusChangeOnStartClient | False | True or False | When the client is started, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnStartClientElementID | M:acdStatusButton_2 | M: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. | ||||||||||||||||||||
StatusChangeOnCloseClient | False | True or False | When the mini client is closed, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnCloseClientElementID | M:acdStatusButton_1 | M: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 | ||||||||||||||||||||
StatusChangeOnCloseClientWait | 3000 (Milliseconds) | Integer 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! | ||||||||||||||||||||
StatusChangeOnLockScreen | False | True or False | When the screen on the client PC is locked, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnLockScreenElementID | M: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 | ||||||||||||||||||||
StatusChangeOnUnlockScreen | False | True or False | When the screen on the client PC is unlocked, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnUnlockScreenElementID | M:acdStatusButton_2 | M: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 | ||||||||||||||||||||
StatusChangeOnRemoteConnect | False | True or False | When a connection to the computer via remote happens, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnRemoteConnectElementID | M:acdStatusButton_2 | M: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 | ||||||||||||||||||||
StatusChangeOnRemoteDisconnect | False | True or False | When a connection to the computer via remote is closed, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnRemoteDisconnectElementID | M:acdStatusButton_3 | M: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 | ||||||||||||||||||||
StatusChangeOnConsoleConnect | False | True or False | When a connect via console happens, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnConsoleConnectElementID | M:acdStatusButton_2 | M: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 | ||||||||||||||||||||
StatusChangeOnConsoleDisconnect | False | True or False | When a disconnect via console happens, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnConsoleDisconnectElementID | M:acdStatusButton_3 | M: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 | ||||||||||||||||||||
StatusChangeOnPowerModeSuspend | False | True or False | When the, for example, laptop lid is closed, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnPowerModeSuspendElementID | M:acdStatusButton_3 | M: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 | ||||||||||||||||||||
StatusChangeOnPowerModeResume | False | True or False | When the, for example, laptop lid is opened again, whether a status change of the agent should be performed. | ||||||||||||||||||||
StatusChangeOnPowerModeResumeElementID | M:acdStatusButton_2 | M: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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
IncomingCallPopup | False | True or False | If True, a small popup window ("Toaster") is displayed when a call is received. | ||||||||||||||||||||
IncomingCallPopupDuration | 5 | Integer | Display duration in seconds of the call popup | ||||||||||||||||||||
IncomingEventPopup | False | True or False | If True, a small pop-up window ("Toaster") is displayed when a media event is received. | ||||||||||||||||||||
IncomingEventPopupDuration | 5 | Integer | Display duration in seconds of the event popup | ||||||||||||||||||||
Layout | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
MinimizeOnlyInTray | True | True or False | If 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,.xlsx | This parameter is required so that the reports can be opened in the miniClient. | ||||||||||||||||||||
Basic settings | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
AcceptLanguage | de-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. | ||||||||||||||||||||
PanelWidth | 400 | Integer values, sensible range approx. 300 to 500. Value 0 is also possible. | Sets the width of the mini Client. Value 0 will allow the client to remember the previous width during last usage. Upon reopening, it will return to the previously used size. | ||||||||||||||||||||
DefaultCountryCode | 49 | Country codes | Default country code for the contact search (see AlternativeSearchWithoutCountryCode) | ||||||||||||||||||||
PhoneSelectCountryCode | 49 | Country code. | The country code for the hotkey function when a phone number is dialled with 0. | ||||||||||||||||||||
PhoneNumberClipboardDelay | 50 | Integer | Number of milliseconds the mini Client .EXE waits to grab the clipboard after Ctrl+C is sent to the active application | ||||||||||||||||||||
DisableCookieLogin | False | True oder False | Allows the login with cookie. | ||||||||||||||||||||
BrowserCacheDir | incognito | incognito or file path | Save browser cache. In incognito mode everything is in memory. | ||||||||||||||||||||
DisableSpellCheck | True | True or False | If True, the spell checker is turned off in the client. Otherwise, spell checking is active, using the language specified in the AcceptLanguage configuration setting. | ||||||||||||||||||||
CEFSettings | 0 | 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 SetOffScreenRenderingBestPerformanceArgs | ||||||||||||||||||||
IgnoreCertificateErrors | True | True or False | Ignores the certificates when connecting to the Exchange. | ||||||||||||||||||||
BrowserLogFile | Path of the log file | File for the error log of the browser. | |||||||||||||||||||||
BrowserUserAgentHeader | Empty | Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36 Edge/119.0.0.0 Example: <value name="BrowserUserAgentHeader" type="String">Edge/119.0.0.0</value> | VERSION 3.27 AND HIGHER The User-Agent header of the mini client can be set with this setting. If configured, the user agent header for http/https requests is replaced with the setting. | ||||||||||||||||||||
Hotkey Dial Preparation | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
PhoneSelectShortcut | Win.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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
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 ($) { var clickSpecificFunction = function (elemType, elemId) { clickSpecificFunction('a', 'M:acdStatusButton_2'); "OK" | |||||||||||||||||||||
CRM URL | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
OpenPopupURLInExternalBrowser | True | True oder False | Open the CRM link in the standard external browser. | ||||||||||||||||||||
ProtocolHandlers | mailto | Any 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. | ||||||||||||||||||||
AutomaticallyOpenCRMUrl | False | True or False | If True, the CRM Url is automatically opened in the default browser. | ||||||||||||||||||||
AutomaticRESTCRMUrl | False | True or False | If True, instead of opening the CRM URL in the browser window, a REST call is made by GET on the URL. See also CurlRESTCommand. | ||||||||||||||||||||
CurlRESTCommand | cygwin\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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
AutomaticWorkstationLogin | False | True or False | If 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. | ||||||||||||||||||||
UseRemoteWorkstationName | False | True or False | If 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 | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
AutomaticEXECall | False | True or False | If 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.
| |||||||||||||||||||||
AutomaticEXECallHidden | False | True or False | If true, then the EXE called will be created with a hidden window so it is not seen by the agent. | ||||||||||||||||||||
AutomaticEXECallWaitAndLog | False | True or False | If 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. | ||||||||||||||||||||
AutomaticEXECallTimeout | 30000 | Any 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). | ||||||||||||||||||||
AutomaticEXECallKillAfterTimeout | False | True or False | If true, the mini client kills the called EXE file if the timeout is reached. | ||||||||||||||||||||
Miniclient as Protocol Handler | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
RegisterURLHandler | Register | 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. | |||||||||||||||||||||
UseWindowsPipes | True | True or False | An additional parameter in the configuration file - UseWindowsPipes - has been introduced, to make the use of the command line dial functionality in a terminal server environment work: AcdMiniClient.exe --dial <number> | ||||||||||||||||||||
Outlook Integration | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
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". | |||||||||||||||||||||
OpenOutlookContact | False | True or False | If 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. | |||||||||||||||||||||
AlternativeSearchWithoutCountryCode | True | True or False | If True and if no contact was found, a contact without country code (see parameter DefaultCountryCode ) is searched. Background:
| ||||||||||||||||||||
OutlookContactsOpenOnlyFirstMach | True | True or False | Theoretically, 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 | ||||||||||||||||||||
Additional information and settings for the additional info (save additional information to file) | |||||||||||||||||||||||
Setting | Default value | Allowed values | Effect | ||||||||||||||||||||
SaveAdditionalInfo | False | True 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:
|
Old Settings
The following settings are no longer supported as of Mini Client 2.
Setting | Default value | Allowed values | Effect |
---|---|---|---|
Zoom | 100 | Percentage 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. 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