location_template

D-SERIES

Web User Interface

Advanced - Behavior (Tab) - Phone Behavior (Section): Location Display Template

Phone User Interface

N/A

Firmware

8.6.7.3

XML Configuration

<location_template perm="PERMISSIONFLAGS">VALIDVALUE</location_template>

Description

This setting defines the template needed for displaying the location information automatically retrieved on phones registered with a Lync server. To display the location information press the menu button on the phone and select Information → Location.

This information is returned from the Location Information Server as a PIDF document with the location information included in the 'civic address' extension of the PIDF document. For details about this extension see RFC 5139.

The location information is essentially an address. Because the 'civic address' format contains a very high level of detail, particularly the elements describing a street address, the usage of the various elements will vary widely form country to country as well as the order in which these elements are typically presented to the user. This template is therefore used to select the required elements from the 'civic address' element inside the PIDF document and embed them in some explanatory text.

To create a template simply combine regular text, 'civic address' elements and line breaks. 'Civic address' elements are identified by surrounding the element name from the civicAddress structure with curly braces ('{' and '}'); a line break is represented by '\n'.

For example, the template

     City: {A3}\nPostal Code: {PC}

might result in the following output:

     City: Berlin
     Postal Code: 10117

For a list of all available civic address elements see RFC 5139 (and RFC 4119 which it extends). Note that not all civic address elements are necessarily populated by the Location Information Server.

To include a curly brace or a backslash () in the regular text it must be preceded by the escape character '\'.

This template extracts 'civicAddress' elements only. Any elements from higher level PIDF structures within this template are ignored.

Valid Values

text

Default Value

US format of civic address:

{NAM}\n{LOC}\n{HNO}{HNS} {PRD} {RD} {STS} {POD}\n{A3}, {A1} {PC}\n{country}