GetDimElementsResult GetDimElements(DmId tDim, GetDimElementsArg tArg)
tDim. Opened dictionary instance moniker.
tArg. Parameters for extracting information about dictionary elements.
The GetDimElements operation extracts information about dictionary elements.
This operation enables the user to get the following information:
Values of the attributes determined for elements.
Information about location of the element in the general hierarchy.
Information about selection of elements.
To execute the operation, in the tDim parameter specify the opened dictionary instance moniker, and in the tArg parameter specify parameters to be used to select elements. The moniker can be obtained on executing the OpenDim operation. If no field is defined in the tArg parameter, the following information is obtained for all dictionary elements:
Element key.
Element name.
Availability of child elements.
Element level in the general hierarchy.
After defining the fields in the tArg parameter, the user can limit the extracted information and the list of elements for which it is to be obtained.
The list of elements is restricted by defining filtering parameters in the tArg.filter field. The list of elements will include only the elements that satisfy selected filtering criteria. If different filtering types are determined in the tArg.filter field, the filters are applied in the following order:
Selection of group of elements.
Selection of elements by keys.
Selection of elements by attribute values.
Various methods of using this operation are given in the following examples:
| Example name |
See also: