Skip to main content

Template Parameter

When the PBX generates the provisioning files for VoIP phones, it uses templates for the configuration files. Those templates may be changed on system, tenant and even on extension level; however in most cases those changes make upgrades difficult and can easily break the provisioning process.

Because of this, there are template parameters for most provisioning templates. For example, the location of firmware files can easily be set through the template parameter page.

Like the templates, the parameters can be set on system, tenand and extension level. The system will first search for extension, then tenant and then system level for a modified parameter. This is independent from finding the template itself.

Many templates also provide "general" parameters. Those parameters contact a generic way of appending additional information to the templates. Typically this way, any setting available for the device can be set. If the setting is already defined in the template, the generic parameter is inserted in the file in a place that will allow the overriding of the setting (e.g. at the end of the file).

For example, for snom phones you can set a custom background image by setting the snom General parameter to something like this:

<action_log_on_url perm="RW">https://server/rest/login</action_log_on_url>
<action_log_off_url perm="RW">https://server/rest/logout</action_log_off_url>

A star behind the parameter name shows that the parameter was changed from its default.