Приложение осуществляет настройку контекстов, по которым происходит адаптация номеров для СОРМ или TTS. Контексты адаптации могут быть применены к интерфейсу абонента или транку, а так же к группе интерфейсов в целом. Контекст состоит из правил.

• Контекст адаптации – логическая совокупность правил адаптации, уникальная в рамках домена, по которой происходит адаптация номера;
• Правило адаптации – при адаптации вызова описывает правила отбора номера (маску номера), его преобразования и определяет результат адаптации по данному правилу. Всегда существует в рамках определенного контекста адаптации виртуальной АТС.

Управление контекстами адаптации

Для управления контекстами в левом нижнем углу приложения расположена секция "Контекст", в которой присутствуют функциональные кнопки для создания, удаления, экспорта и импорта контекста, а также сохранения изменений после редактирования.

Для добавления нового контекста на панели "Контекст" ("Context") нажмите кнопку  "создать контекст" ("create context").

Заполните следующие поля:

• Имя (Name) – имя контекста модификации, должно быть уникальным в рамках виртуальной АТС;
• Описание (Description) – описание для контекста.

Подтвердите действие нажатием кнопки "Оk". Для выхода без сохранения настроек нажмите кнопку "Отмена" ("Cancel").

Далее в новый контекст могут быть добавлены правила адаптации.

Для редактирования описания контекста выберите контекст и нажмите кнопку "редактировать описание контекста" ("edit context description")  . В поле "Сontext "name" description" измените описание и нажмите кнопку "сохранить контекст" ("save context").

Для удаления контекста адаптации выберите контекст и нажмите кнопку "удалить контекст" ("remove context") . Подтвердите действие нажатием кнопки "Оk".

Для загрузки контекста из файла нажмите кнопку "импортировать контекст" ("import ctx") .

В поле "Файл для импорта" ("File to import") укажите файл загружаемого контекста. Для указания нескольких файлов нажмите кнопку "Добавить контекст.." ("More contexts..").

Нажмите кнопку "Импортировать" ("Import") для установки контекстов в систему. Для выхода без изменения настроек нажмите кнопку "Отмена" ("Cancel").

Для выгрузки файла контекста на ПК нажмите кнопку "экспортировать контекст" ("export ctx") .

Для сохранения выполненных настроек в систему используется кнопка "сохранить контекст" ("save context") .

Управление правилами адаптации

Управление правилами выполняется на панели "Правило" ("Rule"):

Также, управлять правилами можно через контекстного меню. Для вызова контекстного меню выберите правило и нажмите правой кнопкой мыши:

Для добавления нового правила в поле "Контекст" ("Context") выберите контекст адаптации и нажмите кнопку "создать правило" ("create rule") .

В диалоговом окне введите имя и нажмите "ОК":

Для редактирования описания выберите правило в таблице и нажмите кнопку "edit rule description" ("редактировать описание правила") . В поле "Rule "name" description" измените описание и нажмите кнопку "save rule" ("сохранить правило") .

Для удаления выберите правило в таблице и нажмите кнопку "remove rule" ("удалить правило") .

Для создания нового правила с ранее заданными настройками можно скопировать правило, для этого нажмите кнопку "copy rule" ("копировать правило") . При этом скопированное правило размещается ниже выделенного. К имени добавляется суффикс "1".

Для изменения имени выберите правило и нажмите кнопку "rename rule" ("переименовать правило") .

В диалоговом окне введите новое имя правила и нажмите "ОК":

Для перемещения правила вверх нажмите кнопку "Правило вверх" ("rule up") , вниз "Правило вниз" ("rule down") .

Правила проверяются в возрастающем порядке по приоритетам. Чем выше установлено правило, тем выше его приоритет. Когда запрос находит правило, соответствующее требуемым условиям (секция "Условия" ("conditions")), выполняются действия из секции "Действия" ("actions"). Далее адаптация согласно результату правила: либо заканчивается, либо операция повторяется заново с измененным номером, либо заканчивается с ошибкой.

Для сохранения выполненных настроек используется кнопка "сохранить правило" ("save rule") .

Настройка правил адаптации

Настройки для правил адаптации выполняются в следующих разделах:

• Условия (Conditions) – условия срабатывания правила;
• Действия (Actions) – действия по модификации номера;
• Результат (Result) – возвращаемый результат.

Для выполнения настроек выберите правило в таблице и заполните соответствующие поля:

Условия (conditions)

В разделе "Условия" ("conditions") описывается набор условий, выполнение которых приводит к срабатыванию правила.

– cgpn – условия выбора по номеру вызывающего абонента:

• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный:
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• screening – индикатор контроля номера вызывающего абонента:
  • userProvidedNotVerified – предоставлена пользователем, не проверена;
  • userProvidedVerifiedAndPassed – предоставлена пользователем, проверка пройдена;
  • userProvidedVerifiedAndFailed – предоставлена пользователем, проверка не пройдена;
  • networkProvided – предоставлена сетью;

• Номер (digits) – маска цифр номеров вызывающего (А) и вызываемого (В) абонентов.

  Маска номера задается в виде строки, в которой вводится номер, с которым осуществляется сравнение. Можно указать диапазон через «–» либо перечислить через «,». Применяются следующие служебные символы: "?" – один любой не пустой элемент номера (цифры 0–9 либо буквы A, B, C, D, а также *, #); "%" – 0 или несколько элементов номера (внимание: после символа "%" не может идти других символов);

  
  

• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Группа мониторинга (in_list) – название группы для проверки номеров на принадлежность к ней;
• Имя (display_name) – имя вызывающего абонента;
• Идентификатор (caller_id) – альтернативное значение номера вызывающего абонента;
• Город (city) – название города;
  
• Регион (region) – название региона;
• Оператор (operator) – название оператора связи.

– сdpn – условия выбора по номеру вызываемого абонента:

• Номер (digits) – маска цифр номеров вызывающего (А) и вызываемого (В) абонентов, подробное описание приведено выше;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный;
• inni – индикатор внутрисетевого номера, принимает значения:
  • routingToInternalNumberAllowed – маршрутизация на внутренний номер разрешена;
  • routingToInternalNumberNotAllowed – маршрутизация на внутренний номер не разрешена;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;

• Категория (category) – категория вызывающего абонента, может принимать строковое либо цифровое значение согласно таблице:
  Таблица 1 – Категории абонентов

  unknownAtThisTime	0
  operatorFrench	1
  operatorEngish	2
  operatorGerman	3
  operatorRussian	4
  operatorSpanish	5
  reserved	9
  ordinarySubscriber	10	1 – ОАО "Ростелеком"
  subscriberWithPriority	11	4 – ООО "Эквант"
  dataCall	12	8 – ОАО "АРКТЕЛ"
  testCall	13
  spare	14
  payphone	15	6 – ЗАО "Компания ТрансТелеКом"
  category0	224
  hotelsSubscriber	225	2 – ОАО "КОМСТАР–ОТС"
  freeSubscriber	226
  paidSubscriber	227	7 – ЗАО "Синтерра"
  localSubscriber	228	3 – ОАО "Вымпелком" (ранее ООО "СЦС Совинтел")
  localTaksofon	229	9 – ОАО "Межрегиональный Транзит Телеком"
  autoCallI	240
  semiautoCallI	241
  autoCallII	242
  semiautoCallII	243
  autoCallIII	244
  semiautoCallIII	245
  autoCallIV	246
  semiautoCallIV	247
  ЗАПОЛНИТЬ НА ОСНОВЕ ЕДИНОЙ БАЗЫ НОМЕРОВ		выставление категории на основе единой базы номеров

  
  

• Группа мониторинга (in_list) – название для проверки номеров на принадлежность к группе мониторинга;
• Имя (name) – имя вызывающего абонента;
• Город (city) – название города;
  
• Регион (region) – название региона;
• Оператор (operator) – название оператора связи.

– redirecting number – условия выбора по номеру при переадресации:

• Номер (digits) – маска цифр номера, подробное описание приведено выше;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный:
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• ni – индикатор номера, принимает значения: 
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Группа мониторинга (in_list) – название для проверки номеров на принадлежность к группе мониторинга;
• Имя (name) – имя вызывающего абонента;
• Отсутствует (empty) – отсутствует номер переадресации.

– ocdpn – условие выбора по оригинальному номеру вызываемого абонента:

• Номер (digits) – маска цифр номеров вызывающего (А) и вызываемого (В) абонентов, подробное описание приведено выше;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• Категория (category) – категория вызывающего абонента, может принимать строковое либо цифровое значение согласно таблице 1;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный
• Группа мониторинга (in_list) – название для проверки номеров на принадлежность к группе мониторинга;
• Имя (name) – имя вызывающего абонента;
• Отсутствует (empty) – отсутствует номер переадресации.

– сonnected number – настройка номера абонента при установлении соединения:

• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• Номер (digits) – маска цифр номеров вызывающего (А) и вызываемого (В) абонентов, подробное описание приведено выше;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Группа мониторинга (in_list) – название для проверки номеров на принадлежность к группе мониторинга;
• Имя (name) – имя вызывающего абонента;
• Идентификатор (caller_id) – альтернативное значение номера вызывающего абонента.
• Отсутствует (empty) – отсутствие переадресации номера.

– время (time) – проверка условия времени:

• день недели (weekday) – день недели, задается в виде ДН1,ДН2,...,ДНX, где ДН – номер дня недели (числа от 1 до 7). Может быть указано от 1 до 7 дней недели;

  
  

• время (time) – время суток, задается в виде: ЧЧ:ММ – ЧЧ:ММ, где ЧЧ – часы, ММ – минуты;

  
  

• дата (date) – дата, задается в виде: ДД1.ММ1.ГГГГ1 – ДД2.ММ2.ГГГГ2, где ДД – день, ММ – месяц, ГГГГ – год.

  
  

– Метка (tag) – проверка значения метки для номера:

Действия (Actions)

В разделе "Действия" ("Actions") описывается набор действий, выполняемых при срабатывании правила:

– cgpn – изменения параметров номера вызывающего абонента:

• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• screening – индикатор контроля номера вызывающего абонента:
  • userProvidedNotVerified – предоставлена пользователем, не проверена;
  • userProvidedVerifiedAndPassed – предоставлена пользователем, проверка пройдена;
  • userProvidedVerifiedAndFailed – предоставлена пользователем, проверка не пройдена;
  • networkProvided – предоставлена сетью;

• Номер (digits) – маска модификатора;

  
  

• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Имя (display_name) – имя вызывающего абонента;
• transit_display_name – транзит имени абонента. Если параметр выставляется в значение true, то результирующим дисплей неймом будет тот, который был передан от телефона.
• Идентификатор (caller_id) – альтернативное значение номера вызывающего абонента.

– cdpn – изменение параметров номера вызываемого абонента:

• Номер (digits) – маска модификатора, подробное описание приведено выше;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный;
• inni – индикатор внутрисетевого номера, принимает значения:
  • routingToInternalNumberAllowed – маршрутизация на внутренний номер разрешена;
  • routingToInternalNumberNotAllowed – маршрутизация на внутренний номер не разрешена;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Категория (category) – категория вызывающего абонента, может принимать строковое либо цифровое значение согласно таблице 1;
• Имя (display_name) – имя вызывающего абонента.

– redirecting number – изменение параметров номера при переадресации:

• Имя (display_name) – название для проверки номеров на принадлежность к группе мониторинга;
• Номер (digits) – маска модификатора, подробное описание приведено выше;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• ni – индикатор номера, принимает значения: 
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный:
  
• Очистить (restore) – убрать из сигнализации Redirecting number.

– ocdpn – модификация оригинального номера:

• Имя (display_name) – имя вызывающего абонента;
• Номер (digits) – маска модификатора, подробное описание приведено выше;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• apri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• Категория (category) – категория вызывающего абонента, может принимать строковое либо цифровое значение согласно таблице 1;
• Неполный (incomplete) – признак полного номера, при установленном флаге номер не полный, иначе – номер полный;
• Очистить (restore) – убрать из сигнализации Redirecting number;
• Восстановить (empty) – восстановить исходное значение Redirecting number.

– connected number – настройка номера абонента при установлении соединения:

• Имя (name) – имя вызывающего абонента;
• nai – тип номера, принимает значения: subscriberNumber, unknown, national–Number, internationNumber, spare;
• npi – код плана нумерации, принимает значения: isdnTelephony, dataNumbering–Plan, telexNumberingPlan, reserved1 (код 5), reserved2 (код 6), reserved3 (код 7), spare;
• аpri – индикатор ограничения предоставления номера вызывающего абонента:
  • presentationAllowed – разрешение;
  • presentationRestricted – запрет;
  • addressNotAvailable – недоступность номера;
  • spare – параметр для дальнейшего расширения;
• Номер (digits) – маска модификатора, подробное описание приведено выше;
• ni – индикатор номера, принимает значения:
  • private – частная сеть;
  • local – местная сеть;
  • zone – зоновая сеть;
  • intercity – междугородная сеть;
  • international – международная сеть;
  • emergency – спецслужбы;
• Идентификатор (caller_id) – альтернативное значение номера вызывающего абонента;
  
• transit_display_name – транзит имени абонента. Если параметр выставляется в значение true, то результирующим дисплей неймом будет тот, который был передан от телефона;
• Очистить (restore) – убрать из сигнализации Redirecting number;
• Отсутствует (empty) – отсутствие переадресации номера.

Результат (Result)

В разделе "Результат"("Result") описывается результат отработки правила модификации:

Завершить (Finish) – Модификация завершается, результат модификации присваивается вместо номеров до модификации:

Ошибка (Error) – Модификация завершается, результатом модификации является ошибка, вызов завершается:

• acp cause – ошибка (причина) ACP, которая будет передана;
• код isup – код ошибки (причины) ISUP, который будет передан;
• description: описание ошибки, которая возникла на этапе модификации.

Продолжить (Continue):

• метка – задает метку для удобства модификации в дальнейшем;
• type – задает логику поведения после удачной модификации: 
  
  • start – продолжает проверять правила с начала в контексте;
  • next – продолжает проверять правила со следующего правила.