Cpl Script Actions; Location - TANDBERG Gatekeeper User Manual

address
The address construct is used within an address-switch to specify addresses to match. It supports the
use of Regular Expressions (see Appendix C for further information).
Note: All address comparisons ignore upper/lower case differences so address is="Fred" will
match fred, freD etc.
is=string
contains=string
subdomain-of=string
otherwise
The otherwise node will be executed if the address specified in the address-switch was found but
none of the preceding address nodes matched.
not-present
The not-present node is executed when the address specified in the address-switch was not present
in the call setup message. This form is most useful when authentication is being used. With
authentication enabled the Gatekeeper will only use authenticated aliases when running policy so the
not-present action can be used to take appropriate action when a call is received from an
unauthenticated user (see CPL Examples, section13.5).
13.3.

CPL Script Actions

13.3.1.
As the CPL script runs 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:
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
(user@domain.com), H.323 ID or an E.164 number.
The location node supports the use of Regular Expressions (see Appendix C for further information).
Selected field and subfield exactly match the given string.
Selected field and subfield contain the given string.
Note: The CPL standard only allows for this matching on the display
subfield; however the Gatekeeper allows it on any type of field.
If the selected field is numeric (e.g. the tel subfield) then this
matches as a prefix; so address subdomain-of="555" matches
5556734 etc.
If the field is not numeric then normal domain name matching is
applied; so address subdomain-of="company.com" matches
nodeA.company.com etc.

location

TANDBERG Gatekeeper User Guide
Page 55 of 105