QM stores system-wide preferences in a text file called configuration.properties under WEB-INF. The absolute path of that file can be found by looking at the directory called System path on the Licence page in QM.
Defaults
| Property name | Description |
|---|---|
default.queue | Internal ID (ex. 7, 49….) of the default queue, leave blank for no default queue. |
default.queue_log_file | Default queue log file. |
default.monitored_calls | The top level directory where monitored calls are held. All its subdirectories are explored recursively. Do NOT forget to add an ending slash. |
default.areacode_digits | How many digits to consider as a default area code |
default.start_hour | Preset start and end hours and number of days for the custom report. |
default.end_hour | |
default.days | |
liveclock.enable | If live clock is enabled, the system clock is synchronized with Asterisk server system clock. |
default.max_realtime_age | How old a call can be included in real-time report |
default.permanentCallbackAgents | If call-back agents should be considered still logged on after a system reload; the current version of Asterisk will do this automatically. Default: true |
default.considerIncompletetEntities | If incomplete entities (calls or agent sessions that are in progress at the moment that are in progress at the moment the analysis is being run) should be counted in the reports or not. Default: true |
default.rewriteLocalChannels | Rewrites queue_log entries in the form Local/xxx@context to Agent/xxx to make deployment simpler for AAH users. Default: false. |
sla.max_monitored_delay | The max delay and interval that will be shown in the TOS graph |
sla.interval | |
default.joinMultiStintCalls | If true, multi-stint calls are joined by default |
default.useEndingChannelName | If true, the last reference to an agent is used as its name (in case they are different) |
default.showQueueComposition | If true, show the details of the queues composing the aggregate queue; if flase, show only the aggregate queue’s name |
default.useXmlExcel | True: Generate the Excel file as an XML file (mandatory for UTF charsets); false: generate as an ISO-8859 CSV file |
default.hourly_slot | How long in minutes is an hourly slot for hourly breakdown. Default 60 minutes (1hr). If set to e.g. 15, calls will be broken down by 15 minute intervals. |
default.useRawAgentSessions | If true, show all agent sessions. If false, show only agent sessions with at least one call handled. Defaults to false. |
default.closeDuration | The default duration of a call that is manually closed. This is the wait time for calls that have not been answered and the talk time for calls that have been answered. |
default.crmapp | If present and not empty it will enable the CRM integration column on the answered/unanswered call details tables. The key could be populated with an URL where some tokens will be expanded by the QM engine. Valid tokens are [A] (expanded with agent code) and [U] (expanded with the asterisk unique ID associated to the call). One example could be: http://server/app?agent=[A]&unique=[U] |
default.showAstClid | If present and set to true it will enable the asterisk unique ID column on the answered/unanswered call details tables. |
default.showSecondsOnTotalCalls | If present and set to true, the summary report call time figures will be shown in hhmmss format instead of hours format |
default.alwaysLogonUnpaused | If set to true, when an agent logs on, he will always be unpaused |
default.disablebackhistory | If set to true, disable the history back navigation button in browsers |
default.subqueueModeEnabled | If set to true, all activities on subqueues are reported in the parent queue |
default.secondsServiceLevel | The default SLA that Traffic Distribution graphs will use (see DD08). Default: 20 seconds |
default.shortCallsLimit | The default Short Call limit that Traffic Distribution graphs will use (see DD08). Default: 5 seconds |
Layout
| Property name | Description |
|---|---|
layout.logo | Your company logo (full or relative path) - shall be resized to be an image 200 x 72. The variable $WEBAPP refers to the local webapp, as an alternative use the full http://.. URL. |
layout.splash | HTML string displayed on the login page. |
default.noLicenseWarning | Set to ’true’ to disable license expiration notifications on the Home Page. |
default.language | The default language. Must be one of the installed language packs. Default: en |
default.country | The default country for the Locale. Must be one of the installed language packs. Default: US |
default.viewTechInfo | Is it possible to see Tech Info on the licence page and run DBTest? |
Database Access
| Property name | Description |
|---|---|
sqlPreset.i.table | Sets the table name for preset ’i’ |
sqlPreset.i.f_time_id | Defines the field used by the table in MySQL storage. See Section 17, “Monitoring clusters with QueueMetrics” for complete information. |
sqlPreset.i.f_call_id | |
sqlPreset.i.f_queue | |
sqlPreset.i.f_agent | |
sqlPreset.i.f_verb | |
sqlPreset.i.f_partition | |
sqlPreset.i.f_data1 | |
sqlPreset.i.f_data2 | |
sqlPreset.i.f_data3 | |
sqlPreset.i.f_data4 | |
sqlPreset.i.f_incr |
Realtime Page
| Property name | Description |
|---|---|
realtime.calls_invisible | Is the calls panel in the realtime page invisible by default? 0 false, 1 true |
realtime.agents_invisible | Is the agents panel in the realtime page invisible by default? 0 false, 1 true |
realtime.members_only | Are not the only agents to be shown on the realtime page those who are "known" for the queue? 0 false, 1 true |
realtime.refresh_time | In how many seconds is the realtime page to refresh? |
realtime.use_sql_now | 0: analyze all available data; 1: analyze all data which timestamp is lower than the current NOW() function. Do not change. |
realtime.startHour | The starting hour of the day, in order to compute realtime report. It can be either a fixed hour (e.g. 3: from 3:00 AM) or a sliding window if prefixes with S (e.g. s3: the last three hours). Default value is 0 (from midnight). A useful value is also -24 (yesterday’s midnight). |
realtime.all_subqueues | Enable default showing of all subqueues if set to 1 |
realtime.waitAlarmOnLiveCalls | Decide whether to check for alarms on the wait time of ongoing conversations. |
realtime.hideExportButtons | If true, hide export buttons on the Real-time page. Defaults to false. |
realtime.absolutePauseTimes | If true, the start of the current pause is shown as an absolute hour; if false, it is shown as the time passed since. |
realtime.calls_invisible.buttonEnabled | Decide which buttons o the real-time page can be toggled by the user. Buttons not enabled are set to their default value. |
realtime.agents_invisible.buttonEnabled | |
realtime.members_only.buttonEnabled | |
realtime.all_subqueues.buttonEnabled | |
realtime.assignedLocationsOnly | If true, the user will not be able to monitor without a given location. See page Section 7.4, “Using Locations” for more details. |
Agent’s Realtime Page
| Property name | Description |
|---|---|
realtime.max_bytes_agent | When the real-time page for an agent is computed, the queue_log is NOT read in its entirety but only the last ’n’ bytes. In database storage mode, the number of seconds, starting from now and counting backwards, that will be queried for agent events. |
realtime.agent_autoopenurl | When the real-time page for an agent shows a new call in the call list, and if the call detail contains an URL, this URL will be open in a new browser window. |
realtime.agent_button_X.enabled | Enable or disable a custom button in the realtime page. X shall be an integer between 1 and 4. |
realtime.agent_button_X.caption | This is the label associated to a button. |
realtime.agent_button_X.url | Defines the URL that will be opened when the button is pressed. The tokens [A] and [U] are expanded by QueueMetrics with, respectively, the Agent’s ID and the most recent call Asterisk Call Unique ID as displayed in the call list. If no calls are present, Unspecified will be used instead. |
realtime.agent_button_X.channel | Defines the first leg to be used in a dial command issued to the Asterisk server when the agent presses the button. E.g. Local/104@from-internal . |
realtime.agent_button_X.ext | Defines the second leg to be used in a dial command issued to the Asterisk server when the agent presses the button. E.g. 200@ext-queue . |
realtime.agent.show_agaw | Enable or disable the AGAW subset information table present in the agent’s realtime page. |
realtime.realtime.dynamicLoginQueues | Defines what queues should be listed in the dropdown when agents log-in/out throug the Add Member/Remove Member button. The key should be filled with three optional values as reported below: all: The dropdown will show the "All assigned" option followed by the queues assigned to the agent (in QueueMetrics queues configuration) and queues where the agent was not assigned but it’s free to log in dynamically registered: The dropdown will show the "All assigned" option followed by the queues assigned to the agent (in QueueMetrics queues configuration) assigned: The dropdown will show only the "All assigned" option. In this situation the Add Member/Remove Member buttons behave like the "old" Log on and Log off pushbuttons. |
default.lockedAgentPopupCode | If true, the agent cannot change their code in the login/logoff/pause pop-ups. Defaults to false. |
Asterisk Interaction
| Property name | Description |
|---|---|
callfile.dir | The call-file directory Asterisk uses to generate calls based on .call files. Must be writable by the Java process. Default _/var/spool/asterisk/outgoing As an alternative, you may enter a Manager interface URI here, in the format _tcp:user:password@server If you do, QM will not generate call-files but will use the manger interface to generate calls. The same field is used by the asterisk configuration wizard when "Single Machine AMI" was selected as source. |
callfile.monitoring.enabled | If unattended audio monitoring is enabled on this system. Default true. |
callfile.monitoring.channel | The channel, and extension@context that will be called to implement the unattended audio monitoring functionality. Do not forget the trailing /n in the channel. A number of variables act as placeholders to be substituted by the actual data Asterisk is using: $AG: the current agent; $AE: the agent’s extension; $EM: the monitoring extension; See Section 20.8, “Listening to live calls: Unattended Call Monitoring” for further information. |
callfile.monitoring.extension | |
callfile.monitoring.context | |
callfile.agentpause.enabled | This function is used to start a pause from the Agent’s page and to set its Pause Code - see the sample dial plan provided. |
callfile.agentpause.channel | |
callfile.agentpause.extension | |
callfile.agentpause.context | |
callfile.agentunpause.enabled | This function is used to end a pause from the Agent’s page - see the sample dial plan provided. |
callfile.agentunpause.channel | |
callfile.agentunpause.extension | |
callfile.agentunpause.context | |
callfile.agentlogin.enabled | This function is used to log in an agent from the Agent’s page - see the sample dial plan provided. |
callfile.agentlogin.channel | |
callfile.agentlogin.extension | |
callfile.agentlogin.context | |
callfile.agentlogoff.enabled | This function is used to log off an agent from the Agent’s page - see the sample dial plan provided. |
callfile.agentlogoff.channel | |
callfile.agentlogoff.extension | |
callfile.agentlogoff.context | |
callfile.calloutcome.enabled | This function is used to set the call outcome code from the Agent’s page - see the sample dial plan provided. |
callfile.calloutcome.channel | |
callfile.calloutcome.extension | |
callfile.calloutcome.context | |
callfile.agentdial.enabled | This function is not implemented yet. |
callfile.agentdial.channel | This function is not implemented yet. |
callfile.agentdial.extension | |
callfile.agentdial.context | |
callfile.outmonitoring.enabled | This function lets you monitor outgoing calls using a different piece of dial-plan, as outgoing channel names might be different from incoming ones. |
callfile.outmonitoring.channel | |
callfile.outmonitoring.extension | |
callfile.outmonitoring.context | |
callfile.agentaddmember.enabled | This function is used to dynamically add an agent to a specific queue from the Agent’s page - see the sample dial plan provided. |
callfile.agentaddmember.channel | |
callfile.agentaddmember.extension | |
callfile.agentaddmember.context | |
callfile.agentremovemember.enabled | This function is used to dynamically remove an agent from a specific queue from the Agent’s page - see the sample dial plan provided. |
callfile.agentremovemember.channel | |
callfile.agentremovemember.extension | |
callfile.agentremovemember.context | |
callfile.customdial.enabled | This function lets able an agent to dial through one outbound specific queue - see the sample dial plan provided. |
callfile.customdial.channel | |
callfile.customdial.extension | |
callfile.customdial.context |
Real-Time Sounds
| Property name | Description |
|---|---|
sound.yellowAlarm | Sound to be played if a yellow alarm is triggered. Can be either an absolute URL or a relative path |
sound.redAlarm | Sound to be played if a red alarm is triggered. Can be either an absolute URL or a relative path |
Cluster configuration
| Property name | Description |
|---|---|
cluster.servers | A set of servers, which names must be used for subsequent properties |
cluster.servername.manager | The manager API for this server, in the format tcp:user:pass@server. This field is also used by the asterisk autoconfiguration wizard when "Cluster AMI" source was selected. |
cluster.servername.queuelog | The queue log partition to use, in the format sql:P001 |
cluster.servername.monitored_calls | The directory where monitored calls for this server can be found. If it starts with "http", an XML-RPC server to query this information |
cluster.servername.callfilesdir | The directory in which callfiles must be generated for this sever. Usually leave blank. |
cluster.servername.audioRpcServer | The URL of an XML-RPC server to be used for audio monitoring |
cluster.servername.agentSecurityKey | The key with which this cluster entry must be protected on the Agent’s page |
Audio Monitoring
| Property name | Description |
|---|---|
audio.server | The PM to use for listening to recorded calls. |
audio.liveserver | The PM to use for listening to live calls. |
default.audioRpcServer | The URL of an external XML-RPC server for both listening of recorded calls and live call monitoring. |
audio.lookBack | How many hours to check for midnight crossing. Used by the LocalFilesByDay PM. |
Misc
| Property name | Description |
|---|---|
manager.dump | By setting this property to true, the dialog between Asterisk and QM used to show the Live! Page is dumped to the Catalina.out log file. This makes it possible to send it over to Loway for debugging purpouses. |
default.skip_task_on_qagrading | If not present or set to false, a new task will be sent to the graded agent each time a new qa form will be completed. If present and set to true, no tasks will be sent. |
AGAW configuration
| Property name | Description |
|---|---|
dbmaint.agaw_oldestRun | Oldest obsolete run to keep when running a database optimization, in minutes |
dbmaint.agaw_oldestLog | Oldest obsolete log to keep when running an optimization, in minutes |
dbmaint.agaw_oldestBroadcast | Oldest obsolete broadcast entries to keep when running an optimization, in minutes |
Autoconfiguration Wizard
| Property name | Description |
|---|---|
default.autoconf.source | Defines the default source that will be selected in the dropdown list on the wizard configuration page. It could assume the following values: file for File sources; ami for Single Machine AMI; amic for Clustered Machines AMI; rtdb for Asterisk Realtime Database; quef for Asterisk Queue Log file |
default.autoconf.fileagents | Defines the default agents file definition will be shown in the configuration wizard page and will be read by the configuration wizard unattended mode |
default.autoconf.filequeues | Defines the default queues file definition will be shown in the configuration wizard page and will be read by the configuration wizard unattended mode |
default.autoconf.fileusers | Defines the default users file definition will be shown in the configuration wizard page and will be read by the configuration wizard unattended mode |
default.autoconf.filequeuelog | Defines the default queue log file will be shown in the configuration wizard page and will be read by the configuration wizard unattended mode |
default.autoconf.realtimedrv | Defines the database technology used by asterisk to read/write the realtime database (as Java Driver package) For MySQL the default value is com.mysql.jdbc.Driver |
default.autoconf.realtimeuri | Defines the realtime database location and authentication parameters in jdbc format. |
Obsolete parameters
| Property name | Description |
|---|---|
default.showLostCallsWhenFiltering | If true, lost calls are shown when running a report in filter mode. This is usually false, as all lost calls would be shown even if you run a report for a single agent. |
Removed in version 1.5.1 |