/domain/<DOMAIN>/lists/ - команды управления именованными списками номеров
Команды управления подразделяются на общие команды и команды для управления приоритетами (актуально для blf/presence списков).
Общие команды
declare
Команда предназначена для создания списка номеров.
Путь команды:
/domain/<DOMAIN>/lists/declare
Синтаксис:
declare <NAME> [<DESCRIPTION>] [<TYPE>] [<NUMBERS>]
Параметры:
<NAME> - имя списка;
<DESCRIPTION> - описание списка;
<TYPE> - тип списка (blf, default, presence)
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
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 [--number <NUMBER>] [--type <TYPE>] [<NAME>]
Параметры:
--number <NUMBER> - информация из списков по выделенному диапазону номеров;
--type <TYPE> - информация из списков определенного типа;
<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 │ │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]
rename
Команда предназначена для переименования списка.
Путь команды:
/domain/<DOMAIN>/lists/rename
Синтаксис:
rename <LIST_NAME> <NEW_LIST_NAME>
Параметры:
<LIST_NAME> - существующее имя списка;
<NEW_LIST_NAME > - новое имя списка.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/rename list_new listok_new List name successfully changed. [exec at: 21.01.2020 15:39:37, exec time: 98ms, nodes: ds1@ecss1]
set
Команда установки свойств списка номеров.
Путь команды:
/domain/<DOMAIN>/lists/set
Синтаксис:
set <NAME> [<PROPERTY> | [<VALUE>]
Параметры:
<NAME> - имя списка;
<PROPERTY> - свойство (type - тип списка, description - описание или numbers - список номеров);
<VALUE> -
для <PROPERTY> = type - default (черные/белые списки номеров для транков), blf или 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]
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/set svetec numbers 419116 Property successfully setted [exec at: 22.01.2020 09:13:09, exec time: 40ms, nodes: ds1@ecss1]
numbers-add
Команда предназначена для добавления номера в список.
Путь команды:
/domain/<DOMAIN>/lists/numbers-add
Синтаксис:
numbers-add <NAME> <NUMBERS>
Параметры:
<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-add svetec 419105 419108 Numbers successfully added [exec at: 22.01.2020 09:18:26, exec time: 27ms, nodes: ds1@ecss1]
numbers-copy
Команда предназначена для копирования номеров из одного списка в другой список.
Путь команды:
/domain/<DOMAIN>/lists/numbers-copy
Синтаксис:
numbers-copy <NAME_FROM> <NAME_TO> <NUMBERS>
Параметры:
<NAME_FROM> - имя списка источника;
<NAME_TO> - имя целевого списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-copy list_new list_1 24061 24062 24063 24064 Numbers successfully copied [exec at: 21.01.2020 15:27:15, exec time: 22ms, nodes: ds1@ecss1]
numbers-import
Команда предназначена для импорта номеров текстового файла в список.
Путь команды:
/domain/<DOMAIN>/lists/numbers-import
Синтаксис:
numbers-import <FILE> <NAME> <TYPE> [<OPTIONS>]
FILE - имя файла;
NAME - имя листа;
TYPE - тип листа.
OPTIONS (Опции):
- LOG - с записью лога (по умолчанию: нет);
- REPLACE - перезаписать лист, если такой уже есть (по умолчанию: нет);
- DESCRIPTION - описание.
Параметры:
<NAME> - имя экспортируемого списка ;
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-import new_list.txt new default --description облако --log Success: List was imported Log file: /var/lib/ecss/numbers/biysk.local/new_list.txt.log [exec at: 22.01.2020 11:21:09, exec time: 63ms, nodes: ds1@ecss1]
numbers-move
Команда перемещает номера из одного списка в другой .
Путь команды:
/domain/<DOMAIN>/lists/numbers-move
Синтаксис:
numbers-move <NAME_FROM> <NAME_TO> <NUMBERS>
Параметры:
<NAME_FROM> - имя списка источника;
<NAME_TO> - имя целевого списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-move svetec svetec3 419105 419109 Numbers successfully moved [exec at: 22.01.2020 12:54:00, exec time: 20ms, nodes: ds1@ecss1]
numbers-export
Команда предназначена для экспорта номеров из списка в текстовый файл.
Путь команды:
/domain/<DOMAIN>/lists/numbers-export
Синтаксис:
numbers-export <NAME>
Параметры:
<NAME> - имя экспортируемого списка;
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-export svetec Success: List svetec has been exported [exec at: 22.01.2020 11:09:07, exec time: 43ms, nodes: ds1@ecss1]
numbers-remove
Команда предназначена для удаления номера(номеров) из списка.
Путь команды:
/domain/<DOMAIN>/lists/numbers-remove
Синтаксис:
numbers-remove <NAME> <NUMBERS>
Параметры:
<NAME> - имя списка;
<NUMBERS> - номер (диапазон номеров) абонента.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-remove svetec 41910{6-8}
Numbers successfully removed
[exec at: 22.01.2020 09:21:20, exec time: 19ms, nodes: ds1@ecss1]
admin@mycelium1@ecss1:/$ domain/biysk.local/lists/numbers-remove svetec 419105 419108 Numbers successfully removed [exec at: 22.01.2020 09:19:17, exec time: 26ms, nodes: ds1@ecss1]
Команды управления приоритетами (только для списков BLF и Presence)
Приоритеты:
- низкий (low) - номер с данным приоритетом не может ни за кем следить;
- нормальный (normal) - номер с данным приоритетом может следить за номерами с приоритетом low, normal;
- высокий (high) - номер с данным приоритетом может следить за номерами с приоритетом low, normal, high.
numbers-delete-property
Команда предназначена для удаления (сброса к значению по умолчанию) свойства номера в списке.
В настоящее время осуществляется сброс единственного свойства - priority.
Путь команды:
/domain/<DOMAIN>/lists/numbers-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 и друг за другом.