Cisco Cisco Unified Customer Voice Portal 10.0(1)
2-31
Cisco Internet Service Node (ISN) Configuration and Administration Guide
OL-1251-03
Chapter 2 Using NAM/ICM with the ISN IVR Solution
ISN Micro-Applications
Get Digits and Digit Entry Completion
The ISN tests GD digit entry input against several conditions to determine whether digit entry is
complete. The ISN considers digit entry to be complete if the caller enters any of the following:
complete. The ISN considers digit entry to be complete if the caller enters any of the following:
•
The maximum allowable number of digits (when terminator key is not used).
•
The maximum number of digits, excluding a terminator key (when terminator key is used).
•
Less than the maximum number of digits, followed by the terminator key.
•
Less than the maximum number of digits and exceeding the inter-digit timeout.
•
Nothing and reaching the no entry timeout.
Caution
It is important that you set up your NAM/ICM script to test for all the scenarios mentioned below.
If digit-entry input is complete
After digit-entry input is complete, the ISN validates the digit string to determine if it is >= (greater than
or equal to) the minimum length and <= (less than or equal to) the maximum length.
or equal to) the minimum length and <= (less than or equal to) the maximum length.
Note
In variable-length data entry, the Maximum Field Length value does not accommodate the termination
key. For example, if a GD micro-application is configured to accept a password that is between 6 and 12
digits long and digit-entry completion is indicated through a termination key (or a timeout), the
Minimum Field Length setting should be 6, the Maximum Field Length setting should be 12, and the
DTMF Termination Key should be defined as a single character.
key. For example, if a GD micro-application is configured to accept a password that is between 6 and 12
digits long and digit-entry completion is indicated through a termination key (or a timeout), the
Minimum Field Length setting should be 6, the Maximum Field Length setting should be 12, and the
DTMF Termination Key should be defined as a single character.
Before passing the result back to the Application Server, the Voice Browser would discard the
termination key (that is, only the password digits will be included in the CED returned to ICM software).
termination key (that is, only the password digits will be included in the CED returned to ICM software).
In this example, if the 13th digit is entered without reaching the interdigit timeout and the 13th digit is
not the terminator key, a NOMATCH event (same as inter-digit timeout) occurs to clear the CED buffer
on the Voice Browser.
not the terminator key, a NOMATCH event (same as inter-digit timeout) occurs to clear the CED buffer
on the Voice Browser.
After validating the digit string, the ISN does the following:
•
If the string is valid, the ISN stores the digit string (not including the terminator key) in the
Call.CallerEnteredDigits variable, exits the node through the Checkmark (success) branch, and
returns control to ICM software.
Call.CallerEnteredDigits variable, exits the node through the Checkmark (success) branch, and
returns control to ICM software.
•
If the string is not valid, the ISN considers it an invalid entry and does the following:
–
If the Number of Invalid Entry Tries value has not been reached, the ISN plays an error message
and re-plays the original prompt.
and re-plays the original prompt.
–
If the Number of Invalid Entry Tries value has been reached, the ISN stores the last-entered digit
string in the Call.CallerEnteredDigits variable, exits the node through the X (failure) branch,
sets the user.microapp.error_code ECC variable to 16 (Reached Maximum Invalid Tries), and
returns control to ICM software.
string in the Call.CallerEnteredDigits variable, exits the node through the X (failure) branch,
sets the user.microapp.error_code ECC variable to 16 (Reached Maximum Invalid Tries), and
returns control to ICM software.