Digit mapping
You can configure digit maps for the phone. This configuration completely replaces the use of the DIALPLAN parameter and Enhanced Local Dialing (ELD) to provide both a dial plan and dialing rules at the same time.
Using this feature, you can enable the following:
-
Matching rules which trigger a matching dial plan
-
Substitution rules to provide the same functions as ELD, such as prefix insertion and removal, addition of area codes and country codes.
This feature also enables the phone to block certain numbers from being dialed by users.
You can configure digital maps through the 46xxsettings.txt file with the help of SET and ADD operators, which allows to use several digit maps. There is no set limit to the quantity of rules in a single digit map string, but a character limit of 255 characters for each string in a parameter value applies. You can also configure this feature using the web interface, which is the preferred way of configuration.
A digit map is a group of one or several rules, separated by commas (,). You can use blank spaces in digit maps for better readability, the phone ignores them when reading a digit map.
If a user dials a sequence that matches two or more rules in a digit map, the phone uses the exactly or most closely matching rule for that sequence.
Digit mapping syntax
You can use the following elements to configure digit maps:
|
Element sign
|
Element name
|
Element description
|
Rule example
|
|---|---|---|---|
|
Any combination of: 0-9 * # + - A-Z a-z, excluding: x
|
Literals
|
Matches digit sequences with exactly the same literals. Use literals to explicitly match a string.
|
To explicitly match the phone number 1-212-555-7722, create the following rule from literals:
You can add spaces for readability.
Example:
SET DIGIT_MAPPING "12125557722,12125557724"
to precisely match these phone numbers
|
|
x
|
x
|
A wildcard element. Can stand for any character.
|
To create a rule for any 11 digit number started with 8831, use the following rule:
|
|
.
|
.Matching Function
|
A matching function matches 0 or more of the previous element, such as x. You can use it to capture a string of entered numbers or characters of arbitrary length.
|
To create a rule to use Australian international dialing notation, use the following rule:
|
|
[ ]
|
Set
|
You can enclose a set of characters to match them to a single digit or character. You can use a set to match specific digits that form part of a number. Alphanumeric and wildcard characters are allowed inside a set, such as [x], [x#], [@#]..
|
The following set: [125-8] matches the numbers 1,2,5,6,7 and 8
|
|
[^ ]
|
Exclusion Set
|
An exclusion set matches any single alphanumeric character that is not within the set.
|
To match any arbitrarily long sequence of digits that does not start with 6,7,8,9, use the following matching rule:
|
|
!
|
! Call Bar
|
To bar users from calling numbers that match a rule, add an exclamation mark (!) in front of that rule in the digit map.
|
To bar all calls to numbers starting with 1900, regardless of length, use the following rule:
|
|
< elements : literals >
|
Element to Literal Transformation
|
Enables replacing of numerals and/or characters sequence matching elements with given literals. The expression is contained within a set of pointy brackets (< >) -and elements are separated from literals using a colon (:).
Use this rule to remove digits from a dialed number, add digits to a dialed number, or transform a dialed number. You cannot use single quote ‘ ‘ for the literals in this context. You can use special character as they do not apply in this context either. Elements can be empty, in which case you can omit the colon (:).
The literals part can be empty too, but the colon (:) must not be omitted in this case. Both elements and literals cannot be empty at the same time.
|
|