В данном разделе описываются команды управления услугой "Групповое оповещение" ("Zone Page") для абонентов.
В рамках сервиса Zone Page доступны следующие свойства:
- priority - приоритетность вызова, по умолчанию 5_routine - обычный. Высокоприоритетный вызов может заместить низкоприоритетный;
От более приоритетного к менее приоритетному:
0_flash_override;
1_flash;
2_immediate;
3_priority;
4_routine; (Default)
- intro_pause - пауза между ответом одного из участников группы, кто снял трубку первым, и началом проигрывания вступительных файлов, задается в секундах (по умолчанию 3 секунды);
- intro_files - список вступительных файлов (по умолчанию файлы не заданы);
- announcement_pause - пауза между окончанием проигрывания вступительных файлов и началом проигрывания файлов анонсов, задается в секундах (по умолчанию 0 секунд);
- announcement_files - список файлов анонса, данные файлы могут проигрываться многократно;
- announcement_playback_cnt - количество циклов проигрывания файлов анонса (по умолчанию анонсы проигрываются 1 раз);
- announcement_repeat_time - пауза между циклами проигрывания файлов анонса, в случае если задано более одного цикла, задается в секундах (по умолчанию 10 секунд);
- terminate_when_initiator_disconnects - параметр, определяющий необходимость завершения вызова при отключении инициатора, значения true/false. Если установлено значение true, то после отбоя инициатора все участники группы будут отбиты;
- terminate_when_last_listener_leave - параметр, определяющий необходимость завершения вызова при отключении последнего участника, значения true/false;
- terminate_when_playback_ends - параметр, определяющий необходимость завершения вызова после окончания проигрывания анонсов, значения true/false. Если установлено значение true, то после окончания проигрывания всех циклов анонсов все участники группы будут отбиты. Если установлено значение false, то после окончания проигрывания анонсов инициатор может продолжить передавать информацию со своего терминала;
- initiation_policy - ограничение, установленное на инициацию вещания по данной группе.
Значения:
managers - инициировать zone page вызов могут только абоненты-менеджеры из списка managers;
members - инициировать zone page вызов могут только абоненты-участники обзвона из списка members;
any - инициировать zone page вызов могут все абоненты (по умолчанию настроено значение any);
- members - список участников группы вызова (внутренние и внешние номера);
- managers - список абонентов - менеджеров группы;
- display_name - имя, которое будет передаваться в качестве идентификации номера вызывающего (CallerID) всем участникам группы вызова во время совершения Zone Page вызова (по умолчанию "Zone Page").
activate
Команда предназначена для активации услуги "Zone Page" для заданных абонентов.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/activate <ADDRESS_RANGE> [<PROPERTY> = <VALUE>, ...]
Синтаксис:
activate <ADDRESS_RANGE> [<PROPERTY> = <VALUE>, ...]
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо активировать сервис;
- <PROPERTY> - имя свойства (список доступных свойств описан выше);
- <VALUE> - значение свойства (список доступных свойств описан выше).
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/activate 240101 managers = [240464,240465,240470] Success: Supplementary service zone_page activated for domain "biysk.local" address "240101" [exec at: 30.09.2018 23:07:47, exec time: 24ms, nodes: ds1@ecss1]
deactivate
Команда деактивации сервиса.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/deactivate <ADDRESS_RANGE>
Синтаксис:
deactivate <ADDRESS_RANGE>
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо деактивировать сервис.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/deactivate 240101 Success: Supplementary service zone_page deactivated for domain "biysk.local", address "240101". [exec at: 01.10.2018 08:19:08, exec time: 17ms, nodes: ds1@ecss1]
info
Команда просмотра активированного на абоненте сервиса.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/info <ADDRESS_RANGE>
Синтаксис:
info <ADDRESS_RANGE>
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо деактивировать сервис.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/info 240101
Domain: biysk.local
Supplementary services' settings:
┌─────────────────────────┬──────────────────────────────────────────┬─┬─┬───────────────────────────────────────────────────────────────────┐
│ Address │ Name │V│E│ CSD │
├─────────────────────────┼──────────────────────────────────────────┼─┼─┼───────────────────────────────────────────────────────────────────┤
│240101 │zone_page │6│T│announcement_files = [{file,{system,"sounds/ai_call_recording_annou│
│ │ │ │ │ncement.wav"}}] │
│ │ │ │ │announcement_pause = 0 │
│ │ │ │ │announcement_playback_cnt = 1 │
│ │ │ │ │announcement_repeat_time = 10 │
│ │ │ │ │display_name = "ZonePage" │
│ │ │ │ │initiation_policy = any │
│ │ │ │ │intro_files = [] │
│ │ │ │ │intro_pause = 3 │
│ │ │ │ │managers = 240464, 240465, 240470 │
│ │ │ │ │members = │
│ │ │ │ │priority = '4_routine' │
│ │ │ │ │terminate_when_initiator_disconnects = false │
│ │ │ │ │terminate_when_last_listener_leave = false │
│ │ │ │ │terminate_when_playback_ends = false │
└─────────────────────────┴──────────────────────────────────────────┴─┴─┴───────────────────────────────────────────────────────────────────┘
Legend:
V - version of the supplementary service;
E - enable state of selected supplementary service to current domain, address
[exec at: 01.10.2018 08:14:36, exec time: 40ms, nodes: ds1@ecss1]
set
Команда изменения настроек сервиса.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/set
Синтаксис:
set <ADDRESS_RANGE> [<PROPERTY> = <VALUE>, ...]
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо активировать сервис;
- <PROPERTY> - имя свойства (список доступных свойств описан выше);
- <VALUE> - значение свойства (список доступных свойств описан выше).
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/set 240101 announcement_files = [system sounds/ai_call_recording_announcement.wav ] Success: Supplementary service zone_page activated for domain "biysk.local" address "240101" [exec at: 01.10.2018 08:13:49, exec time: 21ms, nodes: ds1@ecss1]
add-number
Команда добавления новых номеров в группу.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/add-number
Синтаксис:
add-number <ADDRESS_RANGE> <TYPE> <NUMBER_1> <NUMBER_2> ...
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо активировать сервис;
- <TYPE> - members | managers - в список участников Zone Page, или менеджеров Zone Page будет добавлен номер;
- <NUMBER_N> - добавляемый номер.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/add-number 240101 members 240522 Successful [exec at: 01.10.2018 08:15:55, exec time: 23ms, nodes: ds1@ecss1]
remove-number
Команда удаления номеров из группы.
Путь команды:
/domain/<DOMAIN_NAME>/ss/zone-page/remove-number
Синтаксис:
remove-number <ADDRESS_RANGE> <TYPE> <NUMBER_1> <NUMBER_2> ...
Параметры:
- <DOMAIN_NAME> - имя домена;
- <ADDRESS_RANGE> - диапазон адресов, на которых необходимо активировать сервис;
- <TYPE> - members | managers - из списка участников Zone Page, или менеджеров Zone Page будет удален номер;
- <NUMBER_N> - удаляемый номер.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/zone-page/remove-number 240101 managers 240464 Numbers successfully added to zone_page:240101:biysk.local [exec at: 01.10.2018 08:17:01, exec time: 27ms, nodes: ds1@ecss1]