В данном разделе описываются команды управления службой CFC (Call Forwarding by Cause).
Служба CFC отвечает за маршрутизацию вызовов по причине разъединения — неуспешные вызовы могут маршрутизироваться на автоинформатор по определенной причине разъединения. Для настройки службы CFC необходимо настроить соответствие между причиной разъединения (ISUP или ACP cause) и мелодией, которая должна проигрываться на данное событие.

Для администратора системы команды выполняются на уровне кластера в разделе /cluster/core/<CORE>/cfc/.

<CORE> — имя кластера CORE;
<DOMAIN> — имя виртуальной АТС.

clean

Данной командой осуществляется установка автоинформатора по умолчанию для определенной причины "сause" службы CFC:

Таблица 1. Значения CFC по умолчанию

Название свойства	Значение по умолчанию	Описание
apty_abandon		Автоинформатор при завершении вызова, если пользователь кладет трубку перед ответом
apty_disc		Автоинформатор при завершении вызова, если абонент А кладет трубку
authorisation_failure	system://sounds/ai_wrong_number.wav	"Неправильно набран номер"
bpty_busy_ndub		Автоинформатор, если абонент Б отклоняет вызов
bpty_busy_udub		Автоинформатор, если абоонент Б занят
bpty_disc		Автоинформатор, если абонент Б положил трубку
bpty_no_answer	system://sounds/ai_no_answer.wav	"Абонент не отвечает"
call_being_forwarded
called_party_rejected
collect_information_failure	system://sounds/ai_wrong_number.wav	"Неправильно набран номер"
conversation_timeout	system://sounds/ai_conversation_timeout.wav	"Достигнуто установленное ограничение на максимальную продолжительность разговора"
destination_out_of_order	system://sounds/ai_error.wav	"Произошла ошибка"
do_not_disturb
enable	true	Включение службы CFC
external_acp_causes		Список дополнительных ACP причин разъединения
external_isup_causes	1 -> system://sounds/ai_number_absent.wav 2 -> system://sounds/ai_wrong_number.wav 3 -> system://sounds/ai_wrong_number.wav 18 -> system://sounds/ai_no_answer.wav 19 -> system://sounds/ai_no_answer.wav 20 -> system://sounds/ai_notconnected.wav 21 -> system://sounds/ai_notaccess.wav 22 -> system://sounds/ai_number_not_ready.wav 27 -> system://sounds/ai_out_of_order.wav 28 -> system://sounds/ai_invalidnumber.wav 34 -> system://sounds/ai_overload.wav 38 -> system://sounds/ai_error.wav 41 -> system://sounds/ai_error.wav 42 -> system://sounds/ai_system_problem.wav 102 -> system://sounds/ai_timeout.wav	"Извините, данный номер не существует" "Неправильно набран номер" "Неправильно набран номер" "Абонент не отвечает" "Абонент не отвечает" "Аппарат абонента не подключен к станции" "Данный вид связи не входит в перечень услуг с вашего аппарата" "Номер, который вы набираете, в стадии изменения" "Направление недоступно" "Неправильно набран номер" "На данном направлении перегрузка" "Произошла ошибка" "Произошла ошибка" "На данном направлении перегрузка" "Время ожидания истекло"
foreground	false	Принудительное воспроизведение звука автоинформатора в случае вызова более чем одной службы CFC
invalid_collected_information	system://sounds/ai_wrong_number.wav	"Неправильно набран номер"
invalid_number	system://sounds/ai_invalidnumber.wav	"Неправильно набран номер"
no_circuit_available	system://sounds/ai_badroute.wav	"На данный момент все линии заняты"
no_requested_circuit_available	system://sounds/ai_badroute.wav	"На данный момент все линии заняты"
normal
not_reachable	system://sounds/ai_not_reachable.wav	"Номер временно не может быть вызван"
number_incomplete	system://sounds/ai_invalidnumber.wav	"Неправильно набран номер"
o_no_answer	system://sounds/ai_no_answer.wav	"Абонент не отвечает"
origination_denied	system://sounds/ai_notaccess.wav	"Данный вид связи не входит в перечень услуг с вашего аппарата"
route_failure1
route_failure2
route_select_failure	system://sounds/ai_out_of_order.wav	"Направление недоступно"
ss7_failure	system://sounds/ai_system_problem.wav	"На данном направлении перегрузка"
system_failure	system://sounds/ai_system_problem.wav	"На данном направлении перегрузка"
t_exception	system://sounds/ai_system_problem.wav	"На данном направлении перегрузка"
termination_denied	system://sounds/ai_tempdenied.wav	"Номер временно не может быть вызван"
unassigned_number	system://sounds/ai_notconnected.wav	"Аппарат абонента не подключен к станции"

Описание внутренних причин разъединения (АСР сause) приведено в Приложении Г. Описание внутренних причин разъединения.

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

/cluster/core/<CORE>/cfc/clean

Синтаксис:

clean [<DOMAIN> [<FIELD>]] [--force]

Параметры:

<FIELD> — внутренняя причина разъединения (cause). Если не указывать данный параметр, то значения по умолчанию будут восстановлены для всех "сause";

--force — выполнение команды без запроса подтверждения.

Пример:

admin@mycelium1@ecss1:/$ cluster/core/core1/cfc/clean * --force
Properties values successfully restored

[exec at: 09.03.2021 13:48:23, exec time: 211ms, nodes: core1@ecss1 v.3.14.8.16]

info

Команда просмотра установленных значений автоинформаторов для "сause" сервиса CFC.

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

/cluster/core/<CORE>/cfc/info

Синтаксис:

info [<FIELD>]

Параметры:

<Field> — название свойства, принимает значения, указанные в таблице 1.

Пример:

admin@mycelium1@ecss1:/$ cluster/core/core1/cfc/info 
┌──────────────────────────────┬───────────┬─────────────────────────────────────────────┐
│           Property           │  Domain   │                    Value                    │
├──────────────────────────────┼───────────┼─────────────────────────────────────────────┤
│anonymity_disallowed          │           │                                             │
│apty_abandon                  │           │                                             │
│apty_disc                     │           │                                             │
│authorisation_failure         │           │system://sounds/ai_wrong_number.wav          │
│bpty_busy_ndub                │           │                                             │
│bpty_busy_udub                │           │                                             │
│bpty_disc                     │           │                                             │
│bpty_no_answer                │           │system://sounds/ai_no_answer.wav             │
│call_being_forwarded          │           │                                             │
│called_party_rejected         │           │                                             │
│collect_information_failure   │           │system://sounds/ai_wrong_number.wav          │
│conversation_timeout          │           │system://sounds/ai_conversation_timeout.wav  │
│destination_out_of_order      │           │system://sounds/ai_error.wav                 │
│do_not_disturb                │           │                                             │
│enable                        │           │true                                         │
│external_acp_causes           │           │                                             │
│external_isup_causes          │           │1 -> system://sounds/ai_number_absent.wav    │
│                              │           │2 -> system://sounds/ai_wrong_number.wav     │
│                              │           │3 -> system://sounds/ai_wrong_number.wav     │
│                              │           │18 -> system://sounds/ai_not_reachable.wav   │
│                              │           │19 -> system://sounds/ai_no_answer.wav       │
│                              │           │20 -> system://sounds/ai_notconnected.wav    │
│                              │           │21 -> system://sounds/ai_notaccess.wav       │
│                              │           │22 -> system://sounds/ai_number_not_ready.wav│
│                              │           │27 -> system://sounds/ai_out_of_order.wav    │
│                              │           │28 -> system://sounds/ai_invalidnumber.wav   │
│                              │           │34 -> system://sounds/ai_overload.wav        │
│                              │           │38 -> system://sounds/ai_error.wav           │
│                              │           │41 -> system://sounds/ai_error.wav           │
│                              │           │42 -> system://sounds/ai_system_problem.wav  │
│                              │           │44 -> system://sounds/ai_overload.wav        │
│                              │           │102 -> system://sounds/ai_timeout.wav        │
│foreground                    │           │false                                        │
│invalid_collected_information │           │system://sounds/ai_wrong_number.wav          │
│invalid_number                │           │system://sounds/ai_invalidnumber.wav         │
│no_circuit_available          │           │system://sounds/ai_badroute.wav              │
│no_requested_circuit_available│           │system://sounds/ai_badroute.wav              │
│normal                        │           │                                             │
│not_reachable                 │           │system://sounds/ai_not_reachable.wav         │
│number_incomplete             │           │system://sounds/ai_invalidnumber.wav         │
│o_no_answer                   │           │system://sounds/ai_no_answer.wav             │
│origination_denied            │           │system://sounds/ai_notaccess.wav             │
│route_failure1                │           │                                             │
│route_failure2                │           │                                             │
│route_select_failure          │           │system://sounds/ai_out_of_order.wav          │
│ss7_failure                   │           │system://sounds/ai_system_problem.wav        │
│system_failure                │           │system://sounds/ai_system_problem.wav        │
│system_failure                │biysk.local│system://sounds/ai_system_problem.wav        │
│t_exception                   │           │system://sounds/ai_system_problem.wav        │
│termination_denied            │           │system://sounds/ai_tempdenied.wav            │
│unassigned_number             │           │system://sounds/ai_notconnected.wav          │
└──────────────────────────────┴───────────┴─────────────────────────────────────────────┘

set

Данной командой выполняется настройка соответствия между внутренним событием и мелодией автоинформатора.

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

/cluster/core/<CORE>/cfc/set

Синтаксис: set <DOMAIN> <FIELD> <VALUE>

Параметры:

<FIELD> — имя свойства, значение которого необходимо изменить.

<VALUE> — новое значение свойства

Для всех свойств доступны значения:

disable — автоинформатор отключен;
system <FILE> — проигрывание файла <FILE>;
tone tone <FREQUENCY1> <FREQUENCY2> <TONE_ON> <TONE_OFF> <DURATION>;
<FREQUENCY> — частота сигнала (Гц). Если нужно использовать одночастотный сигнал, то для второй частоты установите значение 0;
<TONE_ON> — время проигрывания сигнала (ms);
<TONE_OFF> — время проигрывания тишины (время между сигналами) (ms);
<DURATION> — общее время проигрывания тона (dutation = -1 — бесконечное количество повторов).

Исключение составляют свойства:
1. enable — состояние CFC-службы
Принимает значения:

true — включение CFC-службы;
false — отключение CFC-службы.

2. external_acp_causes и external_isup_causes — управление дополнительными автоинформаторами на заданный ACP или ISUP Cause
Используемые значения:

add <Произвольный ACP Cause> <Номер автоинформатора> disable | system | tone — для добавления дополнительного автоинформатора на заданный ACP Cause;
remove <ACP Cause> — для удаления автоинформатора для определенного <ACP Cause>.

3. foreground — принудительное озвучивание причины разъединения
Принимает значения:

true — разрешить принудительное озвучивание причины разъединения данным сервисом;
false — запретить принудительное озвучивание причины разъединения данным сервисом.

Для выполнения вызова на существующего абонента вместо автоинформатора необходимо в качестве [Идентификатор тона] указать значение "call".

Примеры:

admin@mycelium1@ecss1:/$ cluster/core/core1/cfc/set biysk.local route_failure1 system sounds/ai_number_not_found.wav
Property "route_failure1" successfully changed from: 

   to
system://sounds/ai_number_not_found.wav.

admin@mycelium1@ecss1:/$ cluster/core/core1/cfc/set biysk.local apty_abandon system sounds/ai_busy
Property "apty_abandon" successfully changed from: 

   to
system://sounds/ai_busy.