Справочники

Система справочников необходима для настройки биллинга. В справочниках задаются значения, которые могут принимать различные параметры договоров. Для редактирования справочников выберите пункт меню Справочники⇒Другие. В разделе перечислены назначения справочников ядра, дополнительно в списке могут появится справочники установленных плагинов.

Адресный справочник необходим для правки параметров договоров и объектов типа "Адрес". Основная сущность справочника - дом. Страны, города, кварталы, районы и улицы - это обычные перечисления, которые используются в справочнике домов. Города привязаны к странам. Кварталы, районы и улицы привязаны к городам. Дома привязаны к улицам. Адресный справочник доступен в меню Справочники⇒Адреса или при нажатии комбинации клавиш Alt+A.

Для поиска нужного адреса, необходимо сначала выбрать страну, город, улицу/квартал/район и дом. Для поиска каждой из сущностей в параметрах поиска доступно несколько режимов:

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

Для редактирования сущностей, необходимо выбрать ее в таблице и нажать кнопку редактирования на глобальной панели инструментов. Все редакторы схожи, кроме редактора домов. Редактор позволяет отредактировать название сущности и добавить к ней параметры, которые были заведены в конфигурации сервера.

Редактор домов обладает большей функциональностью. В нем можно привязать дом к району, кварталу. Также можно указать индекс дома и кол-во квартир в нем.

Для улицы можно завести специальный параметр boxIndexRange по которому при заведение дома может автоматически вычисляться почтовый индекс. Поиск индекса идет до первого совпадения.

Примеры заполнения параметра boxIndexRange

Пример 1. Все дома на улице с одинаковым индексом

450000:*

Пример 2. Несколько диапазонов с разными индексами

450001:1-10,31-34;450002:11-30;45000:*

Пример 3. Несколько диапазонов с разными индексами, исключение для конкретных номеров домов и дома с индексами.

450023:7,3,5/a,1;450001:1-10,31-;450002:11-30

Для дома можно завести специальные параметры диапазонов, по которым будет автоматически рассчитываться подъезд и этаж указанной квартиры. Это параметры floorRange - для определения этажа по квартире , entranceRange - для определения подъезда по квартире. Они также заводятся в конфигурации сервера.

Примеры заполнения параметров floorRange и entranceRange

Пример 1. Заполнение параметра для простого 9 этажного панельного дома, в котором 3 подъезда, диапазон квартир 1-108, кол-во квартир 4 на этаже и соответственно в одном подъезде 36 квартир.

1-108/36/1,

где первый параметр - диапазон квартир в доме/нескольких подъездах, второй параметр - количество квартир в подъезде, третий параметр - с какого подъезда начинается данный диапазон квартир.

Пример 2. Заполнение параметра для сложного дома.

1-72/36/1;73-132/60/3;133-168/36/4;169-187/19/5

Из примера видно, что в данном доме первые 2 подъезда стандартные по 36 квартир в подъезде, в 3 подъезде 60 квартир, в 4 - опять 36 квартир, а в 5 - 19 квартир. Соответственно ";" разделяются диапазоны квартир в нескольких подъездах.

Пример 1. Заполнение параметра для простого 9 этажного панельного дома, в котором 3 подъезда, диапазон квартир 1-108, кол-во квартир 4 на этаже и соответственно в одном подъезде 36 квартир.

1-108/4/1/9,

где первый параметр - диапазон квартир в доме/нескольких этажах, второй параметр - количество квартир на этаже, третий параметр - с какого этажа начинается данный диапазон квартир, четвертый параметр - на каком этаже заканчивается данный диапазон квартир.

Пример 2. Заполнение параметра для сложного дома.

1-72/4/1/9;73-132/4/1/15;133-168/4/1/9;169-183/3/1/5;184-187/2/6/7.

Из примера видно, что в данном доме первый диапазон стандартный по 4 квартиры на этаже с 1 по 9й этаж (соответствует первым 2 подъездам в доме), второй диапазон 15 этажей и по 4 квартиры на этаже (соответсвует 3 подъезду в доме), третий диапазон 9 этажей по 4 квартиры на этаже (соответствует 4 подъезду в доме), четвертый диапазон с 1 по 5 этажи по 3 квартиры на этаже, пятый диапазон с 6 по 7й этаж по 2 квартиры на этаже. Четвертый и пятый диапазоны соответствуют 5 подъезду в доме. Соответственно, ";" разрделяется диапазон квартир на нескольких этажах.

На квладке Новые адреса выводятся адреса, заведенные через интерфейс "Пользовательское значение адреса" в редакторе адресного параметра договора.

В левой части интерфейса отображаются адресные параметры договора и параметры объектов. В правой части новые адреса в таблице. При двойном клике открывается редактор адресного параметра договора, в нем можно повторно попробовать найти данный адрес. Если он не находится, то необходимо данный адрес завести в справочник адресов. Для этого необходимо переключиться на вкладку Адреса. После заведеня нового адреса в справочник, необходимо переключиться обратно на вкладку Новые адреса и открыть редактор адресного параметра договора, после чего произвести поиск нового адреса и заполнить адресный параметр договора.

В дополнение к стандартному набору параметров договор может иметь набор пользовательских атрибутов. Для этого их надо перечислить и указать их тип.

Существуют следующие типы параметров договоров:

Также существует возможность включить ведение истории параметров договоров каждого договора. Для того, чтобы включить ведение истории нужного параметра, двойным щелчком откройте редактор параметра и установите галочку в поле "История". Нажмите ОК.

О просмотре истории параметра подробнее см. здесь.

Иногда для разных групп договоров существуют параметры, которые не совпадают друг с другом. Так, для договора на частное лицо параметр "Юр. адрес" не имеет смысла. Чтобы при редактировании договора отображались только нужные параметры, следует создать группу параметров и в привязке параметров указать необходимый набор атрибутов.

Группа параметров привязывается к договору, определяя какими параметрами он обладает.

Ниже изображен справочник групп параметров - это простой перечень, где редактирование осуществляется кнопками панели инструментов.

При добавлении новой группы или редактировании существующей открывается панель привязки параметров, которая определяет какие параметры есть у договоров группы.

Группы необходимы для логического объединения договоров одного типа, поиска. Например: "Телефония", "Интернет" и т.п.. У одного договора может быть установлено сразу несколько групп, они сохраняются битовой маской.

Для того, чтобы убрать группу у всех договоров, необходимо в справочнике групп выбрать группу, нажать правой кнопкой мыши и в появившемся меню активировать пункт Удалить у всех договоров. Признак Группа используется определяет видимость группы в редакторе в договоре и во всех фильтрах поиска.Признак Редактируемый элемент означает то, что помеченные группы вручную можно устанавливать/убирать в договоре.

Зачастую приходится вводить однотипные комментарии в имени договора, которые совпадают с какими-либо его параметрами (Ф.И.О., электронный адрес и прочее). Для автоматизации этого процесса можно использовать шаблоны комментариев. Для редактирования справочника шаблонов комментариев выберите пункт меню Справочники→Другие и затем Шаблоны комментариев в панели слева.

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

В шаблоне указывается Название шаблона, а также сам Шаблон. Шаблон - это произвольная строка, в которой возможна подстановка значений из параметров договора, путём включения макросов ${ param_<pid> }, где <pid> - код параметра договора. Например: ${ param_4 } - подстановка значения параметра договора с кодом 4. При изменении параметров договора комментарий автоматически изменяется с учётом новых значений параметров.

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

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

В верхнем списке выбирается требуемый списковый параметр, по двойному клику мыши либо открывается перечень значений. Редактирование перечня осуществляется нижней панелью инструментов.

На вкладке Пользовательские значения списков можно добавить новое значение справочника и/или заменить пользовательское значения списка на существующее значение.

Добавить - добавится новое значение в справочник и пользовательское значение в договоре заменится на добавленное.

Удалить - значение удалится из договора.

Заменить - пользовательское значение заменится на значение из справочника.

Аналогично c Значения мультисписков и Пользовательские значения мультисписков

Здесь указывается перечень обслуживающих лиц. В дальнейшем эти лица могут быть привязаны в параметрах конкретного договора как обслуживающие какие-то адреса клиентов. Использование данного параметра нежелательно в связи с появлением в биллинге системы объектов, позволяющей выделять отдельные точки клиента в объекты с указанием в параметрах адреса объекта, обслуживающих лиц и пр.

Перечень скриптов поведения, которые могут быть назначены договору.

Скрипт поведения определяет реакцию на определённые события относящиеся к договору, более подробно о скриптах BGBS описано здесь.

Типы платежей необходимы для разделения потока платежей клиентов по видам. Далее по ним может быть построена аналитика. Примеры типов платежей: "Наличный", "Через банк", "Дилер Х", "Платёж за подключение" и т.п..

Для добавления нового типа, либо подгруппы нужно выбрать группу для добавления (группа Все группы существует изначально) и нажать Новый элемент на панели инструментов.

В справочник можно добавить как группу платежей (см. снимок выше) так и непосредственно платёж, выбирая галочку Группа, либо Элемент группы. Группы типов платежей предназначены исключительно для визуально более лёгкого восприятия перечня типов платежей в справочнике. Нигде больше они в данный момент не используются.

После добавления платёж, либо группу можно перемещать между группами-предками. Для этого выберите узел, нажмите правой кнопкой мыши, в появившемся меню выберите Вырезать, далее выберите новую группу для переносимого узла вызовите меню правой кнопкой мыши и выберите Вставить.

Параметр Нередактируемый элемент показывает, что данный тип платежа нельзя заносить и редактировать через редактор платежей в договоре. Платежи такого типа используются, например, для платежных систем, автоматической загрузки платежей из реестра и т.п. Нередактируемые платежи заносятся системой без непосредственного участия человека, это мера защиты от правки такого платежа оператором, например, при активации интернет-карточки. Для правки такого платежа пользователь, обладающий правами изменять справочники, должен снять признак нередактируемости с типа платежа, скорректировать платёж в договоре и вернуть признак.

Следует обратить внимание на столбец ID - это код типа платежа. Во всех конфигурациях, где необходимо указание типа платежа, указывается именно этот код.

Расход - это единоразовое снятие с баланса договора некоторой суммы. Так же как и платёж расходы разделяются по типам, отображающим их назначение. Например: "Переподключение", "Вызов мастера" и т.п. Расходы также бывают редактируемые и нередактируемые. Для занесения расхода в договор биллинга в справочнике должен быть заведён хотя бы один редактируемый тип расхода. Создайте его сразу.

Редактирование справочника аналогично справочнику типов платежей.

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

При открытии типа времени для редактирования открывается редактор с одним или несколькими периодами, бесконечный период выглядит как просто тире. Периоды позволяют внутри одного типа времени задавать разные маски для разных интервалов дней. Например, можно вести учет выходных и праздничных дней на несколько лет. При открытии редактирования периода отображается редактор следующего вида:

В верхней области необходимо определить, собственно, период действия. В приведенном примере начато определение выходных и праздников на 2009 год.

Далее задаются несколько правил. Каждое правило устанавливает маски на часы, дни недели, дни месяца, месяцы. Месяцы могут принимать значения от 1 до 12, часы от 0 до 23, дни недели от 1 до 7, месяцы от 1 до 12. Маски в пределах правила соединяются условием "И". Т.е., например, часы от 0 до 8 И дни недели 6-7. Правила внутри типа времени соединяются условием ИЛИ. Совпадение хотя бы с одним правилом времени даёт основание отнести его к данному типу.

Несколько особенностей поведения типов времени: