Cisco Acano X-series Developer's Guide

Page of 147
Cisco Meeting Server Release 2.0 : API Reference Guide
76
8.5 DialTransform Methods
When dial transforms are applied to all outbound calls, then the outbound dial plan rules are
applied to the transformed number.
You can use the Web Admin Interface Configuration > Outbound Calls page to control how
dialed numbers are transformed. For example, the dial plan in the screen shot below ensures
that outbound "+1" (US) calls use one Call Bridge and +44 (UK) calls use another.
However, you need to use the API for dialTransforms if you use Call Bridge clustering, because
the shared coSpace database is a single configuration location for all Call Bridges. In a cluster
you do not need to configure the dialTransforms separately on each Call Bridge. The
dialTransforms for the cluster are those defined on the Call Bridge host server (Meeting Server
or virtualized deployment) that is co-located with the first coSpace database in the database
cluster. Although the same dialTransforms are applied to all Call Bridge in the cluster, the
outbound dial plan rules can be configured per-Call Bridge as described
.
There are three stages to the transform
n
A “type” is applied, which breaks the input number/string into components $1, $2 etc.
n
The components are matched using regular expressions to see if the rule is valid
n
An output string is created from the components according to the defined transform
See the
below.
Note: A phone URI is recognized as a purely numeric string (optionally prefixed by a ‘+’) when it
begins with a valid international dial code (e.g. 44 for UK or 1 for US) followed by the correct
number of digits for a phone number for that region.
8.5.1 Retrieving dial transforms
GET method performed on the “/dialTransforms” node.
Parameters
Type/Value
Description/Notes
offset
limit
Number
Number
An "offset" and "limit" can be supplied to retrieve elements other than the first
"page" in the notional list (see
above
).
filter
String
Enter a filter to retrieve only those dial transforms that match the strong.
8   Call Related Methods