Команды управления именованными списками номеров подразделяются на общие команды и команды для управления приоритетами (актуально для blf/presence списков).
Общие команды
declare
Команда предназначена для создания списка номеров.
Путь команды:
domain/<DOMAIN>/lists/declare
Синтаксис:
declare <NAME> [<DESCRIPTION>] [<TYPE>] [<NUMBERS>]
Параметры:
<NAME> - имя списка;
<DESCRIPTION> - описание списка;
<TYPE> - тип списка (blf, default, presence)
<NUMBERS> - номер (диапазон номеров) абонента.
Пример 1:
/domain/test.domain/lists/declare tr1_black_list_in "Черный список входящих на транк номеров" default 4001 4002
Пример 2:
Создание списка с типом teleconference.
/domain/voip.local/lists/declare 121 teleconference список_1 100 101 102 103 104 105 List successfully declared
info
Команда предназначена для просмотра информации о списке номеров.
Путь команды:
domain/<DOMAIN>/lists/info
Синтаксис:
info <NAME>
Параметры:
<NAME> - имя списка.
Пример:
/domain/test.domain/lists/info tr1_black_list_in
list
Команда предназначена для просмотра списков номеров.
Путь команды:
domain/<DOMAIN>/lists/info
Синтаксис:
list
Параметры:
Команда не содержит аргументов.
Пример:
domain/pk.ssw/lists/list ┌──────┬────────────────────┐ │ Name │ Description │ ├──────┼────────────────────┤ │black │blacklist │ │ttt │Testing numbers list│ └──────┴────────────────────┘
remove
Команда предназначена для удаления списка.
Путь команды:
domain/<DOMAIN>/lists/remove
Синтаксис:
remove <LIST>
Параметры:
<LIST> - имя списка.
Пример:
/domain/test.domain/lists/remove tr1_black_list_in List successfully removed
set
Команда установки свойств списка номеров.
Путь команды:
domain/<DOMAIN>/lists/set
Синтаксис:
set <NAME> [<PROPERTY> | [<VALUE>]
Параметры:
<NAME> - имя списка;
<PROPERTY> - свойство (type - тип списка, description - описание или numbers - список номеров);
<VALUE> -
для <PROPERTY> = type - default (черные/белые списки номеров для транков, blf или presence списки)
для <PROPERTY> = description - строка, заключенная в двойные кавычки;
для <PROPERTY> = numbers - список номеров, разделенных пробелом.
Пример:
/domain/test.domain/lists/set tr1_black_list_in description "Черный список" Property successfully setted /domain/test.domain/lists/set tr1_black_list_in type presence Property successfully setted /domain/test.domain/lists/set tr1_black_list_in numbers 4001 4002 Property successfully setted
name-set
Команда предназначена для переименования списков.
Путь команды:
domain/<DOMAIN>/lists/name-set
Синтаксис:
numbers-add <NAME> <NEWNAME>
Параметры:
<NAME> - имя списка;
<NEWNAME> - новое имя списка.
Пример:
domain/arko/lists/name-set testing new-name List name successfully changed.
number-add
Команда предназначена для добавления номера в список.
Путь команды:
domain/<DOMAIN>/lists/number-add
Синтаксис:
numbers-add <NAME> <NUMBERS>
Параметры:
<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
/domain/test.domain/lists/number-add tr1_black_list_in 4003 Numbers successfully added
number-remove
Команда предназначена для удаления номера из списка.
Путь команды:
domain/<DOMAIN>/lists/number-remove
Синтаксис:
number-remove <NAME> <NUMBERS>
Параметры:
<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
/domain/test.domain/lists/number-remove tr1_black_list_in 4003 4004 Numbers successfully removed
Команды управления приоритетами (только для списков BLF и Presence)
Приоритеты:
- низкий (low) - номер с данным приоритетом не может ни за кем следить;
- нормальный (normal) - номер с данным приоритетом может следить за номерами с приоритетом low, normal;
- высокий (high) - номер с данным приоритетом может следить за номерами с приоритетом low, normal, high.
number-delete-property
Команда предназначена для удаления (сброса к значению по умолчанию) свойства номера в списке.
В настоящее время осуществляется сброс единственного свойства - priority.
Путь команды:
domain/<DOMAIN>/lists/number-delete-property
Синтаксис:
numbers-delete-property <NAME> priority [<NUMBERS>]
Параметры:
<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
./lists/numbers-delete-property black_list_out priority 101 102 103 Property successfully deleted
numbers-set-property
Команда предназначена для установки свойств для заданных номеров входящих в список.
В настоящее время для номеров входящих в список устанавливается только свойство priority (приоритет), которое определяет уровень доступа к номеру из списка.
Уровнем доступа определяется поведение, например, возможность подписки на события.
Путь команды:
domain/<DOMAIN>/lists/numbers-set-property
Синтаксис:
numbers-set-property <NAME> priority <PRIORITY> [<NUMBERS>]
Параметры:
<NAME> - имя списка;<PRIORITY> - приоритет свойства:
- низкий (low) - номер с данным приоритетом не может ни за кем следить;
- нормальный (normal) - номер с данным приоритетом может следить за номерами с приоритетом low, normal;
- высокий (high) - номер с данным приоритетом может следить за номерами с приоритетом low, normal, high.
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
domain/testing/lists/numbers-set-property ttt priority normal 2219 2221 Property successfully setted
Примеры настройки BLF-листов
Пример 1:
Необходимо настроить BLF-лист таким образом, чтобы:
- Номер 100 мог следить за номерами 101, 102
- Номера 101,102 не могли следить за 100 и друг за другом.
Настройка:
Создаём лист:
/domain/test.domain/lists/declare my_blf my_first_blf_list blf 100 101 102
Устанавливаем low приоритет для номеров 101 102, чтобы они ни за кем не могли следить.
vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority low 10{1-2} Property successfully setted
- У абонента 100 остается дефолтный приоритет normal, что позволяет ему следить за номерами 101 и 102.
Пример 2:
- Необходимо настроить BLF-лист таким образом, чтобы:
- Номер 100 мог следить за номерами 101, 102, 103.
- Номера 101 и 102 могли следить друг за другом и за 103.
- Номера 101 и 102 не могли следить за 100.
- Номер 103 ни за кем не может следить.
Настройка:
Создаём лист:
/domain/test.domain/lists/declare my_blf blf my_first_blf_list 100 101 102 103
Устанавливаем high приоритет для номера 100, чтобы он мог наблюдать за всеми.
vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority hogh 103 Property successfully setted
Устанавливаем low приоритет для номера 103, чтобы он не мог наблюдать за номерами с приоритетом high, normal.
vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority hogh 103 Property successfully setted
- Номера 101 и 102 остаются с приоритетом по умолчанию normal, что позволяет им следить за номерами с приоритетом low и друг за другом.