Параметр Common.RemotePhoneBook.v2 предназначен для настройки удаленных адресных книг (Remote PhoneBook) в системе AuP. Он позволяет гибко управлять источниками контактов (ECSS Address Book, RestFS, Custom) и их параметрами, поддерживая до 10 серверов адресных книг.

Структура параметра

Общие настройки (опционально):

• Common.RemotePhoneBook.v2.Enable – включение/отключение адресных книг для устройства;

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

• Common.RemotePhoneBook.v2.UpdateInterval – интервал обновления адресной книги (в минутах).

Настройки серверов адресных книг:

• Common.RemotePhoneBook.v2.Server.[X] – конфигурация сервера с индексом X (от 1 до 10).

Обязательные параметры:

• Источник данных: 

  • ECSS Address Book, RestFS или Custom.

Опциональные параметры:

• • Имя адресной книги (отображается на телефоне).

Типы источников данных и их настройки

ECSS Address Book

Контакты загружаются с сервера ECSS Address Book.

Обязательные параметры: Нет.
Опциональные параметры:

• Alias ID – идентификатор пользователя для добавления персональных контактов;

• Формат полного имени (например, «Фамилия Имя Отчество»);

• Смещение (offset) и лимит (limit) для пагинации контактов.

RestFS

Контакты загружаются с сервера RestFS.

Обязательные параметры:

• Сервис данных: SSW, MySQL или LDAP;

• PBX домен.

Опциональные параметры:

• Смещение и лимит контактов;

• Пропуск контактов без имени;

• Транслитерация имени контакта.

Custom

Используется пользовательский URL для загрузки адресной книги.

Обязательные параметры:

• URL адресной книги.

Опциональные параметры:

• Данные авторизации (имя пользователя и пароль);

• Проксирование через AuP – если включено, AuP обрабатывает запросы к URL;

• Пропуск проверки SSL-сертификата (для HTTPS).

Генерация URL в конфигурации телефона

• Для RestFS и ECSS Address Book URL генерируется автоматически в формате:
  https://<AuP-хост>/phonebook-<X>.xml, где <X> – индекс сервера.

• Для Custom:

  • Если проксирование отключено – URL передается «как есть»;

  • Если проксирование включено – URL генерируется как для RestFS/ECSS Address Book.

Обработка запросов к адресным книгам

• AuP обрабатывает запросы к https://<AuP-хост>/phonebook-<X>.xml;

• Из URL извлекается индекс сервера (X), и AuP загружает контакты из соответствующего источника;

• Для Custom с проксированием AuP выполняет запрос к указанному URL и возвращает результат.

Важные замечания

1. Не используйте одновременно Common.RemotePhoneBook.v2 и устаревший Common.RemotePhoneBook – это приведет к конфликтам.

2. Параметры Common.RemotePhoneBook.v2 не зависят от состояния Common.RemotePhoneBook.v2.Enable при обработке запросов.

3. Для работы с RestFS/ECSS Address Book должны быть настроены глобальные параметры:

   • AuP.Dynamic.RestFs (хост, порт, SSL-настройки);

   • AuP.Dynamic.EcssAddressBook (хост, порт, SSL-настройки).

4. Для генерации URL в конфигурации телефона используется свойство AuP.Autoprovision (хост, схема, порт AuP).

Рекомендации

• Используйте Common.RemotePhoneBook.v2 для новых конфигураций;

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

Пример конфигурации (Yealink)

plaintext

features.remote_phonebook.enable = 1
remote_phonebook.data.1.url = https://10.25.88.149:80/phonebook-1.xml
remote_phonebook.data.2.url = https://10.25.88.149:80/phonebook-2.xml
remote_phonebook.data.3.url = http://example.com/phonebook.xml
remote_phonebook.data.3.username = user
remote_phonebook.data.3.password = pass