Collaboration

Wildcards and Special Characters in Route Patterns and Hunt Pilots

Wildcards and Special Characters in Route Patterns and Hunt Pilots in CUCM and voice translation patterns in IOS.

CUCM

Wildcards and special characters in route patterns and hunt pilots allow a single route pattern or hunt pilot to match a range of numbers (addresses). Use these wildcards and special characters also to build instructions that enable the Cisco Unified Communications Manager to manipulate a number before sending it to an adjacent system.

The following table describes the wildcards and special characters that Cisco Unified Communications Manager supports.

Character
Description
Examples
@
The at symbol (@) wildcard matches all National Numbering Plan numbers.
Each route pattern can have only one @ wildcard.
The route pattern 9.@ routes or blocks all numbers that the National Numbering Plan recognizes.
The following route patterns examples show National Numbering Plan numbers that the @ wildcard encompasses:

  • 0
  • 1411
  • 19725551234
  • 101028819725551234
  • 01133123456789
X
The X wildcard matches any single digit in the range 0 through 9.
The route pattern 9XXX routes or blocks all numbers in the range 9000 through 9999.
!
The exclamation point (!) wildcard matches one or more digits in the range 0 through 9.
The route pattern 91! routes or blocks all numbers in the range 910 through 91999999999999999999999.
?
The question mark (?) wildcard matches zero or more occurrences of the preceding digit or wildcard value.
The route pattern 91X? routes or blocks all numbers in the range 91 through 91999999999999999999999.
+
The plus sign (+) wildcard matches one or more occurrences of the preceding digit or wildcard value.
The route pattern 91X+ routes or blocks all numbers in the range 910 through 91999999999999999999999.
[ ]
The square bracket ([ ]) characters enclose a range of values.
The route pattern 813510[012345] routes or blocks all numbers in the range 8135100 through 8135105.
The hyphen (-) character, used with the square brackets, denotes a range of values.
The route pattern 813510[0-5] routes or blocks all numbers in the range 8135100 through 8135105.
^
The circumflex (^) character, used with the square brackets, negates a range of values. Ensure that it is the first character following the opening bracket ([).
Each route pattern can have only one ^ character.
The route pattern 813510[^0-5] routes or blocks all numbers in the range 8135106 through 8135109.
.
The dot (.) character, used as a delimiter, separates the Cisco Unified Communications Manager access code from the directory number.
Use this special character, with the discard digits instructions, to strip off the Cisco Unified Communications Manager access code before sending the number to an adjacent system.
Each route pattern can have only one dot (.) character.
The route pattern 9.@ identifies the initial 9 as the Cisco Unified Communications Manager access code in a National Numbering Plan call.
*
The asterisk (*) character can provide an extra digit for special dialed numbers.
You can configure the route pattern *411 to provide access to the internal operator for directory assistance.
#
The octothorpe (#) character generally identifies the end of the dialing sequence.
Ensure the # character is the last character in the pattern.
The route pattern 901181910555# routes or blocks an international number that is dialed from within the National Numbering Plan. The # character after the last 5 identifies this digit as the last digit in the sequence.
+
A plus sign preceded by a backslash, that is, +, indicates that you want to configure the international escape character +.
Using + means that the international escape character + is used as a dialable digit, not as a wildcard.

 

The following table lists Cisco Unified Communications Manager Administration fields that require route patterns or hunt pilots and shows the valid entries for each field.

 

Field
Valid entries
Call Park Number/Range
[ ^ 0 1 2 3 4 5 6 7 8 9 – ] X * #
Calling Party Transform Mask
0 1 2 3 4 5 6 7 8 9 X A B C D * # +
Called Party Transform Mask
0 1 2 3 4 5 6 7 8 9 X A B C D * # +
Caller ID DN (Gateways and Trunks)
0 1 2 3 4 5 6 7 8 9 X * # +
Directory Number
+ [ ^ 0 1 2 3 4 5 6 7 8 9 – ] + ? ! X * # +
Directory Number (Call Pickup Group Number)
0 1 2 3 4 5 6 7 8 9
External Phone Number Mask
0 1 2 3 4 5 6 7 8 9 X * # +
Forward All
0 1 2 3 4 5 6 7 8 9 * # +
Forward Busy
0 1 2 3 4 5 6 7 8 9 * # +
Forward No Answer
0 1 2 3 4 5 6 7 8 9 * # +
Meet-Me Conference Number
[ ^ 0 1 2 3 4 5 6 7 8 9 – ] X * #
Prefix Digits
0 1 2 3 4 5 6 7 8 9 A B C D * # +
Prefix DN (Gateways and Trunks)
0 1 2 3 4 5 6 7 8 9 * # +
Route Filter Tag Values
[ ^ 0 1 2 3 4 5 6 7 8 9 – ] X * #
Route Pattern
[ ^ 0 1 2 3 4 5 6 7 8 9 A B C D – ] + ? ! X * # + . @ +
Translation Pattern
[ ^ 0 1 2 3 4 5 6 7 8 9 A B C D – ] + ? ! X * # + . @ +
Hunt Pilot
[ ^ 0 1 2 3 4 5 6 7 8 9 A B C D – ] + ? ! X * # + . @ +

 

IOS Voice Translation

Wildcard Definition
. Any single digit
0 to 9,*,# Any specific character
[0-9] Any range or sequence of characters
* Modifier—match none or more occurrences
+ Modifier—match one or more occurrences
? Modifier—match none or one occurrence
Wildcard Combination Definition
.* Any digit followed by none or more ocurrences. This is effectively anything, including null.
.+ Any digit followed by one or more ocurrences. This is effectively anything, except null.
^$ No digits, null

 

Simon Birtles

I have been in the IT sector for over 20 years with a primary focus on solutions around networking architecture & design in Data Center and WAN. I have held two CCIEs (#20221) for over 12 years with many retired certifications with Cisco and Microsoft. I have worked in demanding and critical sectors such as finance, insurance, health care and government providing solutions for architecture, design and problem analysis. I have been coding for as long as I can remember in C/C++ and Python (for most things nowadays). Locations that I work without additional paperwork (incl. post Brexit) are the UK and the EU including Germany, Netherlands, Spain and Belgium.