Mailing List
Mailing List
Sign Up Here
Like, follow & share: visit DrayTek UK's Facebook page visit DrayTek UK's Twitter page visit DrayTek UK's Linkedin page

VigorBX 2000 - Digit Map Examples

VigorBX 2000
Local Calls
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]:

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.

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:


To route emergency numbers through the PBX system to a PSTN Trunk or other Trunk interface, specify the number required with a Min / Max Length as the length of the number so that only that number would be affected by this rule. Specify the Trunk as required:

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:


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:




How do you rate this article?

1 1 1 1 1 1 1 1 1 1

Add a comment to this article

In the below box, you can add comments which you consider might be helpful to other users reading this article:

(As you'd like it to appear on the comment)

NOTE : All comments are reviewed before publication and may not be posted or may be redacted if the editors do not consider them helpful. The use of offensive or obscene language, copyrighted material, or advertising or promotion or linking to any other product or service is prohibited. By submitting your comment, you confirm that you are the original author and assign copyright of the content to DrayTek indefinitely and irrevocably.