Cisco Cisco Unified Customer Voice Portal 11.0(1) Developer's Guide
V
OICE
E
LEMENT
:
D
IGITS
C
ISCO
CVP
V
OICE
XML
3.0
Element Specifications
Copyright 2001 - 2005 Audium Corporation. All Rights Reserved. 1/14/05
31
Digits
The Digits voice element captures a string of numerical digits. It may be used to collect small or large strings of digits. The digit string
can be entered using the keypad or speech input. The captured value will be stored in element data as a string. The string cannot
contain any non-numerical characters. Using speech input, the number is spoken one digit at a time (i.e. 49678 is spoken "four nine six
seven eight"). DTMF input can be terminated by a # keypress if desired (if not used, the entry is considered terminated when the input
timeout has been reached).
can be entered using the keypad or speech input. The captured value will be stored in element data as a string. The string cannot
contain any non-numerical characters. Using speech input, the number is spoken one digit at a time (i.e. 49678 is spoken "four nine six
seven eight"). DTMF input can be terminated by a # keypress if desired (if not used, the entry is considered terminated when the input
timeout has been reached).
With the Digits voice element, the application designer has the ability to set length restrictions on the digit string. A minimum and
maximum length can be given to narrow the criteria. If a string of a specific length is required, the minimum and maximum lengths
should be set to the same value. If fewer digits are entered, a nomatch event will be thrown. A string of digits with length greater than
the maximum length cannot be entered.
maximum length can be given to narrow the criteria. If a string of a specific length is required, the minimum and maximum lengths
should be set to the same value. If fewer digits are entered, a nomatch event will be thrown. A string of digits with length greater than
the maximum length cannot be entered.
Settings
Name (Label)
Type
Req’d
Single
setting
value
Substitution
allowed
Default
Notes
inputmode
(Input Mode)
(Input Mode)
string
enum
Yes
true
false
both
The type of entry allowed for input. Possible
values are: voice | dtmf | both.
values are: voice | dtmf | both.
noinput_timeout
(Noinput Timeout)
(Noinput Timeout)
string Yes
true
true
5s
The maximum time length allowed (in seconds)
for silence or no keypress before a noinput event
is thrown.
for silence or no keypress before a noinput event
is thrown.
max_noinput_count
(Digits Max NoInput Count)
(Digits Max NoInput Count)
int ≥ 0
Yes
true true
3
The maximum number of noinput events allowed
during digits input capture. 0 = infinite noinputs
allowed.
during digits input capture. 0 = infinite noinputs
allowed.
max_nomatch_count
(Digits Max NoMatch Count)
(Digits Max NoMatch Count)
int ≥ 0
Yes
true true
3
The maximum number of nomatch events allowed
during digits input capture. 0 = infinite
nomatches allowed.
during digits input capture. 0 = infinite
nomatches allowed.
digits_confidence_level
(Digits Confidence Level)
(Digits Confidence Level)
decimal
(0.0 to 1.0)
Yes
true
true
0.40
The confidence level threshold to use during
digits capture.
digits capture.
min_digit
(Min Digit)
(Min Digit)
int > 0
Yes
true
true
None
Minimum number of digits allowed.
max_digit
(Max Digit)
(Max Digit)
int > 0
Yes
true
true
None
Maximum number of digits allowed.