Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

AVEVA™ Engineering

COLLECTION Object

  • Last UpdatedMar 24, 2023
  • 2 minute read

The collection object is used to extract database elements from the system using a selection filter (an expression object), restrictive search elements and scope lists.

Methods

Name

Result

Purpose

Collection()

Constructor (initializes all the object settings).

Scope (COLLECTION)

Empties the current scope list and makes the passed Collection the current scope.

Scope (DBREF)

Empties the current scope list and makes the passed DBREF the current scope.

AddScope

Adds the passed DBREF to the current scope list.

Scope (DBREF ARRAY)

Replaces the current scope list with the passed list of DBREFs.

AppendScope (DBREF ARRAY)

Appends the passed list of DBREFs to the scope list.

ClearScope()

Empties the current scope list.

Filter (EXPRESSION)

Sets the filter to be applied to the collection.

ClearFilter ()

Empties the filter to be applied to the collection.

Type (STRING)

Empties the current scope type list and adds the passed element type.

AddType(STRING)

Adds the passed element type to the scope type list.

ClearTypes()

Empties the types to be applied to the collection.

Types (ARRAY elements)

Replaces the scope element type list with the passed list, elements.

AppendTypes (ARRAY types)

Appends the passed list, types, to the scope type list.

Initialise()

Initializes an evaluate list, so all query actions re-evaluate the collection rules.

Sets index position to 1.

Filter()

EXPRESSION

Returns the expression used to filter database elements.

Scope()

DBREF ARRAY

Returns the list of database elements to scan.

Types()

STRING ARRAY

Returns the list of database element types to be collected.

Results()

DBREF ARRAY

Returns the whole collection.

Next(REAL n)

DBREF ARRAY

Returns sub array from collection of n elements starting at current index position.

Index()

REAL

Returns the current index of the count being used by Next().

Size ()

REAL

Returns the number of elements in the collection.

Note:
Users can set the scope on a collection object to the whole MDB by not setting a scope or by using the 'ClearScope( )' method.

Related Links
TitleResults for “How to create a CRG?”Also Available in