D. System preferences

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