CounterPath eyeBeam 1.5 User Guide for Mac - Manual (Page 63)

CounterPath eyeBeam 1.5 for Mac
60
Appendix B: Dialing Plan
When a call attempt is made, the call input (what you type, select or drag onto the Call display) is processed to
select the account to use and to modify the input if that is required to ensure that the call gets placed
successfully. This ability to select an account and modify the input relies on the existence of a “dialing plan” for
each account.
The input is processed as follows:
• Cleanup: Input is cleaned up by removing spaces, dashes, open brackets, and close brackets. Cleanup allows
eyeBeam to support calls placed using contacts from a contact list, including Microsoft® Outlook®.
• Matching: The input is compared to the patterns defined by the dialing plan for each enabled account. Each
account has one dialing plan, and each dialing plan has one or more patterns.
When a match is found between the input and the pattern, the account that this pattern belongs to is selected
and the transformation for this pattern is performed.
If no match is found, the default account is selected and no transformation is performed.
For details on matching see “How the Input Is Processed” on page 62.
• Transformation: The selected transformation is performed.
• Then the call is placed using the transformed input.
The Default Dial Plan
The default dial plan is:
#n\a\a.T;match=1;prestrip=2;
where #n is the account prefix (#0 for Account 0, and so on)
If the input is the account prefix and the number, then the Account for this dial plan is selected. The account
prefixed is stripped from the number before the call is placed.
If all Accounts use this dial plan, then the behavior is as follows: if the input includes the account, then that
account is used. In other words, you can force selection of a specific account by including the account prefix. If
the input does not include #n, then the default account is used.
Do You Need to Read this Information?
You do not have to read this dial plan information if the default dial plan behavior (above) is acceptable.
B.1 If you want to be able to place calls on a specific account without including the account prefix, then you
must create a dial plan for one or more accounts. Dialing Plan Syntax
In eyeBeam, the dialing plan establishes the expected patterns of characters for a telephone number or SIP
address, and allows for modification (transformation) of input based on the match to a pattern.
The dialing plan has the following syntax:
pattern[|pattern];match=1;<transformation>=<value>;[match=2;
<transformation>=<value>;]
Where:
• Items in [ ] are optional.
• Pattern: the pattern that will be matched. One or more patterns. Each pattern is separated by a | pipe. The pipe
is optional after the last pattern. Each pattern is implicitly numbered, starting from 1.
• Match; Transformation: A pair that identifies the pattern number to compare with the input, and the
transformation to perform on the input when a match is obtained. The transformation is optional (meaning
that if there is no transformation for a pattern, then the input that matches this pattern is not transformed).
One or more pairs.