Revision history:

Introduced in QPR 7.2.1

Last changed in QPR 2012

 

Returns a variant array of elements of given type sorted by name. Note! In order to avoid memory consumption, remember to empty the variant containing the returned variant array after the array is not needed anymore.

 

Synopsis:

 

SCModel.GetElements(Type, out Elements)

 

Parameters:

 

Type, either typeid or typename

Elements, variant array filled with data of the following types:

SCORECARD

INFORMATIONITEM

PERIOD

PERIODLEVEL

RANGE

SERIES

VALUESETTING

INTEGRATION

UNIT

CHARTTEMPLATE

ALERT

ELEMENT

LINKEDDATA

+ all user-defined element and linked element types

 

The array contains the following columns:

•element name, string

•id, integer

•identifier, string

•scorecard id, integer

•scorecard identifier, string

•Valuesettingid (for series and ranges only), integer

•PeriodLevelid (for periods only), integer

 

 

Required Rights:

 

Administrator or Model Administrator rights to the SCModel.

 

Return Values:

Below are listed the return values that this function can return:

 

RV_SUCCESS

RV_MODEL_NOT_OPEN

RV_INVALID_PARAMETER

RV_TYPE_NOT_FOUND

RV_NO_ELEMENTS_FOUND

RV_NO_RIGHTS

RV_UNKNOWN_ERROR

 

Example Procedure:

 

Sub FetchElements()

 

 Dim iResult

 Dim Elements

 Dim I

 

for I = 0 to 10000

 

   iResult = SCModel.GetElements(2, Elements)

   If iResult <> 0 then

      Elements = Empty

      Exit Sub

   End If

 

   'do something with the Elements table

 

   Elements = Emtpy

next

 

End Sub