[ELMA3] Использование системных справочников в модуле

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

Рядовой показатель – это показатель, в котором каждому элементу ряда/справочника присваивается определенное значение.

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

Для того, чтобы объект Справочник мог быть использован как объект Ряд, необходимо добавить в объект Справочник:

1. Свойства Name типа String, StartDate типа DateTime, EndDate типа DateTime.
2. Программный интерфейс EleWise.ELMA.KPI.Models.Dimension.IKPIDimension, EleWise.ELMA.KPI.

Ниже приведен пример настройки иерархического справочника Справочник.

1. Добавление свойства Наименование (Name) типа String. Заполнение полей Тип свойства – Строка, Имя свойства структуры данных – Name. Установка флажков Обязательно для заполнения и Является наименованием.

Рис. 1. Настройка свойства "Наименование"

2. Добавление свойства Дата появление в ряду (StartDate) типа DateTime. Заполнение полей Тип свойства – Дата/Время, Имя свойства структуры данных – StartDate. Установка флажков:

1. Показывать – Дату. Флажок Время может быть установлен или снят. Он отвечает за фиксацию времени появления элемента в ряду. В стандартном интерфейсе время не учитывается.
2. Устанавливать текущую;
3. Обязательно для заполнения.

Рис. 2. Настройка свойства "Дата появления в ряду"

3. Добавления свойства Дата выхода из ряда (EndDate) типа DateTime. Заполнение полей Тип свойства – Дата/Время, Имя свойства структуры данных – EndDate. Установка флажков:

1. Может иметь пустое значение;
2. Показывать – Дату. Флажок Время может быть установлен или снят. Он отвечает за фиксацию времени появления элемента в ряду. В стандартном интерфейсе время не учитывается.

Рис 3. Настройка свойства "Дата выхода из ряда"

4. Подключение программного интерфейса. Для этого необходимо перейти в объект Справочник на вкладку Дополнительно и раскрыть блок Программные настройки.

Рис. 4. Подключение программного интерфейса

В поле Реализуемые интерфейсы нажать на кнопку Добавить интерфейс.

В открывшемся диалоговом окне необходимо ввести полное имя типа интерфейса (EleWise.ELMA.KPI.Models.Dimension.IKPIDimension, EleWise.ELMA.KPI) и нажать на кнопку ОК. Следует отметить, что при вводе полного имени типа интерфейса не следует допускать ввода лишних пробелов, т.к. это может повлиять на работоспособность интерфейса.

Далее требуется публикация объекта Справочник.

Рис. 5. Дизайнер ELMA. Вкладка "Объекты". Кнопка "Опубликовать"

После публикации объекта Справочник сервер должен быть перезапущен.

Рис. 6. Дизайнер ELMA. Вкладка "Публикация"

Опубликованный справочник отобразится в разделе Показатели в дереве Ряды только после нажатия на кнопку Сохранить, или при добавлении показателя или метрики с разложением в ряд.

Рис. 7. Созданный справочник в дереве рядов

В веб-приложении показатель с разложением в ряд Справочник выглядит следующим образом:

Рис. 8. Карточка рядового показателя в веб-приложении

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

Например, в объекте Контрагент необходимо добавить только свойства Дата появления в ряду (StartDate) типа DateTime и Дата выхода из ряда (EndDate) типа DateTime, а также реализуемый интерфейс.

В объекте Сделка все свойства присутствуют, поэтому необходимо добавить только интерфейс.