В данном разделе описываются команды настройки базового приложения core_trike_tts сервиса TTS, доступные администратору виртуальной АТС.

Таблица 1 — Описание параметров приложения "core_trike_tts" сервиса TTS, доступные администратору виртуальной АТС

Название	Значение по умолчанию	Описание
actual_calls_archive_size	1000	Количество завершенных вызовов, которое будет хранить сервис service_actual_calls.
actual_calls_enabled	true	Определяет, включен (true) или выключен (false) сервисе истории вызовов (будет или нет история вызовов сохраняться в базу).
adaptation	undefined	текущая адаптация
autoclean_enabled	true	Определяет, активирована ли автоочистка.
autoclean_start_at	every 1 day at 00:00	Определяет время и периодичность запуска автоочистки. Задается в следующих видах: - every <N> (day/week/month/year) at <HH:MM>, где <N> — автоочистка будет срабатывать каждые <N> дней (недель, месяцев, лет соответственно) в заданное время с небольшой погрешностью, необходимой, чтобы при большом количестве доменов не создать большую нагрузку на сервер MySQL. Например, значение "every 1 day at 00:00" означает, что автоочистка будет запускаться каждый день около полуночи. - at <DD.MM.YYYY HH:MM:SS> — автоочистка сработает в заданное время, после чего задача автоматически удалится. Например, "at 22.12.2014 15:00:00" означает, что необходимо выполнить очистку 22 декабря 2014 года ровно в 15:00.
cdr_columns_name		Команда позволяет изменить название колонки <column> на новое
cdr_generation_enabled	true	Определяет, включена (true) или выключена (false) запись CDR в БД и генерации CDR-файлов.
cdr_header	"Eltex SSW cdr"	Если включена опция generate_cdr_without_fields, сюда добавляется кастомное название устройства.
cdr_field_delimiter	semicolon	Разделитель полей CDR: tab — символ Tab (\t); space — пробел ( ); comma — запятая (,); semicolon — точка с запятой (;); 0..255 отображает символ, указаный в формате десятичного ASCII кода.
cdr_field_delimeter_representation	ppp_hex_representation	Определяет в каком формате будет присутствовать символ - разделитель полей, если он встречается внутри поля: ppp_hex_representation отображает символ в стилистике протокола PPP4 (символ точка с запятой заменится последовательностью 0x3B ); ascii_hex_representation отображает символ в стилистике ASCII escape symbol(символ точка с запятой заменится последовательностью \x3B); url_hex_representation отображает символ в стилистике протокола URI (символ точка с запятой заменится последовательностью %3B); 0..255 отображает символ, указаный в формате десятичного ASCII кода: #(разделитель пробел кодируется 32).
cdr_type	normal	Определяет формат создаваемых CDR-файлов: расширенный (extended), обычный (normal) или задаваемый вручную (manual). Расширенный режим отличается от обычного дополнительными полями: - CODEC — список кодеков; - T_DNA — время ожидания ответа абонента при неотвеченном вызове, в секундах. В manual режиме список колонок создаваемого CDR-файла берется из свойства manual_cdr_columns
cdr_time_rounding	downside	Определяет режим округления времени при записи CDR-файлов. Доступные значения: downside — округление в меньшую сторону путем, берется только прошедшее целое количество секунд (2999мс округляется до 2-x секунд); upside — округление в большую сторону путем. Если количество миллисекунд в последней секунде > 0 — считается эту секунду (1001мс округляется до 2-x секунд); downside_with_delta — округление в меньшую сторону, если количество миллисекунд в последней секунде <= 850, иначе, округляем в большую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды — то время вызова будет равно 1 секунде; upside_with_delta — округление в большую сторону, если количество миллисекунд в последней секунде >= 330, иначе, округляем в меньшую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды — то время вызова будет равно 1 секунде; mathematically — математическое округление. Если количество миллисекунд в последней секунде >= 500 — округляем в большую сторону, иначе — в меньшую; millisecond — записываем время в CDR в миллисекундах.
manual_cdr_columns	type, datetime, okod_a, okod_b, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b, t_ecd, t_dba, t_dna, cause_isup, cause_int, completind, origin_dig, dialed_dig, actsusb, categ_a, categ_b, place, rec_seq, servuser, servindic, treatment, conn_id, redirected, redirection, orig_called, port_a, port_b, src_ip, dst_ip, src_port, dst_port, media_proxy, codec, diagnostic, domain, cdr_group, signal_src_ip, signal_dst_ip, signal_src_port, signal_dst_port, call_record_a, call_record_b, isup_spc_a, isup_spc_b, isup_dpc_a, isup_dpc_b, isup_ni_a, isup_ni_b, cic_a, cic_b, smg_nai_a, smg_nai_b, date_time, call_duration, type_a, type_b, start_time, end_time, redirect_flag, inf_connection	Задается список колонок, которые будут присутствовать в CDR-файле. При этом колонки будут в том порядке, в каком они заданы.
enabled	true	Определяет, включен (true) или выключен (false) сервис TTS (история вызовов, запись CDR).
generate_cdr_without_fields	false	Определяет скрывать ли стандартные заголовки полей в первой строке cdr- файла.
partial_cdr_timeout	300	Период, по истечении которого в базе данных создается запись с информацией о вызове. Также параметр задает периодичность, с которой будут выгружаться "partial CDR", в секундах.
port_source	iface_name	Формат записи имен интерфейсов: iface_name — в CDR/tollticket будет записано имя интерфейса; iface_id — в CDR/tollticket будет записано id интерфейса.
purge_older_than	2 month	Период времени, по истечении которого записи в базе данных будут удалены. Значение может быть задано в часах (hour[s]), днях (day[s]), неделях (week[s]), месяцах (month[s]), годах (year[s]).
sign_cdr_enabled	false	Опция, при включении которой (значение "true") будет производиться цифровая подпись CDR-файлов и отдельных записей в рамках CDR-файлов. В CDR-файл будет добавлена колонка с именем SIGN, в которой для каждой записи будет прописана её цифровая подпись. Кроме того, в CDR-файле будет создана CDR-запись типа "final", все поля которой, кроме "SIGN", будут пустыми. В поле "SIGN" у данной записи будет подпись всего CDR-файла.

Набор полей при разных cdr_type:

normal

type
datetime
kod_a
kod_b
n_tr_gr_a
n_tr_gr_b
t_ecd
t_dba
cause_isup
cause_int
completind
dialed_dig
actsusb
categ_a
place
rec_seq
servuser
servindic
treatment
conn_id
redirected
redirection
orig_called
src_ip
dst_ip
port_a
port_b
diagnostic

extended

type
datetime
kod_a
kod_b
n_tr_gr_a
n_tr_gr_b
t_ecd
t_dba
t_dna
cause_isup
cause_int
completind
dialed_dig
actsusb
categ_a
place
rec_seq
servuser
servindic
treatment
conn_id
redirected
redirection
orig_called
src_ip
dst_ip
port_a
port_b
media_proxy
diagnostic
codec

manual

type
datetime
okod_a
okod_b
kod_a
kod_b
nai_a
nai_b
n_tr_gr_a
n_tr_gr_b
t_ecd
t_dba
t_dna
cause_isup
cause_int
completind
origin_dig
dialed_dig
actsusb
categ_a
categ_b
place
rec_seq
servuser
servindic
treatment
conn_id
redirected
redirection
orig_called
port_a
port_b
src_ip
dst_ip
src_port
dst_port
media_proxy
codec
diagnostic
domain
cdr_group
signal_src_ip
signal_dst_ip
signal_src_port
signal_dst_port
call_record_a
call_record_b
isup_spc_a
isup_spc_b
isup_dpc_a
isup_dpc_b
isup_ni_a
isup_ni_b
cic_a
cic_b
smg_nai_a
smg_nai_b
date_time
call_duration
type_a
type_b
start_time
end_time
redirect_flag
inf_connection

При этом в режиме manual можно менять состав колонок и их порядок

clean

Данной командой восстанавливаются значения заданных параметров по умолчанию.

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

/domain/<DOMAIN>/tts/properties/clean

Синтаксис:

clean [<FIELD>] [--force]

Параметры:

<FIELD> - название параметра, значение которого нужно установить по умолчанию, список параметров приведен в таблице 1.

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

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/tts/properties/clean adaptation              
Property adaptation values successfully restored

info

Данная команда служит для просмотра информации о настройках параметров приложения "core_trike_tts" сервиса TTS.

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

/domain/<DOMAIN>/tts/properties/info

Синтаксис:

info [<FIELD>]

Параметры:

<FIELD> - название параметра, список параметров приведен в таблице 1.

Пример:

Посмотреть информацию о настройках приложения "core_trike_tts" сервиса TTS для виртуальной АТС "test.domain".

admin@mycelium1@ecss1$ domain/biysk.local/tts/properties/info                             
┌──────────────────────────────────┬───────────┬────────────────────────────────────────────────────────────────────────────────┐
│             Property             │  Domain   │                                     Value                                      │
├──────────────────────────────────┼───────────┼────────────────────────────────────────────────────────────────────────────────┤
│actual_calls_archive_size         │biysk.local│1000                                                                            │
│actual_calls_enabled              │biysk.local│true                                                                            │
│adaptation                        │biysk.local│undefined                                                                       │
│autoclean_enabled                 │biysk.local│true                                                                            │
│autoclean_start_at                │biysk.local│every 1 day at 00:00:00                                                         │
│cdr_columns_name                  │biysk.local│                                                                                │
│cdr_field_delimiter               │biysk.local│comma (,)                                                                       │
│cdr_field_delimiter_representation│biysk.local│ppp_hex (';' -> 0x3B)                                                           │
│cdr_generation_enabled            │biysk.local│true                                                                            │
│cdr_header                        │biysk.local│biysk                                                                           │
│cdr_time_rounding                 │biysk.local│downside                                                                        │
│cdr_type                          │biysk.local│manual                                                                          │
│enabled                           │biysk.local│true                                                                            │
│generate_cdr_without_fields       │biysk.local│false                                                                           │
│manual_cdr_columns                │biysk.local│type, datetime, okod_a, okod_b, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b│
│                                  │           │, t_ecd, t_dba, t_dna, cause_isup, cause_int, completind, origin_dig, dialed_dig│
│                                  │           │, actsusb, categ_a, categ_b, place, rec_seq, servuser, servindic, treatment, con│
│                                  │           │n_id, redirected, redirection, orig_called, port_a, port_b, src_ip, dst_ip, src_│
│                                  │           │port, dst_port, media_proxy, codec, diagnostic, domain, cdr_group, signal_src_ip│
│                                  │           │, signal_dst_ip, signal_src_port, signal_dst_port, call_record_a, call_record_b,│
│                                  │           │ isup_spc_a, isup_spc_b, isup_dpc_a, isup_dpc_b, isup_ni_a, isup_ni_b, cic_a, ci│
│                                  │           │c_b, smg_nai_a, smg_nai_b, date_time, call_duration, type_a, type_b, start_time,│
│                                  │           │ end_time, redirect_flag, inf_connection                                        │
│partial_cdr_timeout               │biysk.local│3600                                                                            │
│port_source                       │biysk.local│iface_name                                                                      │
│purge_older_than                  │biysk.local│2 month                                                                         │
│sign_cdr_enabled                  │biysk.local│false                                                                           │
└──────────────────────────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘

[exec at: 04.02.2022 15:30:26, exec time: 38ms, nodes: md1@ecss1 v.3.14.11.41]

Описание таблицы:

Property - название параметра;
Domain - имя виртуальной АТС;
Value - значение параметра.

set

Данной командой выполняется настройка параметров приложения "core_trike_tts" сервиса TTS.

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

/domain/<DOMAIN>/tts/properties/set

Синтаксис:

set <FIELD> <VALUE>

Параметры:

<FIELD> - название конфигурируемого параметра, список параметров приведен в таблице 1;
<VALUE> - значение параметра.

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/tts/properties/set adaptation default_adaptation 
Property "adaptation" successfully changed from: 
undefined
   to
default_adaptation.