PBX Configuration - SIP Tab (IP SIP) - Translation Rules Dialog Box

This topic describes how to use the Translation Rules dialog box to configure translation rules for the voice mail domain.


Notes: An MAS uses the translation rules to convert numbers in switch-native format to canonical numbers when receiving inbound calls. Similarly, when making outbound calls the canonical numbers are converted to switch-native format. In a MultiSite-enabled voice mail domain, the translation rules replace the following: Rules configured on the Dialing Rules node. Outcalling Restrictions configured on the Caller tab of the Telephone User Interface node. If MultiSite is enabled, these options are removed from the Voice Mail Configuration System.

Launching the Screen

In the Voice Mail System Configuration window, click the voice mail domain (VMD).

Double-click PBXs. The system expands the node to show all available types of PBX.

Double-click the IP SIP PBX. The system displays the PBX Configuration dialog box for the selected PBX, with the General tab active.

Click the IP SIP tab.

Click Configure to open the Translation Rules dialog box.

Configuring the Screen Controls

Test Inputs Use to enter different types of phone numbers that you expect the MAS to handle. These phone numbers are used to test whether they are successfully matched by an incoming rule to produce a canonical number, and whether canonical number is also successfully matched by the corresponding outgoing rule.

Add Click to add a phone number.

Delete Click to delete the selected phone number.

Incoming translation rule Use to describe the incoming phone number translation rules for converting phone numbers from switch-native form to canonical form.

Description Enter a description of the type of call the translation rule will be applied to. For example, local switch extension, national, international, or premium-rate number.

Add Click to add a phone number translation rule.

Delete Click to delete the selected phone number translation rule.

Move Up/Move Down Click to move the selected rule up or down in the list.

Match Enter the regular expression to be used for the translation rule.

Output Enter the set of characters from the corresponding group in the match part of the rule.

The output of an incoming phone number translation rule falls into one of the following categories:

The input for a incoming translation rule is a switch-native number. If the rule does not match the input then there is no output, and the next rule is evaluated.

If the rule produces an output that starts with a leading ‘+’ sign then it is a terminating rule – no further rules are evaluated because a canonical number is produced. In this case, the output is taken as the final output of the rule set.

If the rule produces output that does not start with a leading ‘+’ sign then it is a transforming rule, and the output becomes the new input for the next rule. If no output is produced after the final rule has been evaluated, or the output is not canonical, then the input dial string is deemed to be invalid.

Outgoing translation rule Use to describe a matching set of outgoing phone number translation rules for converting from canonical form into switch-native format.

Description Enter a description of the type of call the translation rule will be applied to. For example, local switch extension, national, international, or premium-rate number.

Add Click to add a phone number translation rule.

Delete Click to delete the selected phone number translation rule.

Move Up/Move Down Click to move the selected rule up or down in the list.

Match Enter the regular expression to be used for the translation rule.

Output Enter the set of characters from the corresponding group in the match part of the rule.

The output of an outgoing phone number translation rule falls into any of the following categories:

The input for a outgoing translation rule is a canonical number. The rules are evaluated from top to bottom. If the rule does not match the input then there is no output, and the next rule is evaluated.

If the rule produces an output that is recognized by the Private Branch Exchange (PBX) then it is a terminating rule – no further rules are evaluated because a switch-native number is produced. In this case, the output is taken as the final output of the rule set.

Cost Enter a number from 0 to 10000 for each translation rule. The cost indicates how expensive it is to dial the number that matches a certain rule. When a terminating outgoing translation rule produces a switch-native phone number, the cost associated with that call is validated against the voice mail domain-wide setting for making outbound calls. For more information on costs controlling outbound calls see Sites Dialog Box.

The costs specified for outbound calls control whether, for example, a subscriber is allowed to call just the local extensions, or national, international, or premium rate numbers.