Features/Auto Provisioning/Configuration Files/XML

From Snom User Wiki

Contents 1 Introduction 2 Supported Container Tags and Sub Tags 2.1 Setting Files Container <setting-files> 2.2 Settings Container <settings> 2.3 Firmware File <firmware-settings> 3 Structure 4 Example Structure 5 Function Key Index Range D3xx Phones/Funktionstasten-Indexbereich D3xx-Telefone

Introduction

With firmware version 7 snom introduces a new Mass Deployment concept based on XML formatted setting files. Additionally the new concept allows to build up more complex file structures. These structures and all supported XML tags will be described in detail below.

Supported Container Tags and Sub Tags

Setting Files Container <setting-files>

• Syntax
• Example

{{#tree:openlevels=3|root=Setting Files Container <setting-files>|

• URL Phone Settings File
  • Syntax
  • General Settings File Example
  • Specific Settings File Example
• URL Function Key Settings File
  • Syntax
  • Example
• xml replacement plans
  • Syntax
• URL Directory Settings File
  • Syntax
  • Example
• URL Dial Plan Settings File
  • Syntax
  • Example
• URL Uploads File
  • Syntax
  • Example
• URL Certificate Files
  • Syntax
  • Example
• URL Phone User Interface Language File Container
  • URL Phone User Interface Language Translations <phrases>
• URL Web User Interface Language File Container
  • Web User Interface Language Translations <w_phrases>

}}

Settings Container <settings>

• Syntax
• Example

{{#tree:openlevels=2|root=Settings Container <settings>|

• Phone Settings Tag <phone-settings>
  • Syntax Example
  • General Settings Example
  • Specific Settings Example
• Function Key Settings Tag <functionKeys>
  • Syntax Example
  • Example
• xml replacement plans
  • Syntax
• Directory Settings Tag <tbook>
  • Syntax Example
  • Example
• Dial Plan Settings Tag <dialplan>
  • Syntax Example
  • Example
• Uploads Tag <uploads>
  • Syntax Example
  • Example
• Certificate Files Tag <certificates>
  • Syntax Example
  • Example

}}

Firmware File <firmware-settings>

• Syntax Example
• Example

Structure

1. One "general setting file container <setting-files>" per phone type, i.e. snom300, snom320 etc., providiong a list of setting file URLs linked to:
   1. One "settings container (<settings>)" per phone type containing general configuration parameters grouped in XML tags (<phone-settings>, <functionKeys>, <tbook>, <dialplan>) OR/AND individual XML Settings Files per phone type containing general configuration parameters:("Phone settings setting file", "Function key setting file", "Directory setting file", "Dial plan setting file")
   2. One "Phone user interface language file container" per phone type with a list of phone user interface language file URLs
   3. One "Web user interface language file container" per phone type with a list of web user user interface language file URLs
2. One "specific setting file container <setting-files>" per phone, i.e. MAC address based, providing a list of setting file URLs linked to:
   1. One "settings container (<settings>)" per phone containing phone specific configuration parameters grouped in XML tags (<phone-settings>, <functionKeys>, <tbook>, <dialplan>) OR/AND individual XML Settings Files one per phone containing phone specific configuration parameters:("Phone settings setting file", "Function key setting file", "Directory setting file", "Dial plan setting file")
3. Firmware setting files contains a subset of firmware related configuration parameters allowing automated firmware updates

Example Structure

You can download the following example structure and unpack it into your web server root directory. Remember you have to adapt the files according your needs.

Function Key Index Range D3xx Phones/Funktionstasten-Indexbereich D3xx-Telefone

• Index ranges of the freely programmable function keys with LEDs or with selflabelling display labels on D3xx phones and their expansion modules.
• Indexbereiche der frei programmierbaren Funktionstasten mit LEDs oder mit selbstbeschriftenden Displayflächen auf den D3xx-Telefonen und ihren Erweiterungsmodulen.

Language	Format	Size	Revision	Notes
English Deutsch	PDF PDF	45 KB 46 KB	1.0 1.0	Function key index ranges D315, D345, D375 Funktionstasten-Indexbereiche D315, D345, D375