3.14.0 /domain/<DOMAIN>/teleconference/template/ - команды управления шаблонами телеконференций
В данном разделе описываются команды по управлению шаблонами телеконференций.
<DOMAIN> - имя виртуальной АТС.
declare
Команда декларирования шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/declare
Синтаксис:
declare <TEMPLATE_NAME>
Параметры:
<TEMPLATE_NAME> - имя шаблона(строка до 64 символов). Имя, содержащее пробелы, заключаются в двойные кавычки.
Примеры:
Создание нового шаблона:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare "IT service template" Template IT service template successfully declared with id 06250c03397b8903. [exec at: 06.11.2019 21:06:43, exec time: 75ms, nodes: core1@ecss1
Вывод ошибки:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare "IT service template" Error: Template with name IT service template already exists. [exec at: 06.11.2019 21:27:07, exec time: 83ms, nodes: core1@ecss1] admin@mycelium1@ecss1:/$ admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/declare 0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789 Error: Invalid command's arguments: "0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789_0123456789". [exec at: 06.11.2019 21:28:06, exec time: 66ms, nodes: core1@ecss1]
description-set
Команда ввода описания шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/description-set
Синтаксис:
description-set <TEMPLATE_NAME> <DESCRIPTION>
Параметры:
<TEMPLATE_NAME> - имя шаблона;
<DESCRIPTION> - описание шаблона.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/description-set developers_tc "Шаблон совещаний для разработчиков" Description successfully updated. [exec at: 06.11.2019 23:14:59, exec time: 78ms, nodes: core1@ecss1]
list
Команда просмотра списка шаблонов телеконференци.
Путь команды:
/domain/<DOMAIN>/teleconference/template/list
Синтаксис:
list
Параметры:
Команда без параметров
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/list ┌──┬────────────────────────┐ │№ │ Templates │ ├──┼────────────────────────┤ │1 │developers_tc │ │2 │energo_tc │ │3 │managers template │ │4 │test_tc │ └──┴────────────────────────┘ [exec at: 06.11.2019 23:08:43, exec time: 66ms, nodes: core1@ecss1]
name-set
Команда изменения имени шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/name-set
Синтаксис:
name-set <TEMPLATE_NAME> <NEW TEMPLATE_NAME>
Параметры:
<TEMPLATE_NAME> - имя шаблона;
<NEW TEMPLATE_NAME> - новое имя шаблона;
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/name-set energo_tc Enter a new template name: admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/name-set energo_tc tmpl_energo Template successfully renamed. [exec at: 10.11.2019 20:04:07, exec time: 133ms, nodes: core1@ecss1]
number-clean
Команда по выставлению номера шаблона телеконференции в значение по умолчанию
Путь команды:
/domain/<DOMAIN>/teleconference/template/number-clean
Синтаксис:
number-clean <TEMPLATE-NAME>
Параметры:
<TEMPLATE_NAME> - имя шаблона телеконференции;
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/number-clean "managers template" Number successfully cleaned. [exec at: 25.11.2019 09:07:06, exec time: 116ms, nodes: core1@ecss1]
number-set
Команда изменения номера шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/number-set
Синтаксис:
number-set <TEMPLATE-NAME> <PHONE-NUMBER>
Параметры:
<TEMPLATE_NAME> - имя шаблона телеконференции;
<PHONE-NUMBER> - новый номер шаблона телеконференции
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/number-set "managers template" 240244 Number successfully changed for template managers template. [exec at: 25.11.2019 08:59:58, exec time: 75ms, nodes: core1@ecss1]
Ошибка, если номер используется в другом шаблоне:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/number-set "managers template" 240475
Error: Number already binded.
[exec at: 25.11.2019 08:56:56, exec time: 92ms, nodes: core1@ecss1]property-clean
Команда выставляет свойство шаблона телеконференции в значение по умолчанию.
Путь команды:
/domain/<DOMAIN>/teleconference/template/propery-clean
Синтаксис:
propery-clean <TEMPLATE_NAME> <PROPERTY>
Параметры:
<TEMPLATE_NAME> - имя шаблона телеконференции;
<PROPERTY>
- destroy_by_no_initiator - true/false. Завершить после выхода инициатора?
- destroy_when_only_one_member_left - true/false. Завершить, если остался один участник?
- auto_collect - true/false. Автосбор;
- answer_to_initiator_when_success_outgoing_call - true/false. Ответить инициатору после успешного исходящего вызова? Только если включен автосбор;
- private - true/false. Частная?
- no_answer_timeout - от 5000 до 300000 сек. или неопределено. Таймаут ожидания ответа участника;
- max_members - от 0 до 250. Максимальное количество участников. Не более, чем разрешено лицензией;
- display_name_prefix - отображаемый префикс конференции. Для конференций, созданных по feature-коду;
- greeting_of_incoming_call - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для входящего вызова.
- greeting_of_outgoing_call - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для исходящего вызова.
- greeting_of_outgoing_call_by_auto_collect - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для исходящего вызова с автоматическим сбором участников;
- farewell - [path1, path2, ..., pathN]. Прощальный лист извещений телеконференции;
- notification_of_join_subscriber - [path1, path2, ..., pathN]. Лист извещения о присоединении к телеконференции;
- notification_of_leave_subscriber - [path1, path2, ..., pathN]. Лист извещения о выходе участника из телеконференции.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-clean energo_tc farewell Property farewell successfully cleaned. [exec at: 06.11.2019 23:01:25, exec time: 75ms, nodes: core1@ecss1]
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-clean energo_tc display_name_prefix Property display_name_prefix successfully cleaned. [exec at: 06.11.2019 23:01:42, exec time: 101ms, nodes: core1@ecss1]
property-set
Команда для изменения свойств шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/propery-set
Синтаксис:
propery-set <TEMPLATE_NAME> <PROPERTY> <VALUE>
Параметры:
<TEMPLATE_NAME> - имя шаблона телеконференции.
<PROPERTY> - свойство шаблона.
- destroy_by_no_initiator - true/false. Звершить после выхода инициатора;
- destroy_when_only_one_member_left - true/false. Завершить, если остался один участник;
- auto_collect - true/false. Автосбор конференции;
- answer_to_initiator_when_success_outgoing_call - true/false. Ответить инициатору после успешного исходящего вызова(только, если включен автосбор);
- private - true/false. Только задекларированные участники могут присоединиться к телеконференции;
- no_answer_timeout - от 5 до 300с. Таймаут ожидания ответа абонента;
- max_members - от 0 до 250. Максимальное количество участников в созданной телеконференции. Зависит от лицензии;
- display_name_prefix - отображаемый префикс конференции. Для конференций, созданных по feature-коду;
- greeting_of_incoming_call - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для входящего вызова.
- greeting_of_outgoing_call - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для исходящего вызова.
- greeting_of_outgoing_call_by_auto_collect - [path1, path2, ..., pathN]. Голосовое оповещение участников телеконференции для исходящего вызова с автоматическим сбором участников;
- farewell - [path1, path2, ..., pathN]. Прощальный лист извещений телеконференции;
- notification_of_join_subscriber - [path1, path2, ..., pathN]. Лист извещения о присоединении к телеконференции;
- notification_of_leave_subscriber - [path1, path2, ..., pathN]. Лист извещения о выходе участника из телеконференции.
<VALUE> - значение свойства.
Примеры:
Не завершать конференцию после выхода инициатора:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set energo_tc destroy_by_no_initiator false Propery destroy_by_no_initiator successfully updated. [exec at: 06.11.2019 22:35:54, exec time: 75ms, nodes: core1@ecss1]
Установить максимальное количество участников:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set energo_tc max_members 20 Propery max_members successfully updated. [exec at: 06.11.2019 22:36:24, exec time: 108ms, nodes: core1@ecss1]
Установить звуковой файл оповещения участников о завершении конференции:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set energo_tc farewell = [system sounds/ai_conference_destroyed.wav ] Propery farewell successfully updated. [exec at: 06.11.2019 22:39:13, exec time: 175ms, nodes: core1@ecss1]
Установка тона оповещения о выходе участника:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set "managers template" notification_of_leave_subscriber = [tone 400 200 500 0 100 ] Propery notification_of_leave_subscriber successfully updated. [exec at: 06.11.2019 23:25:32, exec time: 108ms, nodes: core1@ecss1]
Примеры ввода некорректных значений:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set energo_tc no_answer_timeout 2s
Error: Invalid command's result: {error,{bad_value,"2s"}}.
[exec at: 06.11.2019 22:53:14, exec time: 100ms, nodes: core1@ecss1]
admin@mycelium1@ecss1:/$
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/property-set energo_tc max_members 1000
Error: Invalid command's result: {error,{bad_value,"1000"}}.
[exec at: 06.11.2019 22:53:27, exec time: 66ms, nodes: core1@ecss1]
remove
Команда удаления шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/remove
Синтаксис:
remove <TEMPLATE_NAME>
Параметры:
<TEMPLATE_NAME> - имя удаляемого шаблона.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/remove "IT service template" Template successfully removed. [exec at: 06.11.2019 23:05:09, exec time: 75ms, nodes: core1@ecss1] admin@mycelium1@ecss1:/$
show
Команда просмотра шаблона телеконференции.
Путь команды:
/domain/<DOMAIN>/teleconference/template/show
Синтаксис:
show <TEMPLATE-NAME> [<OPTIONS>]
Параметры:
<TEMPLATE_NAME> - имя шаблона;
<OPTIONS> - параметры шаблона.
- --show-member - показать информацию об участниках (default: false)
- --show-group - показать информацию о группах в шаблоне (default: false)
- --show-number - показать информацию о внешних номерах (default: false)
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/teleconference/template/show tmpl_energo --show-group --show-member --show-number Template ┌──────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐ │ Key │ Value │ ├──────────────────────────────────────────────────┼────────────────────────────────────────────────────────┤ │Name │tmpl_energo │ │Description │Для энергетиков │ │Properties │ │ │ private │false │ │ notification_of_leave_subscriber │tone://?f1=390&f2=0&on_msec=200&off_msec=100&duration=30│ │ │0 │ │ notification_of_join_subscriber │tone://?f1=490&f2=0&on_msec=200&off_msec=100&duration=30│ │ │0 │ │ no_answer_timeout │15s │ │ max_members │20 │ │ greeting_of_outgoing_call_by_auto_collect │system://sounds/ai_conference_prompt.wav │ │ greeting_of_outgoing_call │system://sounds/ai_conference_prompt.wav │ │ greeting_of_incoming_call │system://sounds/ai_conference_prompt.wav │ │ farewell │system://sounds/ai_conference_destroyed.wav │ │ display_name_prefix │Teleconference │ │ destroy_when_only_one_member_left │false │ │ destroy_by_no_initiator │false │ │ auto_collect │true │ │ answer_to_initiator_when_success_outgoing_call│false │ │Number │240101 │ │Members │250 │ │ │138 │ │Numbers │416977 │ └──────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘ Members ┌──────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐ │Id │138 │ │Properties │ │ │ voice │false │ │ role │member │ │ number │240623 │ └──────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐ │Id │250 │ │Properties │ │ │ voice │false │ │ role │member │ │ number │240710 │ └──────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘ Numbers ┌──────────────────────────────────────────────────┬────────────────────────────────────────────────────────┐ │Number │416977 │ │Properties │ │ │ voice │true │ │ role │member │ │ description │линейный участок2 │ └──────────────────────────────────────────────────┴────────────────────────────────────────────────────────┘ [exec at: 11.11.2019 14:01:26, exec time: 83ms, nodes: core1@ecss1]