● $2 is an internal variable containing the called number of this outbound call, after any digit map
transformation in the matched callee object.
● Callee-list can be empty, which implies the single callee object @, which means any called
number. The succeeding ‘:' can be omitted also when callee-list is empty.
● The cid object inside an arg object is optional. If omitted, it implies no caller-ID spoofing when
calling on the specified trunk. The succeeding ‘>' can be omitted if cid is omitted.
● The target object inside an arg object is optional. If omitted, it implies the target $2, which means
to call the original called number after applying any necessary digit map transformation implied by
the rule. The preceding ‘>' can't be omitted if target is omitted but not the cid.
● arg object is optional. If omitted, it implies the arg with the target $2 and no cid.
An outbound call matches a rule if its called number matches one of the callee objects of the rule.
Callee objects are tested in the order left and right, and the first matched callee wins. Rules are also
checked in the order left to right, and the first matched rule wins. Therefore it’s important that you
place the more specific rules first in the OutboundCallRoute if multiple rules can potentially match the
same outbound call.
Every endpoint also has a digit map defined. The user-dialed number is processed with the endpoint's
digit map first before it’s passed to the OutboundCallRoute for routing decision. Therefore the number
used for matching call routing rules has already incurred the transformations, if any, implied by the
digit map. Remember this fact when crafting your own OutboundCallRoute.
OutboundCallRoute Examples
This section provides examples of routing rules for handling outbound calls.
sp1 OR {SP1} OR {:SP1} OR {@:Sp1} (all equivalent)
This rule says: Make all calls using the SP1 Service, without any caller-id spoofing or digit
transformation.
{**0:aa},{***:aa2},{(Mpli):pli},{(<**1:>(Msp1)):sp1},
{(<**2:>(Msp2)):sp2},{(<**9:>(Mpp)):pp}
This is the default OutboundCallRoute for the PHONE port. Based on this, every rule dictates the
following (ordered from left to right):
● Dial **0 to invoke AA1 or AA.
● Dial *** to invoke the local device configuration IVR (or AA2).
● (Mpli) and pli are substituted with the PrimaryLine's abbreviated name.
● Use SP1 Service to call all numbers that start with **1 and subsequent digits matching SP1
Service's DigitMap. Remove the **1 prefix from the resulting number before making the call.
● Use SP2 Service to call all numbers that start with **2 and subsequent digits matching SP2
Service's DigitMap. Remove the **2 prefix from the resulting number before making the call.
62
Chapter 11Call Routing