D 14049.01
07.2007
173
TANDBERG VIDEO COMMUNICATION SERVER
ADMINISTRATOR GUIDE
Text goes here
Introduction
Getting
Started
System
Overview
System
Configuration
H.323 & SIP
Configuration
Registration
Control
Zones and
Neighbors
Call
Processing
Firewall
Traversal
Bandwidth
Control
Maintenance
Appendices
TANDBERG VIDEO COMMUNICATION SERVER
ADMINISTRATOR GUIDE
Appendices
Unsupported CPL Elements
The VCS does not currently support some elements that are described in the CPL RFC. If an
attempt is made to upload a script containing any of the following elements an error message will
be generated and the VCS will continue to use its existing policy.
The following elements are not currently supported:
time-switch
string-switch
language-switch
priority-switch
redirect
mail
log
subaction
lookup
remove-location
•
•
•
•
•
•
•
•
•
•
CPL Script Actions
location
As the CPL script is evaluated it maintains a list of addresses (H.323 IDs, URLs and E.164
numbers) which will be used as the destination of the call if a proxy node is executed. The location
node allows the location set to be modified so that calls can be redirected to different destinations.
At the start of script execution the location set is initialized to empty for incoming calls and to the
original destination for outgoing calls.
The following attributes are supported on location nodes. It supports the use of Regular
Expressions (see Regular Expression Reference for further information).
Clear = “yes” |
“no”
Specifies whether to clear the current location set before adding the
new location. The default is to append this location to the end of the
set.
url=string
The new location to be added to the location set. The given string
can specify a URL (e.g. user@domain.com), H.323 ID or an E.164
number.
priority=<0.0..1.0>
| “random”
Specified either as a floating point number in the range 0.0 to 1.0,
or random, which assigns a random number within the same range.
1.0 is the highest priority. Locations with the same priority are
searched in parallel.
regex=”<regular
expression>”
replace=”<string>”
Specifies the way in which a location matching the regular expression
is to be changed.
proxy
On executing a proxy node the VCS will attempt to forward the call to the locations specified in
the current location set. If multiple entries are in the location set then this results in a forked call.
If the current location set is empty the call will be forwarded to its original destination.
reject
If a reject node is executed the VCS stops any further script processing and rejects the current
call. The custom reject strings status=string and reason=string options are supported
here.
rule-switch
This extension to CPL is provided to simplify administrator policy scripts that need to make
decisions based on both the source and destination of the call. A rule-switch may contain any
number of rules that are tested in sequence; as soon as a match is found the CPL within that rule
element is executed. Each rule must take one of the following forms:
<rule origin=”<regular expression>” destination=”<regular expression”>
<rule authenticated-origin=”<regular expression>” destination=”<regular
expression”>
<rule unauthenticated-origin=”<regular expression>” destination=”<regular
expression”>
<rule registered-origin=”<regular expression>” destination=”<regular
expression”>
<rule originating-user=”<regular expression>” destination=”<regular
expression”>
<rule originating-zone=”<regular expression>” destination=”<regular
expression”>
The meaning of the various origin selectors is as described in the Field parameter of address-
switch.
Overview
CPL Reference