Команды управления подразделяются на общие команды и команды для управления приоритетами (актуально для blf/presence списков).

Общие команды

declare

Команда предназначена для создания списка номеров.

Путь команды:

/domain/<DOMAIN>/lists/declare

Синтаксис:

declare <NAME> [<DESCRIPTION>] [<TYPE>] [<NUMBERS>]

Параметры:

<NAME> - имя списка;
<DESCRIPTION> - описание списка;
<TYPE> - тип списка (blf, default, presence)
<NUMBERS> - номер (диапазон номеров) абонента.

Для типа списка teleconference параметр <NAME> должен быть числовым.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/declare conf_list1 default  "1-я линия ТП" 240500 240501 240464 
List successfully declared

[exec at: 26.03.2019 16:05:07, exec time: 75ms, nodes: ds1@ecss1]

info

Команда предназначена для просмотра информации о списке номеров.

Путь команды:

/domain/<DOMAIN>/lists/info

Синтаксис:

info <NAME>

Параметры:

<NAME> - имя списка.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/info blf_group1                                                    
 Information about lists:
┌──────────┬────┬─────────────────────────┬──────┬──────────────────┐
│   Name   │Type│       Description       │Number│      Number      │
│          │    │                         │      │     property     │
├──────────┼────┼─────────────────────────┼──────┼──────────────────┤
│blf_group1│blf │Для оператора мониторинга│240101│priority => high  │
│-         │-   │-                        │240244│                  │
│-         │-   │-                        │240464│                  │
│-         │-   │-                        │240465│priority => normal│
│-         │-   │-                        │240470│                  │
│-         │-   │-                        │240471│                  │
│-         │-   │-                        │240474│                  │
│-         │-   │-                        │240475│priority => low   │
└──────────┴────┴─────────────────────────┴──────┴──────────────────┘

[exec at: 27.03.2019 09:43:54, exec time: 91ms, nodes: ds1@ecss1]

list

Команда предназначена для просмотра списков номеров.

Путь команды:

/domain/<DOMAIN>/lists/list

Синтаксис:

list

Параметры:

Команда не содержит аргументов.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/list                                                                           
┌────────────┬──────────────┬────────────┐
│    Name    │     Type     │Description │
├────────────┼──────────────┼────────────┤
│presence_gr1│presence      │k508        │
│blf_group1  │blf           │blf1        │
│2           │teleconference│2-я линия ТП│
│conf_list1  │default       │1-я линия ТП│
│tc1         │default       │def_list    │
└────────────┴──────────────┴────────────┘

[exec at: 26.03.2019 16:23:36, exec time: 91ms, nodes: ds1@ecss2]

remove

Команда предназначена для удаления списка.

Путь команды:

/domain/<DOMAIN>/lists/remove

Синтаксис:

remove <LIST>

Параметры:

<LIST> - имя списка.

Пример:

admin@[ds1@ecss1]:/$ domain/biysk.local/lists/remove blf-2  
List successfully removed

[exec at: 09.03.2019 11:41:27, exec time: 83ms, nodes: ds1@ecss1]

set

Команда установки свойств списка номеров.

Путь команды:

/domain/<DOMAIN>/lists/set

Синтаксис:

set <NAME> [<PROPERTY> | [<VALUE>]

Параметры:

<NAME> - имя списка;
<PROPERTY> - свойство (type - тип списка, description - описание или numbers - список номеров);

<VALUE> -
для <PROPERTY> = type - default (черные/белые списки номеров для транков), blf, teleconference или presence списки;
для <PROPERTY> = description - строка, заключенная в двойные кавычки;
для <PROPERTY> = numbers - список номеров, разделенных пробелом.

Примеры:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/set blf_group1 description "Для оператора мониторинга"
Property successfully setted

[exec at: 26.03.2019 16:26:45, exec time: 91ms, nodes: ds1@ecss1]

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/set conf_list1 type presence
Property successfully setted

[exec at: 26.03.2019 16:27:57, exec time: 91ms, nodes: ds1@ecss2]

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> - номер (диапазон номеров) абонента.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-add presence_gr1 240515 240475
Numbers successfully added

[exec at: 26.03.2019 16:32:10, exec time: 83ms, nodes: ds1@ecss1]

number-remove

Команда предназначена для удаления номера из списка.

Путь команды:

/domain/<DOMAIN>/lists/number-remove

Синтаксис:

number-remove <NAME> <NUMBERS>

Параметры:

<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-remove conf_list1 240501
Numbers successfully removed

[exec at: 26.03.2019 16:33:38, exec time: 125ms, nodes: ds1@ecss1]

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-delete-property blf_group1 priority 240471 240475
Property successfully deleted

[exec at: 27.03.2019 09:54:18, exec time: 121ms, nodes: ds1@ecss1]

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> - номер (диапазон номеров) абонента.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-set-property blf_group1 priority high 240101 240244
Property successfully setted

[exec at: 27.03.2019 09:52:52, exec time: 68ms, nodes: ds1@ecss1]

Внимание! Номера в нескольких списках одного типа могут пересекаться между собой, задача администратора контролировать правильность при предоставлении прав абонентам.

Примеры настройки BLF-листов

Пример 1:

Необходимо настроить BLF-лист таким образом, чтобы:
1. Номер 240500 мог следить за номерами 240501, 240502
2. Номера 240501, 240502 не могли следить за 240500 и друг за другом.

Настройка:
1. Создаём лист:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/declare blf2_508 blf "blf-cc room 508 group2" 24050{0-4}
List successfully declared

[exec at: 27.03.2019 10:24:53, exec time: 75ms, nodes: ds1@ecss1]

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

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-set-property blf2_508 priority low 24050{1-2}              
Property successfully setted

[exec at: 27.03.2019 10:28:37, exec time: 100ms, nodes: ds1@ecss1]

3. У абонента 240500 остается дефолтный приоритет normal, что позволяет ему следить за номерами 240501 и 240502.

Пример 2:

Необходимо настроить BLF-лист таким образом, чтобы:
1. Номер 240500 мог следить за номерами 240501, 240502, 240503.
2. Номера 240501 и 240502 могли следить друг за другом и за 240503.
3. Номера 240501 и 240502 не могли следить за 240500.
4. Номер 240503 ни за кем не может следить.

Настройка:
1. Создаём лист:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/declare blf2_508 blf "blf-cc room 508 group2" 24050{0-4}
List successfully declared

[exec at: 27.03.2019 10:24:53, exec time: 75ms, nodes: ds1@ecss1]

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

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-set-property blf2_508 priority high 240500
Property successfully setted

[exec at: 27.03.2019 10:36:44, exec time: 83ms, nodes: ds1@ecss1]

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

admin@[mycelium1@ecss1]:/$ domain/biysk.local/lists/numbers-set-property blf2_508 priority low 240503       
Property successfully setted

[exec at: 27.03.2019 10:35:28, exec time: 83ms, nodes: ds1@ecss1]

4. Номера 101 и 102 остаются с приоритетом по умолчанию normal, что позволяет им следить за номерами с приоритетом low и друг за другом.