beautypg.com

Cpl script actions, Location – TANDBERG Gatekeeper User Manual

Page 55

background image

TANDBERG Gatekeeper User Guide

Page 55 of 105

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

Selected field and subfield exactly match the given string.

contains=

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.

subdomain-of=

string

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.

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.

location

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"

S

pecifies 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

T

he new location to be added to the location set. The given string can specify a URL

([email protected]), H.323 ID or an E.164 number.

The

location

node supports the use of Regular Expressions (see Appendix C for further information).