CounterPath X-Lite 3.0 User Guide - Manual (Page 58)

CounterPath X-Lite 3.0
56
The dialing plan has the following syntax:
pattern[|pattern];match=1;<transformation>=<value>;[match=2;
<transformation>=<value>;]
...where:
• Items contained within [] brackets are optional.
• pattern — represents the pattern that X-Lite will match to user input. A dialing plan can have one or
more patterns, with each pattern separated by a “ | ” (pipe character). The pipe is optional after the last
pattern. Patterns form an ordinal sequence, starting with 1 (“ match ” elements identify individual
patterns—see below).
• match; transformation — represents a pair that identifies the pattern (within the ordinal sequence
of patterns) to compare with the input, and the optional transformation (or transformations) to perform on
the input once X-Lite finds a match. A dialing plan can have one or more match/transformation pairs.
“
match= ” is a literal, with the number identifying the corresponding pattern. Specific keywords replace
“ transformation= ” (see above). Appropriate values replace “ value .”
Spaces are allowed only within <value> elements.
Pattern
Valid Content
The content for a pattern follows digit map rules from RFC 2705, supplemented by the rules for regular
expressions. Where there is an overlap between digit map rules and regular expression rules, digit map rules
take precedent. For this reason there are some special cases, included in the table below.
The following table describes the most common dialing plan pattern elements. As mentioned, all regular
expression elements are supported.
To Specify a... Enter the following... Comment
Digit One of 0-9 Represents a specific numeric digit.
Digit [digit-digit] Represents a specific digit within a given range.
Digit [digit-digit, digit, digit-digit] Represents a specific digit within a comma-separated range of digits that may
be discontinuous.
Character # * + a-z Represents a specific non-numeric character.
• Use “\x” to represent “x”
• Use “\t” to represent “t”
Note that “\a” indicates a special kind of wildcard character and should not be
confused with representing a specific “a” character (see below).
Character [character-character] Represents a specific character within a given range.
Wildcard x Represents any numeric digit from zero to nine.
Wildcard \a Represents any non-numeric character from among the allowed non-numeric
characters (see above).
Wildcard . Represents an arbitrary repetition of the last digit zero or more times. A pattern
of “xxxx.” would indicate that matched user input would comprise three or
more numeric digits between zero and nine (the “.” indicates that the final “x”
can be repeated zero or more times).