В данном разделе описываются команды управления будильниками для абонентов в рамках определенного домена.

<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"