В данном разделе описываются команды работы 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-status-messages/clean 

Синтаксис:

clean [<CODE>] [--force]

Параметры:

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

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

Пример:

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

[exec at: 12.03.2021 10:41:13, exec time: 283ms, nodes: md1@ecss2 v.3.14.8.26]

info

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

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

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

Синтаксис:

info [<CODE>]

Параметры:

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

Пример:

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-status-messages/info 404
┌────────┬───────────┬──────────────────┐
│Property│  Domain   │      Value       │
├────────┼───────────┼──────────────────┤
│404     │biysk.local│default: Not Found│
│        │           │en: Not Found     │
│        │           │ru: Не найдено    │
│        │           │fr: Non trouvé    │
└────────┴───────────┴──────────────────┘

[exec at: 12.03.2021 10:40:46, exec time: 32ms, nodes: core1@ecss2 v.3.14.8.26]

set

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

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

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

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

Синтаксис:

set  <CODE> <LANG> <MESSAGE>

Параметры:

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

Примеры:

admin@mycelium1@ecss1:/$ domain/biysk.local/sip/sip-status-messages/set 404 fr Non trouvé  
Property "404" successfully changed from: 
default: Not Found
en: Not Found
ru: Не найдено

   to
default: Not Found
en: Not Found
ru: Не найдено
fr: Non trouvé
.

[exec at: 12.03.2021 10:37:15, exec time: 280ms, nodes: core1@ecss1 v.3.14.8.26]

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

   to
666 -> default: unknown error
.

[exec at: 12.03.2021 11:11:26, exec time: 256ms, nodes: md1@ecss1 v.3.14.8.26]