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

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

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

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

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

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

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

Управление группами элементов осуществляется в окне «Группы элементов» и доступно из навигатора объектов и инструментов продукта «Форсайт. Аналитическая платформа»: «Аналитические панели», «Аналитические запросы (OLAP)», «Отчеты».

Для открытия диалогового окна «Группы элементов» из навигатора объектов выполните команду «Группы элементов» в контекстном меню необходимого справочника.

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

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

кнопки «Отметить группу», расположенной на вкладке «Отметка» ленты инструментов;
«Расширенная отметка > Отметить группу» в контекстном меню элемента измерения в боковой панели;
«Расширенная отметка > Отметить группу» меню измерения в боковой панели;
кнопки «Группа элементов», расположенной в группе «Вид» вкладки «Иерархия» ленты инструментов;
«Группа элементов» в контекстном меню элемента измерения в боковой панели;
«Группа элементов» в меню измерения в боковой панели.

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

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

Для добавления примитива в выбранной группе нажмите кнопку «Добавить» и выберите примитив:

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

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

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

Будет открыто диалоговое окно «Настройка примитива», содержание которого зависит от вида примитива:

Элементы из списка. В окне «Настройка примитива» отображаются все элементы справочника, например:

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

Элементы уровней. В окне «Настройка примитива» отображаются уровни справочника, например:

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

Элементы по общему владельцу. В окне «Настройка примитива» отображаются все элементы справочника, например:

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

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

После добавления примитивов выберите тип их взаимодействия в раскрывающемся списке, расположенном выше списка примитивов:

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

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

Для сохранения выбранной группы элементов нажмите кнопку «Сохранить как», расположенную на одном уровне с полем «Группа элементов».

В открывшемся окне задайте наименование и идентификатор схемы отметки.

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

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

макрос должен быть статическим (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. Открытый экземпляр справочника.

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

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

В диалоге отображается список доступных сборок, форм и модулей Fore и Fore.NET. В области «Методы» отображается дерево классов объекта, выбранного в списке репозитория.

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

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

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

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