The dial plan settings (<dialplan> or <dial-plan> tag) contain the global dial plan parameters. For further description please see the detailed XML dial plan feature description.
The XML Dial plan can be placed either inside the <settings> tag
or as an individual XML file whose URL is listed inside <setting-files> tag:
The following attributes are allowed:
- e="2" defines that unicode-values inside xml-escapes (e.g. & # 6 4 ;) may be greater than 255.
- MATCH=”pattern” is the dial pattern to match. While entering the pattern: numbers 0-9, * and # represent the keys on the phone that are entered. Use a period (.) to match any key. An asterisk (*) at the very end of the pattern matches one or more characters. Matching just the * key without interference with the wildcard character is done by escaping it with a backslash "\*". To have the phone generate a secondary dial tone when the part of the template matches, use a comma (,). If you want to use * before the comma (,) do not escape it using a backslash, but use it as it is, for example: MATCH="*,..."
- Timeout=”sec” is the number of seconds before a timeout will occur and the number will be dialed as entered by the user. To have the number dial immediately, specify 0.
- User=”type” is the either IP or Phone. Enter User=phone or User=IP to have the tag automatically added to the dialed number. Currently User=phone is supported.
- Rewrite=”altstrng” is the alternate string to be dialed instead of what the user enters. This field can be left empty. Rewrite will rewrite the exact positions. You cannot add any prefix by rewrite method.
- Insert="altstring" is the alternate string to be added at the beginning of what the user enters. Insert can work with rewrites.
- identity=”number” is the identity that is used to establish the call. If no identity is given, the active identity is used.
If desired, specify at the end of each string where comment defines the type of plan (for example, Long Distance or Corporate Dial Plan).
Special note on dialplan nomenclature:
- The special characters supported in 'match' include '.' for any digit between 0-9.
- '*' as a wildcard for all charcaters and digits.
- '[' & ']' to specify a range for single digit input e.g. match="[4-7].." would mean any three digit number where the first digit is either 4, 5, 6 or 7 i.e. 4-7 inclusive of both limits.
- ',' is used to indicate secondary local dialtone. It often follows a digit usually 9 or 0.
- The closest logical match through all the dialplans would be selected for ay given input match. Ascending or descending order does not over rule this feature.
- If one doesn't want to specify a timeout, rewrite or user; either leave them empty or do not include them at all. In this case the default for all would be used.
- The dialplan attributes can be saved either in capital or small letters. The phone would internally store them in lower case.