Группы элементов: Справочники

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

Группы элементов могут быть использованы в инструментах продукта «Форсайт. Аналитическая платформа» для отметки элементов измерения, построенного на данном справочнике.

Группа элементов строится из отдельных типов отметки.

Тип отметки - это набор элементов справочника, сформированный по какому-либо общему признаку.

Управление группами элементов осуществляется на странице «Группы элементов» мастера справочника.

Для управления группами элементов выполните шаги:

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

Для добавления новой группы элементов:

Нажмите кнопку «Добавить» в области «Группы». Будет открыто окно «Новая группа элементов»:

Задайте параметры:

Наименование. Введите наименование группы. По умолчанию «Группа элементов справочника»;
Идентификатор. Введите уникальный идентификатор группы. Идентификатор должен содержать только буквы латинского алфавита, цифры, знак «_», не должен содержать пробелов и не должен начинаться с цифры.

Нажмите кнопку «Применить».

После выполнения действий в список групп элементов будет добавлена новая группа.

Для редактирования существующей группы элементов выделите группу элементов в области «Группы». После выполнения действий будет отрыт список типов отметки в соответствии с выбранной группой элементов.

Для добавления типа отметки нажмите кнопку «Добавить» в области «Тип отметки» и в раскрывающемся списке выберите способ отметки:

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

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

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

Описание настройки приведено для всех типов отметки, кроме «Использовать прикладной макрос». Настройка типа отметки «Использовать прикладной макрос» приведена в разделе «Использование прикладного макроса».

Для настройки типа отметки:

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

Элементы из списка:

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

Для настройки отображения элементов справочника нажмите кнопку «Отображение атрибутов» и выберите в раскрывающемся меню атрибуты. В меню содержатся атрибуты, добавленные на странице «Атрибуты» мастера справочника;

Элементы уровней:

Установите флажки напротив наименований необходимых уровней;

Элементы по общему владельцу:

Нажмите кнопку «Применить».

После выполнения действий будет настроен тип отметки.

Если в справочнике содержатся параметры, то для типов отметки «Элементы из списка», «Элементы по общему владельцу» перед открытием окна редактирования будет открыто окно «Установка значений параметров» для формирования списка элементов по заданным значениям параметров.

Содержимое группы элементов формируется на основе результата выполнения макроса, при этом:

макрос должен быть статическим (Shared) методом какого-либо класса;
сигнатура макроса должна иметь вид:

Public Class <наименование класса>: Object
    Public Shared Function <наименование группы> (Dimension: IDimInstance): IDimSelection;
    Var
        GroupSelection: IDimSelection;
    Begin
        GroupSelection := Dimension.CreateSelection;
        //Формирование отметки GroupSelection
        Return GroupSelection;
    End Function <наименование группы>;
End Class <наименование класса>;

Параметры:
Dimension. Открытый экземпляр справочника.

Результат: отметка тех элементов, из которых необходимо сформировать группу.

Для редактирования типа отметки, использующей для отметки группы элементов справочника прикладной макрос, откройте окно «Формировать элементы из макроса».

Для открытия окна «Формировать элементы из макроса» нажмите кнопку «Настройки», расположенную напротив типа отметки «Использовать прикладной макрос»:

В области «Сборка, модуль или форма» отображается список доступных сборок, модулей и форм.

В области «Методы» отображается дерево классов объекта, выбранного в списке репозитория. Для каждого класса выводятся дочерние элементы (методы), если они соответствуют нужной сигнатуре. Если методов нет, то класс не отображается.

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

Для добавления макроса нажмите кнопку «Применить». Кнопка доступна, если:

в списке методов выделен метод;
в списке методов отображается только один метод.

Конечный набор элементов справочника формируется путём объединения или пересечения элементов, входящих в отдельные типы отметки.

После добавления типов отметки выберите способ их взаимодействия в раскрывающемся списке, расположенном в области «Группы» напротив группы элементов:

Объединение. В случае взаимодействия отметок остаются все элементы, которые получаются в результате работы любого из типов отметки (в единственном экземпляре);
Пересечение. В случае взаимодействия типов отметки остаются элементы, которые входят в результат каждого из типов отметки.