GetDimElements

Синтаксис

GetDimElementsResult GetDimElements(DmId tDim, GetDimElementsArg tArg)

Параметры

tDim. Моникёр открытого экземпляра справочника.

tArg. Параметры извлечения информации об элементах справочника.

Описание

Операция GetDimElements извлекает информацию об элементах справочника.

Комментарии

Данная операция позволяет получить следующую информацию:

• Значения атрибутов, которые определены для элементов;

• Информация о расположении элемента в общей иерархии;

• Информация об отметке элементов.

Для выполнения операции необходимо в параметре tDim указать моникёр открытого экземпляра справочника и в параметре tArg указать параметры, в соответствии с которыми будут отбираться элементы. Моникёр может быть получен при выполнении операции OpenDim. Если в параметре tArg не задано ни одно поле, то для всех элементов справочника будет получена следующая информация:

• Ключ элемента;

• Наименование элемента;

• Признак наличия дочерних элементов;

• Уровень элемента в общей иерархии.

Задав поля в параметре tArg можно ограничить извлекаемую информацию и список элементов, для которых она будет получена.

Список элементов ограничивается путем определения параметров фильтрации в поле tArg.filter. В список элементов будут попадать только те элементы, которые удовлетворяют установленным условиям фильтрации. Если в поле tArg.filter определены различные виды фильтрации, то используется следующий порядок применения фильтра:

1. Отбор группы элементов;

2. Отбор элементов по ключам;

3. Отбор элементов по значениям атрибутов.

Пример

Различные варианты использования операции приведены в следующих примерах:

См. также:

Работа со справочниками