96
D14049.05
February 2009
Grey Headline
(continued)
TANDBERG
VIDEO COMMUNICATIONS SERVER
ADMINISTRATOR GUIDE
Introduction
Getting started
Overview and
status
System
configuration
VCS
configuration
Zones and
neighbors
Call
processing
Bandwidth
control
Firewall
traversal
Appendices
Applications
Maintenance
Searches and transforms
Configuring pre-search transforms
The
Transforms
page lists all the pre-search
transforms currently configured on the VCS,
and allows you to create, edit and delete
transforms.
To go to the
Transforms
page:
VCS configuration > Transforms
•
.
To configure pre-search transforms using the
CLI:
xConfiguration Transform [1..100
•
]
.
The configuration options are:
Priority
Assigns a priority to this transform. Priority can
be from
1
to
65534
, with 1 being the highest
priority. Transforms are applied in order of
priority, and the priority must be unique for each
transform.
Pattern string
Specifies the pattern against which the alias is
compared.
Pattern type
Determines the way in which the string must
match the alias. Options are:
Exact
: the string must match the alias character
for character.
Prefix
: the string must appear at the beginning
of the alias.
Suffix
: the string must appear at the end of the
alias.
Regex
: the string will be treated as a regular
expression.
Pattern behavior
Determines how the matched part of the alias
will be modified. Options are:
Strip
: the matching prefix or suffix will be
removed from the alias.
Replace
: the matching part of the alias will be
substituted with the text in the
Replace String
.
Replace string
(applies only if
Pattern Behavior
is set to
Replace
)
Specifies the string to be used as a substitution
for the part of the alias that matched the
pattern.
Pre-search transforms support the use
of Regular Expressions in both the
Pattern String
and
Replace String
fields. See the Appendix
Regular expression
reference
for more information.
You can test whether a pattern will
match a particular alias and be
transformed in the expected way by
using the
Check pattern
page (
Maintenance >
Tools > Check pattern
).
About pre-search transforms
The pre-search transform function allows you
to modify the alias in an incoming search
request. The transformation is applied by the
VCS before any searches take place, either
locally or to external zones. It applies to all
incoming search requests received from locally
registered endpoints, neighbor, traversal client
and traversal server zones, and endpoints
on the public internet. It does not apply to
requests received from peers (which are
configured identically and therefore will have
already applied the same transform).
Each pre-search transform defines a string
against which an alias is compared, and the
changes to make to the alias if it matches that
string.
Once the alias has been transformed,
it remains changed. and all further call
processing is applied to the new alias.
Pre-search transforms are not applied
to GRQ or RRQ messages received from
endpoints registering with the VCS;
endpoints will be registered with the alias(es)
as presented in these messages.
Pre-search transforms will be applied
prior to any possible CPL modification
and Zone transforms.
Pre-search transform process
Up to 100 pre-search transforms can be
configured. Each transform must have a unique
priority number between
1
and
65534
.
Every incoming alias is compared with each
transform in order of priority, starting with that
closest to
1
. If and when a match is made, the
transform is applied to the alias and no further
pre-search checks and transformations of the
new alias will take place. The new alias is then
used for the remainder of the
search process
.
Further transforms of the alias may
take place during the remainder of the
search process. This may be as a
result of
Call Policy
(also known as
Administrator Policy) or
FindMe
(also known as
User Policy). If this is the case, the pre-search
transforms are re-applied to the new alias.
Refer to the
search process
diagram for more
information.
If you add a new pre-search transform
that has the same priority as an
existing transform, all transforms with a
lower priority (i.e. higher numerical value) will
have their priority incremented by one, and the
new transform will be added with the specified
priority. However, if there are not enough
“slots” left to move all the priorities down, then
you will get an error message.
Pre-search transforms
