В данном разделе описываются команды по управлению адаптациями номеров.

Подробнее описание настроек адаптации номеров описано в разделе Модификаторы и адаптация номеров по входу/выходу с интерфейса.

<DOMAIN> - имя виртуальной АТС.

delete

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

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

/domain/<DOMAIN>/adaptation/delete

Синтаксис:

delete <Context>

Параметры:

<Context> - название контекста адаптации номеров.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/delete mod1_adp 
Adaptation was deleted

[exec at: 28.03.2019 13:05:59, exec time: 166ms, nodes: ds1@ecss1]

edit

Данной командой производится редактирование контекстов адаптации.

При выполнении команды осуществляется запуск редактора, который выбран командой shell-options editor

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

/domain/<DOMAIN>/adaptation/edit

Синтаксис:

edit <Node> <Context>

Параметры:

<Node> - имя ноды;
<Context> - название контекста адаптации номеров.

Примеры:

Редактирование определенного контекста адаптации:

admin@[ds1@ecss1]:/$ domain/biysk.local/adaptation/edit ctx_city_common              
Importing adaptation context from /tmp/adaptation-0.4661.0.xml
Success: Context was imported

[exec at: 14.03.2019 13:58:54, exec time: 275ms, nodes: ds1@ecss1]

export

Команда предназначена для экспорта заданного контекста адаптации номеров. Каталог для экспорта контекста адаптации распологается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.

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

/domain/<DOMAIN>/adaptation/export

Синтаксис:

export <Node> <Context>

Параметры:

<Node> - имя ноды;
<Context> - название контекста адаптации номеров.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/export ecss1 default_adaptation 
Context default_adaptation has been exported

[exec at: 28.03.2019 12:59:27, exec time: 210ms, nodes: ds1@ecss1]

import

Команда предназначена для импорта ранее сохраненных файлов, описывающих контексты адаптации номеров. Каталог для импорта контекста адаптации распологается по пути /var/lib/ecss/adaptations/ctx/src/<DOMAIN>.

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

/domain/<DOMAIN>/adaptation/import

Синтаксис:

import <Host> <File>

Параметры:

<Host> - имя хоста, где находится сохраненных файл;
<File> - имя файла с контекстом адаптации номеров, который необходимо установить;

При задании имени файла можно использовать маску поиска:
"?" - соответствует одному символу;
"*" - соответствует любому количеству символов до конца файла, следующей точки или символа "/". {Item,...} - для указания альтернативного файла.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/import ecss1 adp_1.xml 
importing file adp_1.xml...
generated 3 rules
1 context has been successfully imported

[exec at: 28.03.2019 12:44:20, exec time: 884ms, nodes: ds1@ecss1]

list

Команда предназначена для просмотра списка адаптаций в домене.

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

/domain/<DOMAIN>/adaptation/list

Синтаксис:

list

Параметры:

Команда не содержит аргументов.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/list 
Adaptations:

biysk.local/default_adaptation
biysk.local/mod1_adp
---------
Total: 2

[exec at: 28.03.2019 12:28:55, exec time: 75ms, nodes: ds1@ecss2]

show

Команда предназначена для просмотра контекста адаптации номеров в текстовом виде.

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

domain/<DOMAIN>/adaptation/show

Синтаксис:

show <ContextName>

Параметры:

<ContextName> - имя контекста адаптации.

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/show mod1_adp 
Context was imported at 20.03.2019 21:07:24

<?xml version="1.0" encoding="UTF-8"?>
 <adaptation xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="ecss_modificators.xsd" name="mod1_adp">
 <rule name="local_calls">
 <conditions>
 <cdpn digits="240464"/>
 <time value="09:00 - 18:00"/>
 <date value="01.01.2019 - 30.12.2019"/>
 <weekday value="1,2,3,4,5"/>
 </conditions>
 <actions>
 <cdpn digits="240466"/>
 <cn digits="419145"/>
 </actions>
 <result>
 <finish/>
 </result>
 </rule>
 <rule name="other_calls">
 <conditions/>
 <actions/>
 <result>
 <finish/>
 </result>
 </rule>
 </adaptation>


[exec at: 28.03.2019 11:55:46, exec time: 100ms, nodes: ds1@ecss2]

trace

Данной командой осуществляется запуск процесса адаптации номеров для СОРМ, ТТС и вывод результатов для указанного набора входных данных.
Эта команда предоставляет удобный способ проверки корректности описания адаптации номеров в системе, четко отображающий шаги адаптации конкретного номера.

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

domain/<DOMAIN>/adaptation/trace

Синтаксис:

Команда уровня виртуальной АТС аналогична командам трассировки маршрутизации:
trace [<Key1> = <Value1>[, ... [, <KeyN> = <ValueN>]]]

Параметры:

type - sorm | tts - тип модификации, СОРМ или ТТС;
cgpn - параметры Calling party number (опциональный параметр);
cdpn - параметры Called party number, cdpn.digits (обязательный параметр);
rgn - параметры Redirecting number (опциональный параметр);
rnn - параметры Redirection number (опциональный параметр);
ocdpn - параметры Original called party number (опциональный параметр);
cn - параметры ConnectedNumber (опциональный параметр);
context - имя контекста модификации, (опциональный параметр) (по умолчанию: контекст адаптации для СОРМ/ТТС);
date - дата запроса (D.M.Y or Y/M/D), (опциональный параметр) (по умолчанию: сегодня);
time - время запроса (H:M), (опциональный параметр) (по умолчанию: сейчас).

Пример:

admin@[mycelium1@ecss1]:/$ domain/biysk.local/adaptation/trace context=mod1_adp cgpn.digits=240101 cdpn.digits=240464 time=14:00 type=tts 
Traceroute to 240464 from 240101 (tts adaptation) at 28.03.2019 14:00:00
Default context is mod1_adp
mod1_adp / default
A: "240101"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined)
B: "240464"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)
 applying rule: local_calls (CDPN: digits=240464, Time: 01.01.2019 09:00 - 30.12.2019 18:00, Weekdays: Mon, Tue, Wed, Thu, Fri)
 action: transform cdpn digits=240466
 action: transform cn digits=419145
------------------------------------------

Adaptation result: finish
A: "240101"(displayName=undefined, ni=private, nai=unknown, inc=false, npi=isdnTelephony, apri=presentationAllowed, screening=networkProvided, category=ordinarySubscriber(10), caller_id=undefined)
B: "240466"(displayName=undefined, ni=private, nai=unknown, inc=false, inni=undefined, npi=undefined, category=undefined)
CN: "419145"(displayName=undefined, ni=private, nai=subscriberNumber, npi=isdnTelephony, apri=presentationAllowed)

[exec at: 28.03.2019 13:03:32, exec time: 66ms, nodes: ds1@ecss1]