Skip to end of metadata
Go to start of metadata

In order to route calls, the VX system must be configured to recognize different sets of called numbers in order to route calls. A call from a phone in a Chicago office in to another phone in that same office will be routed differently than a call from that same phone to an office in Tokyo or Berlin. A key part of the call routing decision for these calls is recognizing a pattern in the destination phone number, for example: calls to the Berlin office may start with a "6" (e.g., 6-1234), calls to Tokyo office might start with a "7" and calls to the Chicago might start with a "3". In the VX system, a setting for recognizing a phone number pattern is called a Match Rule.

In routing a call, the called phone number may need to be shortened, lengthened or otherwise manipulated in order to reach its destination, for example: when routing a call from one VX node to another VX node via SIP protocol, the called number must have the IP address of the receiving VX node appended to the called number (e.g., 51234@ In the VX system, a setting for manipulation of phone numbers is called a Translation Rule.

In VX, there are two primary ways to match and translate phone numbers:

  • VX Rules - A simple syntax for matching and transforming phone numbers supported by VX. This syntax is a good choice for most number matching and transformation tasks.
  • Regular Expressions - An industry standard technology for text pattern matching and manipulation. This syntax is very powerful, but requires a bit of effort to learn and apply. Regular Expressions are a good choice if you have complex number matching and manipulation requirements or are already using this syntax for similar tasks.

Number matching and translation rules are primarily used in to recognize destination (called) phone numbers in Call Route Entries. However, matching and translation rules can also be applied to Calling Numbers (the phone number representing the source of the call).

VX Rule Syntax

VX Match Rule Syntax

When a called number arrives a VX system, the system matches the called number to the rule in its list. This rule is the input rule in the VX node.

The input rule not only decides which routing rule to match it also decides which part of the called number to store. The characters shown in Table 7 (as well as regular expressions) can be used in the input rule.

Routing Table Input Rule Definitions



{ }

All contents within the brackets are stored to be output


Matches a single digit: 0 - 9


Matches a single digit: 2 - 9. (This number can not be 0 or 1)


Wildcard that matches a single digit: 0 - 9, *, # and A - D


Wildcard that matches any number of digits.

The X and N matching settings are automatically disabled when processing any input address that contains an @ symbol (for example, H.323 or SIP).

Do not use the + or $ wildcard character for call routes that support Trunk Groups that are set for receiving overlap dialing. Only the X wildcard is supported for overlap dialing.

A simple input rule of {+} takes all the called digits provided and stores them for the output rule. The input rule also supports escaping any character with a backslash '\' to disable any special meaning it may have and treat it as a literal character. For example, '+' is a wildcard that matches any number of digits, but ' will match only the actual plus sign character. To match a backslash, use a double backslash:



VX Translation Rule Syntax

The output rule specifies the digits to be forwarded to the output trunk. It can be any alphanumeric character or the stored digits from the input rule. A simple output rule would be 123456. This does not involve the input rule in any way. A simple output rule using the input number stored would be \1.

The system can store a maximum of 9 stored numbers. Each set of brackets represents a different stored number. The examples below show how more advanced matching rules can be performed. Output parameters are numbered from left to right starting with the first set of curly brackets.

VX Rule Examples

Input Number

Input Rule

Output Rule

Output Number

1 704 777 5678 1

1 {704} {+}

\1 \2

704 777 5678


01146 {+}


88 555 4745


011{46 +}


46 555 4745


09 1 {+}



1- 703 361-5566

17{X}{X} {+}


703 361-5566

1- 703 361-5566

17{$}{$} {+}



1- 703 361-5566

1{7$$ +}


703 361-5566


{1} {800} {+}

1 800\3



{1}{703} {+}








011 46 {+}




{011} {46} {+}

\2 \3

46 555-4745

  • No labels