В данном разделе описываются команды работы c текстовыми описаниями SIP ошибок для разных языков. Выбор текстового описания производится в зависимости от настроек абонента:

• язык - параметр language из настроек alias;
• поддерживаемая кодировка - параметр support-encoding из настроек iface.

Если у абонента выставлена кодировка latin1 и русский язык, то производится транслитерация. Если у абонента выставлена кодировка latin1 или cp1251 и языки, отличные от английского и русского, то используются сообщения для английского языка (default). Если параметры для абонента неизвестны, то используются сообщения для английского языка (default) и кодировка utf8.

Для включения/выключения локализации используется команда:

admin@mycelium1@ecss1:/$ /domain/biysk.local/sip/properties/set messages_localization_enable true 
Property "messages_localization_enable" successfully changed from: 
false
   to
true.

[exec at: 12.03.2021 09:01:28, exec time: 128ms, nodes: sip1@ecss1 v.3.14.8.26]

clean

Командой устанавливаются значение по умолчанию для указанного SIP cause.

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

/domain/<DOMAIN>/sip/sip-error-messages/clean 

Синтаксис:

clean [<CODE>] [--force]

Параметры:

<CODE> - название параметра, значение которого нужно установить по умолчанию. Опциональный параметр. Если параметр не указывать, то все значения будут установлены по умолчанию;

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

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-error-messages/clean external     
Property external values successfully restored

[exec at: 12.03.2021 09:51:00, exec time: 191ms, nodes: core1@ecss2 v.3.14.8.26]

info

Команда просмотра информации о текстовых описаниях определенных для SIP ответов.

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

/domain/<DOMAIN>/sip/sip-error-messages/info 

Синтаксис:

info [<CODE>]

Параметры:

<CODE> – настраиваемый опциональный параметр, если не указывать параметр, будет показана информация обо всех ошибках в ответах. 

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-error-messages/info name_is_busy
┌────────────┬───────────┬─────────────────────────────────┐
│  Property  │  Domain   │              Value              │
├────────────┼───────────┼─────────────────────────────────┤
│name_is_busy│biysk.local│default: Identifiers name is busy│
│            │           │en: Identifiers name is busy     │
│            │           │ru: Идентификатор занят          │
│            │           │fr: Id occupé                    │
└────────────┴───────────┴─────────────────────────────────┘

[exec at: 12.03.2021 09:44:20, exec time: 23ms, nodes: md1@ecss2 v.3.14.8.26]

set

Команда установки значения текстовых  описаний при использовании различных языков в заголовках ошибки  SIP ответов.

Также возможно добавление/удаление дополнительных кодов через свойство external.

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

/domain/<DOMAIN>/sip/sip-error-messages/set

Синтаксис:

set  <CODE> <LANG> <MESSAGE>

Параметры:

• <CODE> – внутренняя ошибка;
• <LANG> - язык для которого выставляется текст ошибки;
• <MESSAGE> - текст сообщения ошибки.

Примеры:

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-error-messages/set name_is_busy fr Id occupé  
Property "name_is_busy" successfully changed from: 
default: Identifiers name is busy
en: Identifiers name is busy
ru: Идентификатор занят

   to
default: Identifiers name is busy
en: Identifiers name is busy
ru: Идентификатор занят
fr: Id occupé
.

[exec at: 12.03.2021 09:25:23, exec time: 195ms, nodes: core1@ecss2 v.3.14.8.26]

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-error-messages/set external add 101 default "unknown error"
Property "external" successfully changed from: 

   to
101 -> default: unknown error
.

[exec at: 12.03.2021 09:17:07, exec time: 185ms, nodes: md1@ecss1 v.3.14.8.26]