Phone Class Resources

Phone Classes are associated to phone lines and used to dial out and represent the dialing rules, based on area codes and country codes. Each phone line has a default Phone Class, which dials the destination number without any modifications. You can define additional Phone Classes to handle local versus long distance calling, 10 digit local calling, multiple local area codes, same area code for local/long distance dialing, etc.

Phone Classes are defined at the Node level and are used for any type of phone lines (serial device resources or voice lines).

Device Engines use the Phone Class associated with a given phone line to determine the dialing methods to use. If all the phone lines are identical, and in the same location, then only one Phone Class needs to be defined, and assigned to all lines.

To accommodate for the various phone systems around the world, you can define exceptions to the Phone Class. To create an exception, first define the number to match against, for example if the area code should be included when evaluating the exception. The second step is to define a pattern to be used to match against the defined number. Lastly, specify the dialing method to define how the phone number will be dialed when the exception is triggered.

Note that when expressions are evaluated the order is important and, starting from the top, the evaluation stops at the first match found. This allows for defining a restrictive expression first, and then following it with more relaxed exceptions if needed.

Detail

Description

Name

Name of the phone class.

Description

Brief description of the phone class.

Country

Country in which the phone line is located. This setting is used to determine how to dial outside the country.

Area/Std Code

Area or STD (Subscribers Trunk Dialing) code in which the phone line is located.

Local Dialing Method

Method for the Phone Class to use when making local calls. For more information, see “Dialing Methods” below.

Long Distance Dialing Method

Method for the phone class to use when making long-distance calls.

International Dialing Method

Method for the Phone Class to use when making overseas or international calls.

Phone Class Exceptions

Phone Class exceptions define special dialing methods for certain Area/STD Codes. Click Add New Phone Class Exceptions Setting to add a new exception, and then enter the following information into the fields provided:

  • Description: A brief description or name for the exception.
  • Number Definition: Defines the number to match against; for example, if the area code should be included when evaluating the exception.
  • Match Expression: Defines a pattern to use when matching against the number definition.
  • Dialing Method: Defines the special dialing method to use if the exception conditions are met. See the following section for more information about dialing methods.

For an example of how to create a phone class exception, see Phone Class Resources.

Dialing Methods

xMatters supports and dials “as is” standard dialing codes, which include the following:

Standard Dialing Code

Dialing Code

Result

0-9, *, #

Dials the corresponding touch-tone digit.

,

Pauses.

&

Issues a hook flash (also known as a "recall"), that simulates quickly hanging up and then picking up again. This can signal the telephone exchange to perform a function such as switching to an incoming call, or indicating a request for voice conferencing.

Note that a hook flash is not currently supported over T-1 lines.

In addition, xMatters supports the following case-sensitive special codes:

Special Dialing Codes

Dialing Code

Result

n

For pagers, dials the contents of the Phone Number field in the Protocol Provider settings. If that field is blank, dials the contents of the Override Phone Number in the Device details for the User (numeric pagers).

For phones, dials the contents of the Phone Number field in the Device details for the User.

a

For pagers, dials the contents of the Area Code field in the Protocol Provider settings. If that field is blank, dials the contents of the Override Area Code field in the Device details for the User.

For phones, dials the contents of the Area Code field in the Device details for the User.

c

Dials the Country code associated with the User, or the Country Code Override defined on the User’s Phone Device.

x

Dials the extension number associated with the User.

eN

Dials the last N digits in the phone number associated with the User.

For example, a long distance dialing method may be defined as “1an”, while an international dialing method may be defined as “011can”.