Dialing Plans for Digit Collection

The Dial Plan described in this section is for backward compatibility purposes only. For the new Dial Plan method, see Configuring Dial Plans.

The device enables you to configure multiple dialing plans in an external Dial Plan file, which can be installed on the device. If a Dial Plan file is implemented, the device first attempts to locate a matching digit pattern in a specified Dial Plan index listed in the file and if not found, attempts to locate a matching digit pattern in the Digit Map (see the procedure described later on in this section).

It may be useful to configure both Dial Plan file and Digit Maps. For example, the Digit Map can be used for complex digit patterns (which are not supported by the Dial Plan file) and the Dial Plan can be used for long lists of relatively simple digit patterns. In addition, as timeout between digits is not supported by the Dial Plan, the Digit Map can be used to configure digit patterns that are shorter than those in the Dial Plan or left at default (MaxDigits parameter). For example, the “xx.T” digit map instructs the device to use the Dial Plan and if no matching digit pattern is found, it waits for two more digits and then after a timeout (TimeBetweenDigits parameter), it sends the collected digits. This ensures that calls are not rejected as a result of their digit pattern not been completed in the Dial Plan.
This section is applicable only to the Gateway application.

The Dial Plan is used for the following:

: The file allows the device to know when digit collection ends, after which it starts sending all the collected (or dialed) digits in the outgoing INVITE message. This also provides enhanced digit mapping.

The Dial Plan file can contain up to 8 Dial Plans (Dial Plan indices), with a total of up to 8,000 dialing rules (lines) of distinct prefixes (e.g. area codes, international telephone number patterns) for the PSTN to which the device is connected.

The Dial Plan file is created in a textual ini file with the following syntax:

<called number prefix>,<additional digits to wait before sending>
Each new Dial Plan index begins with a Dial Plan name enclosed in square brackets "[...]" on a new line (e.g., [PLAN1]).
Each line under the Dial Plan index defines a dialing prefix and the number of digits expected to follow that prefix. The prefix is separated by a comma "," from the number of additional digits. For example, "052,8" means that the prefix is 052 followed by eight additional digits.
The prefix can include numerical ranges in the format [x-y], as well as multiple numerical ranges [n-m][x-y] (no comma between them).
The prefix can include the asterisk "*" and number "#" signs.
The number of additional digits can include a numerical range in the format x-y.
Empty lines are ignored.
Lines beginning with a semicolon ";" are ignored. The semicolon can be used for comments.

Below shows an example of a Dial Plan file (in ini-file format) containing two dial plans:

[ PLAN1 ]
; Destination cellular area codes 052, 054, and 050, followed by eight digits:
052,8
054,8
050,8

; Destination International prefixes 00, 012, and 014, followed by 7 to 14 digits:
00,7-14
012,7-14
014,7-14

; Destination emergency number 911 (followed by no additional digits):
911,0
[ PLAN2 ]
; Destination area codes 02, 03, and 04, followed by seven additional digits:
0[2-4],7

; Destination operator services starting with the star key *41, *42, and *43 (followed by no additional digits):
*4[1-3],0

The following procedure provides a summary on how to create a Dial Plan file and select the required Dial Plan index.

To configure a dial plan:
1. Create a new file using a text-based editor (such as Notepad) and configure your Dial Plans, as required.
2. Save the file with the ini file extension name (e.g., mydialplans.ini).
3. Convert the ini file to a dat binary file, using AudioCodes DConvert utility. For more information, refer to DConvert Utility User's Guide.
4. Install the converted file on the device, as described in Loading Auxiliary Files.
5. Select the Dial Plans you want to use and configure a digit map:
a. Open the DTMF & Dialing page (Setup menu > Signaling & Media tab > Gateway folder > DTMF & Supplementary > DTMF & Dialing).
b. In the 'Dial Plan Index' field, enter the Dial Plans by index number that you want to use. The parameter can be set to 0 through 7, where 0 denotes PLAN1, 1 denotes PLAN2, and so on.
c. In the 'Digit Mapping Rules' field, enter the digit map.

6. Click Apply.
The Dial Plan file must not contain overlapping prefixes. Attempting to process an overlapping configuration by the DConvert utility results in an error message specifying the problematic line.
The Dial Plan index can be selected globally for all calls (as described in the previous procedure), or per specific calls using Tel Profiles.
It may be useful to configure both Dial Plan file and Digit Maps. For example, the Digit Map can be used for complex digit patterns (which are not supported by the Dial Plan file) and the Dial Plan can be used for long lists of relatively simple digit patterns. In addition, as timeout between digits is not supported by the Dial Plan, the Digit Map can be used to configure digit patterns that are shorter than those defined in the Dial Plan or left at default (MaxDigits parameter). For example, the “xx.T” digit map instructs the device to use the Dial Plan and if no matching digit pattern is found, it waits for two more digits and then after a timeout (TimeBetweenDigits parameter), it sends the collected digits. Therefore, this ensures that calls are not rejected as a result of their digit pattern not been completed in the Dial Plan.
By default, if no matching digit pattern is found in both the Dial Plan and Digit Map, the device rejects the call. However, if you set the DisableStrictDialPlan parameter to 1, the device attempts to complete the call using the MaxDigits and TimeBetweenDigits parameters. In such a setup, it collects the number of digits configured by the MaxDigits parameters. If more digits are received, it ignores the settings of the parameter and collects the digits until the inter-digit timeout configured by the TimeBetweenDigits parameter is exceeded.