File formats and headers - chan-sccp/chan-sccp GitHub Wiki

An important note to keep in mind is that anytime you push/pull .XML files to and from a telephone set, you must ensure that the file you are sending is not saved using any special formatting. In other words, you must include the correct encoding for it to handle this special formatting.

A good way to do this is to use either your favourite editor such as emacs/vi/joe/nano in Unix/Linux environments or notepad (defaulting to UTF-8) in Windows environments. Saving the file in the default ANSI format should be fine.

This method is the simplest as it also avoids configuring your web server in handling and appending this information, for files which are retrieved by the telephone. However, if you choose to configure your web server to do this, the content type sent by the web server should be set to "text/xml" either with or without encoding depending on your preference and locale.

It is important to always ensure that the following line is included at the top of every .XML document you create. This will eliminate any possibility of the telephone rejecting the file and ensures that it knows the incoming file is to the correct format.

<?xml version="1.0" encoding="ISO-8859-1"?>

If you are using the UTF-8 format, you may use the following instead, however, either will work fine.

<?xml version="1.0" encoding="UTF-8"?>

If you do not specify either of these header formats, the telephone will use the locale information and the character set it has been configured with to interpret the respective file.