/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 | |
| 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_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 |
| invalid_collected_information | system://sounds/ai_wrong_number.wav |
| invalid_number | system://sounds/ai_invalidnumber.wav |
| no_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.