/cluster/core/<CORE>/cfc/ — команды управления службой CFC
В данном разделе описываются команды управления службой CFC (Call Forwarding by Cause).
Служба CFC отвечает за маршрутизацию вызовов по причине разъединения — неуспешные вызовы могут маршрутизироваться на автоинформатор по определенной причине разъединения. Для настройки службы CFC необходимо настроить соответствие между причиной разъединения (ISUP или ACP cause) и мелодией, которая должна проигрываться на данное событие.
Для администратора системы команды выполняются на уровне кластера в разделе /cluster/core/<CORE>/cfc/.
<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 |
|
|
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 — запретить принудительное озвучивание причины разъединения данным сервисом.
Примеры:
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.