Canonical Address Format

If VTScada is to use the system's modem dialing rules then the phone number to be dialed must be given in canonical format.

The canonical address format is intended to be a universally constant directory number; for this reason, numbers in address books are best stored using canonical format.

A canonical phone address is a text string with the following structure:

+ CountryCode SPACE [(AreaCode) SPACE] SubscriberNumber | Subaddress ^ Name CRLF …

The components of this structure:

Component Meaning
+ Equivalent to hex 2B. Indicates that the number that follows it uses the canonical format.
CountryCode A variably-sized string containing one or more of the digits "0" through "9" (hex 30 through 39 inclusive). The CountryCode is delimited by the SPACE that follows it. It identifies the country/region in which the address is located.
SPACE Exactly one space character (hex 20). It is used to delimit the end of the CountryCode portion of the address.
AreaCode A variably-sized string containing zero or more of the digits "0" through "9" (hex 30 through 39 inclusive). AreaCode is the area code portion of the address, and is optional. If the area code is present, it must be preceded by exactly one left parenthesis character (28), and be followed by exactly one right parenthesis character (29) and one space character (20).
SubscriberNumber A variably-sized string containing one or more of the digits "0" through "9" (hex 30 through 39, inclusive). It may include other formatting characters as well, including any of the dialing control characters described in the Dialable Address Format

 Character

Hex Encoding

 !

20

 

23

 $

24

 *

2A

 ,

2C

 ?

3F

 @

40

 ABCD

41-44

 P

50

 T

54

 W

77

 abcd

61-64

 p

70

 t 

4

 w 

9

The subscriber number should not contain the left parenthesis or right parenthesis character (these are used only to delimit the area code), nor should it contain the pipe (|), carat (^), or CRLF characters (which are used to begin following fields).
Most commonly, non-digit characters in the subscriber number would include only spaces, periods (.), and dashes (-). Any allowable non-digit characters that appear in the subscriber number are omitted from the DialableString returned by the LineTranslateAddress function, but are retained in the DisplayableString.
| Hex (7C). If this optional character is present, the information following it up to the next + | ^ CRLF, or the end of the canonical address string, is treated as sub address information, as for an ISDN sub address.
Subaddress A variably-sized string containing a sub address. The string is delimited by + | ^ CRLF or the end of the address string. During dialing, sub address information is passed to the remote party. It can be such things as an ISDN sub address or an email address.
^  Hex (5E). If this optional character is present, the information following it up to the next CRLF or the end of the canonical address string is treated as an ISDN name.
Name A variably-sized string treated as name information. Name is delimited by CRLF or the end of the canonical address string and can contain other delimiters. During dialing, name information is passed to the remote party.
CRLF Hex (0D) followed by Hex (0A), and is optional. If present, it indicates that another canonical number is following this one. It is used to separate multiple canonical addresses as part of a single address string (inverse multiplexing).

For example, the canonical representation of the main switchboard telephone number at Trihedral is:

+1 (902) 835-1575