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

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

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

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

activate

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

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

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

Синтаксис:

activate <ADDRESS_RANGE>

Параметры:

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/distinctive-ring/activate 240475 
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240475"

[exec at: 24.03.2019 18:09:38, exec time: 91ms, nodes: ds1@ecss1]

deactivate

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

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

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

Синтаксис:

deactivate <ADDRESS_RANGE>

Параметры:

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

Пример:

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

[exec at: 24.03.2019 18:32:09, exec time: 100ms, nodes: ds1@ecss2]

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│Prefix│RingId│            MediaPath             │
├───────┼──────┼──────┼──────────────────────────────────┤
│240101 │991   │ring03│domain/biysk.local/ring/nvh.wav   │
│       │383   │ring04│system/sounds/ring/zdravstujte.wav│
│240244 │3854  │ring01│system/sounds/ring/nvh.wav        │
│       │24    │ring01│domain/biysk.local/ring/oh.mp3    │
│240475 │      │      │                                  │
└───────┴──────┴──────┴──────────────────────────────────┘

[exec at: 24.03.2019 18:30:15, exec time: 83ms, nodes: ds1@ecss2]

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 идентификатор адресов, для которых необходимо активировать.

Пример:

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

[exec at: 24.03.2019 18:24:37, exec time: 94ms, nodes: ds1@ecss2]

rule-change

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

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

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

Синтаксис:

rule-change <ADDRESS_RANGE> <PREFIX> [ringId <RING_ID> | ringAddress <ADDRESS_RING>]

Параметры:

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

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/ss/distinctive-ring/rule-change 240101 383 ringAddress system sounds/ring/zdravstujte.wav ringId ring04
Success: Supplementary service distinctive_ring activated for domain "biysk.local" address "240101"

[exec at: 24.03.2019 18:26:57, exec time: 91ms, nodes: ds1@ecss1]

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"

[exec at: 24.03.2019 18:31:04, exec time: 137ms, nodes: ds1@ecss2]