Currently the support for region specific configuration files is limited to dial plan templates. Region specific configuration files for gateways and phones will be introduced in later releases.

To provide a dial plan template for a region, include a directory region_rid (where rid is the region ID corresponding to that region) with the template file dialrules.beans.xml in the localization package.

For information about the creation of a dial plan template, please see the page How to Localize the Dial Plan. The information and tips below may be helpful when completing this step.

Information Required for a Dial Plan Template

To create a new dial plan template, you have to gather the following information for your region:

• PSTN prefix (if any) for local calls, long distance calls, international calls, calling to mobile phones, calling to information services and calling to emergency numbers.
• Area codes or starting digits of area codes used for normal long distance numbers, location independent long distance numbers, tool free numbers, special tariff numbers (premium rate services, adult phone lines, entertainment phone numbers, etc.) and mobile phone numbers.
• Telephone numbers for paid information services and telephone numbers for free information services (if any).
• Emergency telephone number (central emergency phone number, fire department, police, ambulance, etc.).

Dial Plan Template File Name and Format

With the above information ready, you must create appropriate rules in the format of a beans XML file stored in the UTF-8 format. The file name is this XML file must be dialrules.beans.xml - the directory name (region_rid) in which the file is stored determines the region that uses this template.

Region Specific Bean IDs

When defining beans, it is necessary to use unique bean IDs in your template. The recommended approach is to use a region identifier as the prefix for each bean ID. For example, for the United Kingdom dial plan template, the following bean IDs could be used:

• uk.voicemailRule
• uk.attendantRule
• uk.emergencyRule
• uk.oldEmergencyRule
• uk.nonUrgentEmergencyRule
• uk.longDistanceRule
• uk.locationIndependentRule
• uk.premiumRate
• uk.basicRate
• uk.nationalRate
• uk.tollFreeRule
• uk.infolineRule
• uk.mobileRule
• uk.internationalRule

Parent Rules

For each bean, use an appropriate default rule as its parent. For example, the basic long distance rule for a region should use defaultLongDistanceRule as its parent. Other long distance rules for the same region should then use this basic long distance rule as their parent. In the case of the United Kingdom, the uk.longDistanceRule should use defaultLongDistanceRule as its parent and other long distance rules (uk.locationIndependentRule, uk.premiumRate, uk.basicRate, uk.nationalRate and uk.tollFreeRule) should use uk.longDistanceRule rule as their parent.

Dial Plan Template Example

An example of a dial plan template for the United Kingdom defines the beans listed above. When creating rules, make sure to:

• Specify only one number in the "emergencyNumber" property (multiple rules are required if you have more than one emergency number)
• Separate multiple area codes in the "areaCodes" property only by comma (spaces are not permitted)
• List all beans with dial plan rules in the last bean (e.g., uk.dialPlan) that defines all rules included in your dial plan template