/domain/<DOMAIN>/ss/alarm/ - команды управления будильниками
В данном разделе описываются команды управления будильниками для абонентов в рамках определенного домена.
<DOMAIN> - название виртуальной АТС;
activate
Данной командой можно активировать услугу "Будильник" у заданных абонентов.
Путь команды:
/domain/<DOMAIN>/ss/alarm/activate
Синтаксис:
activate <ADDRESS> [<ALARM_ID> <TYPE> <Day1>[<Day2>[...[]]] <TIME> <ALARM_MSG>] [<ALARM_ID> ...]
Параметры:
<ADDRESS> - диапазон номеров телефонов, для которых выполняется настройка услуги, символ "*" используется для указания всех абонентов заданного домена.
Диапазоны номеров указываются в фигурных скобках. Например:* 71{1-2,9} соответствует номерам 711, 712, 719.
<ALARM_ID> - идентификатор будильника, возможные значения alarm_1, alarm_2, alarm_3, alarm_4, alarm_5, alarm_6, alarm_7, alarm_8, alarm_9.
<TYPE> - тип будильника, принимает значения:
- one-time - одноразовый будильник, задается день недели и время срабатывания будильника;
- daily - ежедневный будильник, указываются дни недели и время срабатывания будильника.
<DAY> - день недели, можно указать несколько дней перечислением без пробела, принимает значения: 1 - понедельник, 2- вторник, 3 - среда, 4 - четверг, 5 - пятница, 6 - суббота, 7 - воскресение;
Примечание. Одноразовый будильник можно установить только на день недели.
<TIME> - время срабатывания будильника, задается в виде {HH, MM}: HH - часы; MM - минуты;
<ALARM_MSG> - текст сообщения на дисплее телефона.
Пример:
Активация сервиса с установкой двух будильников:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/alarm/activate 240475 alarm_1 daily 12345 05:30 "Подъем!!!" alarm_2 one-time 6 4:00 "На рыбалку" Success: Supplementary service alarm activated for domain "biysk.local" address "240475"
add
Данной командой добавляются новые будильники.
Примечание. Услуга "Будильник" должна быть активирована у абонента при добавлении нового будильника, иначе система отклонит запрос:
** Command error: Unexpected error: "Properties for SS not found. May be alarm ss not activated." |
Путь команды:
/domain/<DOMAIN>/ss/alarm/add
Синтаксис:
add <ADDRESS> [<ALARM_ID> <TYPE> <Day1>[<Day2>[...[]]] <TIME> <ALARM_MSG>] [<ALARM_ID> ...]
Параметры:
<ADDRESS> - диапазон номеров телефонов, для которых настраивается будильник;<ALARM_ID> - идентификатор будильника, возможные значения alarm_1, alarm_2, alarm_3, alarm_4, alarm_5, alarm_6, alarm_7, alarm_8, alarm_9;
<TYPE> - тип будильника, принимает значения:
- one-time - одноразовый будильник, задается день недели и время срабатывания будильника;
- daily - ежедневный будильник, указываются дни недели и время срабатывания будильника.
<DayN> - день недели, в который должен сработать будильник, число от 1 до 7. Может быть задан список перечислением без пробела;
<TIME> - время, в которое должен сработать будильник. Формат: ЧЧ:ММ.
<ALARM_MSG> - текст сообщения на дисплее телефона.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/alarm/add 240475 alarm_3 one-time 7 06:00 Morning Success: Supplementary service alarm was updated for domain "biysk.local" address "240475"
delete
Данной командой удаляются ранее добавленные будильники.
Путь команды:
/domain/<DOMAIN>/ss/alarm/delete
Синтаксис:
delete <ADDRESS> <ALARM_ID> [<ALARM_ID> [...]]
Параметры:
<ADDRESS> - номер телефона (диапазон номеров), для которого удаляется будильник;
<ALARM_ID> - идентификатор будильника, возможные значения alarm_1, alarm_2, alarm_3, alarm_4, alarm_5, alarm_6, alarm_7, alarm_8, alarm_9.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/alarm/delete 240475 alarm_3 Success: Supplementary service alarm was updated for domain "biysk.local" address "240475"
info
Команда предназначена для просмотра информации об услуге в рамках виртуальной АТС.
Для просмотра информации по определенному абоненту необходимо ввести номер абонента.
Путь команды:
/domain/<DOMAIN>/ss/alarm/info
Синтаксис:
info [-extended] [<ADDRESS>]
Параметры:
[<ADDRESS>] - номер или диапазон номеров абонента(ов) (опциональный параметр).
[-extended] - флаг, при указании которого будет показана подробная информация.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/alarm/info 240475 Domain: biysk.local Supplementary services' settings: ┌────────────────────────────────────┬────────────────────────────────────────────────────────────┬──┬──┬─────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Address │ Name │V │E │ CSD │ ├────────────────────────────────────┼────────────────────────────────────────────────────────────┼──┼──┼─────────────────────────────────────────────────────────────────────────────────────────────────┤ │240475 │alarm │10│T │alarm_1 = {daily,[1,2,3,4,5],{5,30},"Подъем!!!"} │ │ │ │ │ │alarm_2 = {'one-time',[6],{4,0},"На рыбалку"} │ │ │ │ │ │alarm_3 = {'one-time',[7],{6,0},"Morning"} │ │ │ │ │ │alarm_4 = off │ │ │ │ │ │alarm_5 = off │ │ │ │ │ │alarm_6 = off │ │ │ │ │ │alarm_7 = off │ │ │ │ │ │alarm_8 = off │ │ │ │ │ │alarm_9 = off │ │ │ │ │ │call_attempt_count = 3 │ │ │ │ │ │call_attempt_timeout = 60 │ │ │ │ │ │cancel_digits = "*" │ │ │ │ │ │no_answer_timeout = 45 │ └────────────────────────────────────┴────────────────────────────────────────────────────────────┴──┴──┴─────────────────────────────────────────────────────────────────────────────────────────────────┘ Legend: V - version of the supplementary service; E - enable state of selected supplementary service to current domain, address
set
Данной командой изменяются настройки будильника.
Путь команды:
/domain/<DOMAIN>/ss/alarm/set
Синтаксис:
set <ADDRESS> <PROPERTY> = <VALUE>[, ...]
Параметры:
<ADDRESS> - номер телефона (диапазон номеров), для которого настраивается будильник;<PROPERTY> - свойство будильника, которое нужно изменить:
- call_attempt_count - количество попыток вызова до абонента, целое число, по умолчанию - 3;
- call_attempt_timeout - тайм-аут между повторными вызовами на абонента (в секундах), целое число, по умолчанию - 60;
- cancel_digits - символ или набор символов, по которому будет идти отбой будильника, возможные значения 1234567890*#, по умолчанию - *.
- no_answer_timeout - тайм-аут по неответу (в секундах), в течение которого будильник будет пытаться дозвониться до абонента, целое число. По умолчанию - 45.
<VALUE> - значение свойства.
Пример:
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/alarm/set 240475 call_attempt_count = 3 Success: Supplementary service alarm was updated for domain "biysk.local" address "240475"