ECSS-10, версия 3.11
Быстрые ссылки
Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

Команды управления именованными списками номеров подразделяются на общие команды и команды для управления приоритетами (актуально для 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-лист таким образом, чтобы:

  1. Номер 100 мог следить за номерами 101, 102
  2. Номера 101,102 не могли следить за 100 и друг за другом.

Настройка:

  1. Создаём лист:

    /domain/test.domain/lists/declare my_blf my_first_blf_list blf 100 101 102

  2. Устанавливаем low приоритет для номеров 101 102, чтобы они ни за кем не могли следить.

    vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority low 10{1-2}        
Property successfully setted
  3. У абонента 100 остается дефолтный приоритет normal, что позволяет ему следить за номерами 101 и 102.

Пример 2:

  1. Необходимо настроить BLF-лист таким образом, чтобы:
  2. Номер 100 мог следить за номерами 101, 102, 103.
  3. Номера 101 и 102 могли следить друг за другом и за 103.
  4. Номера 101 и 102 не могли следить за 100.
  5. Номер 103 ни за кем не может следить.

Настройка:

  1. Создаём лист:

    /domain/test.domain/lists/declare my_blf blf my_first_blf_list 100 101 102 103

  2. Устанавливаем high приоритет для номера 100, чтобы он мог наблюдать за всеми.

    vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority hogh 103       
Property successfully setted

  3. Устанавливаем low приоритет для номера 103, чтобы он не мог наблюдать за номерами с приоритетом high, normal.

    vragov@[mycelium1@ecss2]:/$ /domain/test.domain/lists/numbers-set-property my_blf priority hogh 103       
Property successfully setted
  4. Номера 101 и 102 остаются с приоритетом по умолчанию normal, что позволяет им следить за номерами с приоритетом low и друг за другом.
  • Нет меток