D3 User Manual
X
ML provisioning of settings
The XML tags of the function keys are an exception from the general rules for XML mass provisioning
of settings for Snom phones because the tag for each key specifies the exact settings for that
particular key. The format is as follows:
<fkey idx="1" context="1" label="x"
•
Parameter fkey idx. The unique identifier of the function key when connected to a particular
phone model.
NOTE: The fkey idx of a particular key depends on the number of function keys on the
phone, the number of expansion modules connected to the phone, and the position of
the module in the daisy chain. For your convenience, we have prepared a table of the
numbering system; please see "Function Key Numbering System" on page 18.
•
Parameter context. This setting specifies the identity (account) that can use the key.
◦
All active identities (accounts) registered on the phone: Setting "active"
◦
One identity specified by its number. Example: Setting "1" for Identity 1
•
Parameter label. The label (name, etc.) to be shown on the expansion module's display. On the
Function Keys page of the phone's web interface this is the string entered in the text field of
Short Text.
Parameter default_text. Optional attribute that can be any string. When the parameter label is
•
not set for a key, the value of default_text will be displayed as the key's label on the display of
the D3 (see "Function key content" on page 10). You can define an arbitrary fixed text or use
$name, $state, and $type to insert dynamic information. The default value is "$name $state".
◦
$name: Inserts the label or, if label is not set, the extension/phone number supplied as the
key's argument.
◦
$state: Inserts the key's state (free, busy, etc.) when functions like line or extension are
mapped onto the key.
◦
$type: Inserts the key type.
Parameter perm. Valid values are:
•
-
perm="!": The settings of the key can be changed by mass provisioning, but only if the
end user has not made changes to the configuration on the phone itself or on its web
interface.
-
perm="&", perm="R", perm=" ": The settings of the key are Read Only and cannot be
changed by the end user.
-
perm="$", perm="RW", perm="": The settings of the key can be changed by the end user
but will be overwritten by mass provisioning.
•
Argument.
◦
The default is line. Example:
<fkey idx="19" context="active" label="line"
fkey>.
◦
Examples for other functions:
NOTE: The functions must be supported by your installation/PBX.
-
Extension: <fkey idx="19" context="1" label="Mary" default_text="$name $state"
perm="">dest sip:123@example.com;user=phone</fkey>
default_text="$name
default_text="$name
17
Configuring the Function Keys
$state" perm="">argument</fkey>
$state" perm="">line</