XIII. IPPBX

VigorBX 2000 - Digit Map Examples

Products:

Keywords:

Show all

The DrayTek VigorBX 2000 uses Digit Map to route outbound calls based on the number dialled. This checks the number dialled against the Digit Map entries in order, from the first entry to the last entry with the PBX routing the call based on the first match.

When a number is dialled, the PBX checks the length of the number of the Prefix / first digits of the number to check against Digit Map entries with these options available:

Match Prefix - The number specified here is checked against the leading digits of the number dialled to check for a match
Method - The action performed upon the number in addition to routing the call through the selected Trunk
Operand Number - This number is used to modify the prefix number depending on the Action selected
Min / Max Length - This is the minimum and maximum length of the number that the Digit Map entry applies to. If the number specified is longer or shorter than the specified numbers, this rule is not applied to that call
Trunk - The Trunk that the call is routed through
Backup Trunk - This is used when the Trunk selected is unregistered or detected as unavailable
Move Up / Move Down - This changes the order of the entry. Entries at the top are processed before and have higher priority than lower rules

If the number length dialled and prefix dialled match a Digit Map entry, it would then perform a Method action based upon the Digit Map entry's configuration:

None - Does not alter the number dialled and simply routes the call
Add - Routes a call based on the Trunk selected and adds the specified Operand Number as a Prefix (i.e. adding a local area code)
Strip - Routes a call based on the Trunk selected and removes the prefix of the Operand Number specified (i.e. dialling "9" to use a trunk, this removes the "9" digit)
Replace - Routes a call based on the Trunk selected and replaces the Prefix Number with the Operand Number (i.e. dial "7" and the PBX would add the prefix of "0207" to the number dialled)

If there is no match or if there is no digit map configured, the PBX system will route calls based on the Extension's Default Trunk setting. If that isn't configured or is unavailable, the call will not be routed and the Extension will be unable to call out.

It is possible to bypass the Digit Map configuration by dialling a Trunk specifically, for instance dialling "001" to select the first SIP Trunk then dialling the number.

This guide demonstrates how to configure the Digit Map entries to perform possibly useful functions such as adding a local area prefix to short local numbers.

To configure a Digit Map entry, go to [IP PBX] > [Dial Plan] > [Digit Map]:

All Calls through specified Trunk

To force all calls to go through a specified Trunk interface, set the Min and Max Length values so that they would cover any calls made through the system, in this example 1 to 15 digits.

For the Match Prefix, specify that as "?" which is the wildcard character. This means that any number between 1 and 15 digits in length would go through SIP-1-DrayTEL trunk in this example.

The wildcard character with no other prefix is effectively a "catch-all" rule; this should be placed after all other Digit Map entries so that other Digit Map entries are still processed.

Local Calls

To put calls with a local number prefix through a specified Trunk, set the Match Prefix to the local number's prefix and set the Method to None because the PBX does not need to alter the number. Specify the length to include the calls that would be made and select the Trunk to use:

To have the PBX system add on the local prefix for numbers that are dialled without the prefix, set the Length to include only the shorter numbers, in this example, only numbers are 6 digits long will be affected by this entry. The Method is set to Add so that it will add on the Operand Number for calls that match the length.

When the number matches the length, the PBX adds on the Operand Number, which is set as the local prefix and routes the call through the specified trunk:

To have the PBX system add on specific prefix numbers when dialling a single digit, use the Replace Method, which in this example replaces the number 7 with the numbers "0207" as the prefix for the number:

Select Trunk with Prefix

When configuring multiple Trunks or configuring a system that would require a specific number dialled to call an outside line, set the Match Prefix to the number to be used as the prefix, set the Method to Strip and set the Operand Number to match the Match Prefix.

When there is a match, the PBX would strip the number "9" from numbers matching the Digit Map entry, so that the Trunk can process the call normally:

Alternatively, calls can be routed based on the Match Prefix, for instance to route local numbers through a specific trunk, configure the Match Prefix to the local prefix required, set the Method to None and specify the Trunk to route the call through:

Digit Map Priority

This is an example of Digit Map entries in an order that will work well; specific numbers are at the top of the list so that they are processed first, then the two entries with "?" as the Match Prefix are the lowest priority.

Digit Map Entry 4 is higher priority than Entry 5 because it matches only a specific length. Entry 5 has an unspecific length and no specific prefix so it will catch all remaining numbers that do not match the preceding entries: