В разделе описываются команды управления сервисом Distinctive Ring.

Для персонализации услуги был добавлен сервис "Звонок особого типа" ("Distinctive Ring"), позволяющий конкретному пользователю переопределять определенные группы номеров либо же конкретные номера.
Пользовательский сервис имеет приоритет над доменной настройкой. Так к примеру для звонка с номера 1000 совершенного сервисом VipCall абоненту с активированным сервисом Distinctive Ring, при совпадении номера с одним из правил, будет проиграна мелодия из правила, а не из доменной настройки VipCall. Таких правил может быть не более 100 для каждого абонента. Это связано с тем, что правила проверяются поочередно, подыскивая наиболее полное совпадение. В случае звонка с номера 1000 среди правил 1, 10, 100, будет выбрано правило 100, т.к. он наиболее полно совпадает, а среди правил 1 и 1001 будет выбрано правило 1, т.к. 1001 имеет несовпадение, не смотря на более длинную последовательность совпавших символов.

Правила идентифицируются по префиксу т.к. два разных правила с одним префиксом существовать не могут.

Для каждого правила, пользователь выбирает имя ринга и медиафайл. В отличии от доменной настройки, здесь они никак не взаимосвязаны. Таким образом пользователь сможет сам решить, какой медиафайл проигрывать и какой рингтон проигрывать в случае недоступности медиафайла.

Общий путь команд:

domain/<DOMAIN>/ss/distinctive-ring/
где <DOMAIN> - имя виртуальной АТС.

activate

Команда предназначена для активации сервиса Distinctive Ring для указанного диапазона номеров.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/activate

Синтаксис:

activate <ADDRESS_RANGE>

Параметры:

<ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/activate 240101
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240101"
Перед активацией услуги, для абонента необходимо настроить правила командой domain/<DOMAIN>/ss/distinctive-ring/rule-add

deactivate

Команда для деактивации сервиса Distinctive Ring.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/deactivate

Синтаксис:

deactivate <ADDRESS_RANGE>

Параметры:

<ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/deactivate 240101              
Success: Supplementary service distinctive_ring deactivated for domain "biysk.local", address "240101".

info

Команда предназначена для просмотра правил сервиса Distinctive Ring для указанного диапазона номеров.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/info

Синтаксис:

info [<ADDRESS_RANGE>]

Параметры:

<ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/info
┌───────┬────┬──────┬──────────────────────┐
│Address│Mask│RingId│      MediaPaths      │
├───────┼────┼──────┼──────────────────────┤
│240101 │991 │ring03│domain://ring/beep.wav│
│       │240 │ring01│domain://ring/dash.wav│
└───────┴────┴──────┴──────────────────────┘

rule-add

Команда предназначена для добавления правила для сервиса Distinctive Ring для указанного диапазона номеров.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/rule-add

Синтаксис:

rule-add <ADDRESS_RANGE> <PREFIX> <RING_ID> <RING_PATH>

Параметры:

  • <ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу;
  • <PREFIX> - префикс адресов, для которых необходимо изменить рингтон;
  • <RING_ID> - ring идентификатор адресов, для которых необходимо активировать;
  • <RING_PATH> - путь на restfs кластере, где расположен рингтон для воспроизведения.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/rule-add 240101 991 ring03 [domain ring/beep.wav] 
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240101"

rule-change

Команда заменяет значения существующего правила для сервиса Distinctive Ring для указанного диапазона номеров.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/rule-change

Синтаксис:

rule-change <ADDRESS_RANGE> <PREFIX> [ringID <RING_ID> | ringPath <RING_PATH>]

Параметры:

  • <ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу;
  • <PREFIX> - префикс адресов, для которых необходимо изменить рингтон;
  • <RING_ID> - ring идентификатор адресов, для которых необходимо активировать;
  • <RING_PATH> - путь на restfs кластере, где расположен рингтон для воспроизведения.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/rule-change 240101 240 ringPath [domain ring/dash.wav]      
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240101"

rule-remove

Команда предназначена для удаления существующих правил сервиса Distinctive Ring для указанного диапазона номеров.

Путь команды:

/domain/<DOMAIN>/ss/distinctive-ring/rule-remove

Синтаксис:

rule-remove <ADDRESS_RANGE> <PREFIX>

Параметры:

<ADDRESS_RANGE> - диапазон номеров, для которых необходимо активировать услугу;
<PREFIX> - префикс адресов, для которых необходимо изменить рингтон.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/ss/distinctive-ring/rule-remove 240101 991
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240101"