Yealink phonebook generation tool ошибка

You’re currently viewing a stripped down version of our content. View the full version with proper formatting.

В данной статье рассмотрим, как можно создать телефонную книгу для Yealink с помощью инструмента Yealink Phonebook Generation Tool. Данный инструмент создан компанией Yealink и служит для быстрой генерации телефонных книг для телефонов модели Yealink. Скачивание инструмента Для того, чтобы скачать инструмент для генерации телефонной книги, перейдём на официальный сайт Yealink, затем найдём и скачаем нужный […]

В данной статье рассмотрим, как можно создать телефонную
книгу для Yealink с
помощью инструмента Yealink Phonebook Generation Tool.

Данный инструмент создан компанией Yealink и служит для быстрой генерации
телефонных книг для телефонов модели Yealink.

Скачивание инструмента

Для того, чтобы скачать инструмент для генерации телефонной книги, перейдём на официальный сайт Yealink, затем найдём и скачаем нужный архив.

В архиве находится мануал к инструменту на английском языке,
а также сам Phonebook Generation Tool.

Описание инструмента

Перед
тем, как начать работу с Yealink Phonebook Generation Tool,
подробно рассмотрим, что из себя представляет данный инструмент.

В
первой строке прописаны поля, которые нужно заполнить для того, чтобы
сгенерировать телефонную книгу:

               — Department – имя группы контакта;
               — Name – имя контакта;
               — Office Number — рабочий номер контакта. Например, внутренний номер;
               — Mobile Number – мобильный номер контакта;
               — Other Number — ещё один номер контакта, если имеется;

               — Head Portrait – путь к портрету контакта.

Работа с инструментом

Yealink Phonebook позволяет создать как локальную телефонную книгу, так и
удалённую. Подробно рассмотрим, как их создать.

Создание телефонной книги

Для создания локальной телефонной книги откроем инструмент и
заполним вышеописанные поля.

После заполнения полей нажимаем кнопку «Create Remote», если создаём
удалённую телефонную книгу, и «Create Local Phonebook», если
создаём локальную телефонную книгу.

Появится информативное сообщение следующего плана:

На скриншоте видим путь сохранения файла, и как файл
называется. В зависимости от того, какую книгу создаём, файл будет меняться (LocalPhonebook или RemotePhonebook). Директория
хранения телефонной книги по умолчанию – диск C.

Открыть созданную телефонную книгу формата xml можно любым текстовым редактором,
который поддерживает данный формат. Для примера откроем его в Sublime Text.

После того, как телефонная книга была создана, импортируем
её в телефон.

Работа с локальной телефонной книгой

Для того, чтобы загрузить телефонную книгу на телефон модели
Yealink, зайдём в web-интерфейс телефона на
вкладку Контакты в раздел Локальная книга. Здесь в списке Импорт
списка контактов нажмём на кнопку «Выберите файл» над кнопками импорта
и экспорта xml.  Далее выберем созданную телефонную книгу
формата xml и нажмём
кнопку «Импорт XML». Появится сообщение: «Исходный контакт будет скрыт. Продолжать?»
После подтверждения телефонная книга будет импортирована на телефон.

Из скриншота видно, что телефонная книга успешно
импортирована, а группы, которые были прописаны при её создании, автоматически
созданы.

Для доступа к телефонной книги на телефонном аппарате нажмём
кнопку «Контакты», стрелочку вниз или перейдём по пути Меню
-> Контакты -> Контакт локальной записной книги.
Далее выберем группу и раскроем список контактов, входящих в неё

Работа с удалённой телефонной книгой

Для примера в качестве хранилища удалённой телефонной книги
выступит сервер телефонии. Чтобы загрузить удалённую телефонную книгу на
телефон перейдём на вкладку Контакты в раздел Удалённая
книга.

Однако, в связи с тем, что в большинстве случаев поле Department не было заполнено, часть контактов в удалённой телефонной книге
отсутствует.

Решить данную проблему можно, поправив xml-файл удалённой
телефонной книги.

Для этого откроем файл удалённой телефонной книги через
редактор и поправим пустую группу:

<Menu Name="">
     <Unit Name="Анастасия" Phone1="101" Phone2="79245556677" Phone3="" default_photo="Resource:"/>
   </Menu> 

Удалённая
телефонная книга на телефонном аппарате доступна по пути Меню -> Контакты
-> Удалённая телефонная книга. Выбираем Меню, переходим в список
групп. Первая группа без имени. После правки xml-файла, если раскроем пустую группу, в
ней будут прописанные контакты.

Продолжаем цикл статей о телефонных книгах в IP-телефонах Yealink. Рассмотрим особенности локальной телефонной книги.

Локальная телефонная книга хранится в памяти телефона и является уникальной для данного телефонного аппарата. Книга имеет ограничение на количество записей (1000 записей — на стационарных телефонах, 100 записей — на DECT-трубках) и может редактироваться как пользователем, так и администратором телефонной системы.

Настройка локального справочника

Добавление, редактирование, удаление контактов может осуществляться как в ручном режиме (по одной записи) через экранное меню и веб-интерфейс телефона, так и группами контактов c помощью файла в формате .xml/.csv. Этот файл может быть импортирован на устройство вручную через веб-интерфейс или автоматически (через автопровижининг).

Функция Группы контактов позволяет объединять контакты локальной телефонной книги в группы для облегчения навигации и поиска по контактам, а также задавать отдельную мелодию на каждую из групп.

Добавление, редактирование, удаление контактов и групп в ручном режиме

Экранное меню: Меню -> Контакты -> Локальная книга

Обзор контактов локальной книги (экранное меню Yealink SIP-T46U)

Веб-интерфейс: Контакты -> Локальная книга

Обзор контактов локальной книги (старая версия веб-интерфейса)

Обзор контактов локальной книги (новая версия веб-интерфейса)

Добавление контакта в группу

Группу, к которой относится контакт, можно указать при создании контакта, либо переместить ранее созданный контакт, не принадлежащий к какой-либо из групп или находящийся в другой группе, в нужную пользователю группу.

Смена группы контакта

Экранное меню: Меню -> Контакты -> Локальная книга -> |найти нужный контакт| -> Опции -> Детали -> Группы

Веб-интерфейс: Контакты -> Локальная книга -> |выделить нужный контакт| -> Группы

Импорт списка контактов

Для импорта списка контактов необходимо перейти в веб-интерфейс телефона: Контакты -> Локальная книга -> Импорт списка контактов. Потребуется список контактов — файл с расширением .xml или .csv, который можно создать вручную или с помощью утилиты, предназначенной для создания телефонных книг. Нажмите Обзор, выберите на ПК файл телефонной книги, в зависимости от расширения файла выберите Импорт XML или Импорт CSV.

Файл телефонной книги можно также загрузить на телефон с помощью автопровижининга.

Параметр в .cfg: local_contact.data.url = ссылка,
где ссылка – это ссылка на файловый сервер, на котором находится книга.
Пример: http://172.16.10.12/localbook.xml

Импорт списка контактов (старая и новая версии веб-интерфейса)

Также возможно экспортировать список контактов из телефона в формате .xml/.csv, сохранив его в любое удобное место на ПК. Этот файл может использоваться в качестве файла бэкапа или для импорта списка контактов на другой (другие) телефон.

Создание файла телефонной книги

Телефонную книгу в формате .xml/.csv можно создать и вручную, воспользовавшись любым текстовым редактором (например, Блокнотом, поменяв при сохранении файла его расширение на .xml/.csv). Но гораздо удобнее будет воспользоваться для создания книги специальной утилитой, которая ускорит процесс и минимизирует вероятность ошибки при редактировании записей. Производитель предлагает использовать для редактирования телефонных книг свою утилиту — Yealink Phonebook Generations Tool. Ее системные требования приведены ниже:

• OS MS Windows XP, 7, 8, 8.1, 10 (x64 версия);

• MS Excel версии 2003 года или старше (x32 или x64 версия).

Скачать архив с утилитой и инструкцией на русском языке с сайта компании АйПиМатика
Скачать архив с утилитой и инструкцией на английском языке с официального сайта Yealink

Количество контактов в созданной с помощью утилиты телефонной книге имеет ограничение в 3000 записей, максимальное количество групп — 49.

Создание телефонной книги при помощи утилиты

Распакуйте архив, текстовым редактором откройте файл config.cfg и укажите директорию, в которую будут сохранены готовые книги.

Укажите директорию на ПК, в которую будет сохранена книга

Откройте файл xls из того же архива, разрешите его редактирование и исполнение скриптов.

Yealink Phonebook Generations Tool (так программа будет выглядеть при запуске)

Заполните поля информацией о контактах. Полностью все поля заполнять не обязательно, минимально допустимой записью является запись, содержащая только имя контакта. Для того, чтобы эта запись имела практический смысл, необходимо к каждой записи добавить минимум 1 номер.

Пример списка контактов с минимальным и максимальным количеством заполненных полей

После того, как редактирование книги будет завершено, ее необходимо сохранить. Сделайте это, нажав Create Local Phonebook. Если сохранение выполнено успешно, появится всплывающее оповещение с указанием директории, в которой сохранена книга.

Успех!

Книга будет сохранена в виде файла в формате .xml, в котором ее затем можно будет импортировать в телефон вручную или через автопровижининг.

Файлы ресурсов

Для того, чтобы появилась возможность выбирать в настройках контакта пользовательскую мелодию или фото, их надо предварительно импортировать на устройство. На телефон можно загрузить фото и мелодии через веб-интерфейс, либо указав ссылку на скачивание в конфигурационном файле или в файле .xml/.csv телефонной книги.

Загрузка фото

Для загрузки фотографии контакта вручную необходимо перейти в веб-интерфейс телефона по указанному ниже пути, выбрать контакт, выбрать файл на компьютере, нажать Загрузить. К загружаемым фото применяются следующие ограничения:

• формат .jpg/.png/.bmp/.jpeg;

• размер одного файла — до 5120 Кб;

• разрешение 41 x 41, 110 x 110 (в зависимости от модели телефона).

Возможность загрузить пользовательскую фотографию поддерживают все актуальные модели телефонов Yealink с цветным экраном.

Веб-интерфейс: Контакты -> Локальная книга -> |выбрать контакт| -> Настройки группы -> Обзор/Загрузить

Загрузка фотографии вручную (старая и новая версии веб-интерфейса)

Если фотография успешно загружена, ее можно будет связать с контактом при его редактировании. Для загрузки большого количества фото необходимо выполнить импорт архива с фотографиями. Такие фото можно будет также связать с контактом позже путем редактирования записи контакта через экранное меню или веб-интерфейс телефона. Архив должен иметь разрешение .tar. Он может содержать архив с названием photo.tar (архив с фотографиями) и сам справочник (файл ContactData.xml). Для создания архива необходимо воспользоваться архиватором 7-Zip.

Создание архива .tar

Разместите архив на файловом сервере, в конфиге укажите ссылку.

Параметр в .cfg: local_contact.data_photo_tar.url = ссылка,
где ссылка – ссылка на файловый сервер.
Пример: http://172.16.10.12/Contact.tar

Загрузка мелодии звонка

Можно загрузить пользовательскую мелодию звонка через веб-интерфейс или конфигурационный файл. Впоследствии загруженную мелодию можно выбрать в качестве мелодии звонка к контакту или группе контактов. К загружаемым мелодиям применимы следующие ограничения:

• формат wav;

• размер (в зависимости от модели телефона) — до 100 Кб или до 8192 Кб.

Возможность загрузить пользовательскую мелодию звонка поддерживают все актуальные модели телефонов Yealink.

Веб интерфейс: Настройки -> Основные -> Загрузить мелодию -> Обзор/Загрузить

Загрузка мелодии вручную (старая версия веб-интерфейса)

Загрузка мелодии вручную (новая версия веб-интерфейса)

Параметр в .cfg: ringtone.url =
Пример: http://172.16.10.31/test.wav

Загрузка сразу нескольких мелодий может быть совершена только через редактирование конфигурационного файла.

Удаление загруженных мелодий

Загруженные в память телефона мелодии можно удалить с помощью конфигурационного файла.

Параметр в .cfg, пример: ringtone.delete = http://localhost/all

В примере представлено единственное возможное значение данного параметра, т. е. его значение стоит переносить в конфигурационный файл в неизменном виде.

Дополнительно: редактирование конфигурационного файла вручную

Конфигурационный файл импортируется из веб-интерфейса телефона:

Веб-интерфейс: Настройки -> Конфигурации -> Конфигурационный файл .cfg -> Экспорт конфигурационного файла (с параметром Все настройки)

Импортированный файл необходимо открыть текстовым редактором (Блокнот, Notepad ++ и пр.), его редактирование осуществляется путем добавления, изменения или удаления строк.

Конфигурационный файл импортируется обратно на телефон:

Веб-интерфейс: Настройки -> Конфигурации -> Конфигурационный файл .cfg -> Импорт конфигурационного файла

Редактирование конфигурационного файла (старая версия веб-интерфейса)

Редактирование конфигурационного файла (новая версия веб-интерфейса)

• ITCORE16 wrote:

  Do i need to do anything special to setup remote directory on Yealink phone?

  i cant get the phone to download file.

  i can access the file on my PC if i type http://10.10.10.15/remote/contact.xml Opens a new window but when i try to download the file from IP phone doesn’t work.»cannot download file» error

  I enable remote phone book on my phone and added the local server address

  I am having a problem in the last week with a remote address book. My desk phone has always had 5 remote phones books programmed, and now 4 work and one does not. The one not working is on my FreePBX 14 instance. The other four are on a IIS server elsewhere.

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• Did you use the correct syntax for the file? That is critical. The root tag has a required format. XXXIPPhoneDirectory where XXX is whatever you want.

  Here is a sample from my working xml file. Yes it is my own Extension, but this is a shared book for everyone in the company. Obviously there are many other numbers in the full version.

  XML

  <?xml version="1.0" encoding="utf-8"?>
  <BundyIPPhoneDirectory>
          <DirectoryEntry>
                  <Name>Jared Busch</Name>
                  <Telephone>103</Telephone>
          </DirectoryEntry>
  </BundyIPPhoneDirectory>
  

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  <?xml version=»1.0″ encoding=»utf-8″?>
  <root_group>
    <group display_name=»All Contacts» />
    <group display_name=»Blacklist» />
    <group display_name=»Web Page» ring=»» />
  </root_group>
  <root_contact>
    <contact display_name=»Alison» office_number=»223″

  I export it from phone local directory.. 

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  ITCORE16 wrote:

  <?xml version=»1.0″ encoding=»utf-8″?>
  <root_group>
    <group display_name=»All Contacts» />
    <group display_name=»Blacklist» />
    <group display_name=»Web Page» ring=»» />
  </root_group>
  <root_contact>
    <contact display_name=»Alison» office_number=»223″

  This is not a standard phone book for yealink phones. The one Jared is the format we have automatically generated on our PBX. We wrote a simple php page that builds the directory twice a day for the yealiink and polycom phones in our office.

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  can i use a tool to convert csv to xml  in the correct format ? I have over 100 phones..

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  Where is your phone book data coming from?

  If this is from an asterisk pbx, there are examples of how to export the asterisk address book. If this info is coming from another source the yes it can be scripted. It probably would pretty easy to just create a vbscript to parses the csv file and write out the xml.

  If you look at Jared’s post scripting the address book it really trivial you have the header that static.

  XML

  <?xml version="1.0" encoding="utf-8"?>
  <MyIPPhoneDirectory>
          <DirectoryEntry>
  

  Some looping code you will need one per address book entry.

  XML

                  <Name>Jared Busch</Name>
                  <Telephone>103</Telephone>
  

  And the footer

  XML

          </DirectoryEntry>
  </MyIPPhoneDirectory>
  

  You just need to translate that into a vb script. If you have any vb scripting skills it should take you about 10 minutes.

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• George1421 wrote:

  ITCORE16 wrote:

  <?xml version=»1.0″ encoding=»utf-8″?>
  <root_group>
    <group display_name=»All Contacts» />
    <group display_name=»Blacklist» />
    <group display_name=»Web Page» ring=»» />
  </root_group>
  <root_contact>
    <contact display_name=»Alison» office_number=»223″

  This is not a standard phone book for yealink phones. The one Jared is the format we have automatically generated on our PBX. We wrote a simple php page that Spotlightbuilds the directory twice a day for the yealiink and polycom phones in our office.

  That is a standard format for a local address book on the Yealink phones.

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  OK that makes sense now that you mentioned..

  
  Was this post helpful?
  thumb_up
  thumb_down
  

• 

  I downloaded Yealink directory generator tool and updated file.. fie is downloading successfully  to Yealink phone now..

  attach_file
  Attachment
  
  Yealink_Phonebook…n_Tool.xls
  123 KB
  
  

  
  Was this post helpful?
  thumb_up
  thumb_down
  

Для телефонов Yealink (T22P) есть функция «Удаленная записная книга». При этом XML-файл телефонной книги считывается с HTTP/TFTP-сервера не загружая телефонную книгу на локальную директорию телефона.
Нужно только настроить путь к серверу и подготовить XML-файл, разместив этот файл на сервере.

Структура XML-файла телефонной книги (по примеру 1):

<xxxIPPhoneDirectory>
    <DirectoryEntry>
        <Name>Home</Name>
        <Telephone>528002</Telephone>
    </DirectoryEntry>
        <DirectoryEntry>
        <Name>Friend</Name>
        <Telephone>534303</Telephone>
    </DirectoryEntry>
        <DirectoryEntry>
        <Name>Russian PRESIDENT</Name>
        <Telephone>891912345678</Telephone>
    </DirectoryEntry>
    <SoftKeyItem>
        <Name>0</Name>
        <URL> tftp://192.168.18.16/1.xml </URL>
    </SoftKeyItem>
</xxxIPPhoneDirectory>

Настройка удаленной телефонной книги на телефоне Yealink приведена на рисунке 6.

Рисунок 6 – Настройка удаленной телефонной книги на телефоне Yealink

Можно выставить интервал обновления телефонной книги, а также входящий/исходящий поиск.

Удаленная телефонная книга будет доступна в меню телефона DIR => Remote Phone Book.
Есть возможность выбирать разные телефонные книги, выбор осуществляется по названию книги, которое задается в колонке (Display Name), рисунок 6.

На рисунке 7 изображено меню переданной телефонной книги SIP-телефона фирмы Yealink.

Рисунок 7 – Меню переданной телефонной книги SIP-телефона фирмы Yealink