Jump to: navigation, search

Difference between revisions of "Activity:GetObjectsByPropertyValue (Activity)"


 
Line 1: Line 1:
 
The GetObjectsByPropertyValue queries object [[Instance|instances]] by comparing a named property to a given value.
 
The GetObjectsByPropertyValue queries object [[Instance|instances]] by comparing a named property to a given value.
 +
 
= Description =
 
= Description =
 
{{ActivityInfoBox
 
{{ActivityInfoBox
Line 61: Line 62:
 
|}
 
|}
  
{{Activity/End}}
+
<!-- DO NOT REMOVE THIS -->{{Activity/End}}<!-- DO NOT REMOVE THIS -->
  
 
==See also==
 
==See also==

Latest revision as of 09:44, 4 November 2015

The GetObjectsByPropertyValue queries object instances by comparing a named property to a given value.

[edit]

Description

Get Objects By Property Value
Name GetObjectsByPropertyValue
Purpose Query obejcts by a property value
Category Object Primitives
Returns The result of the query
Version 2.1.15+

Arguments

Argument Type Direction Purpose
MetaClass MetaClass In The MetaClass to query
PropertyName String In The MetaProperty to use for comparison
Operator QuerySearchItemOperator In The compare method, valid operators are:
  • QuerySearchItemOperator.Equals
  • QuerySearchItemOperator.NotEqual
  • QuerySearchItemOperator.GreaterThan
  • QuerySearchItemOperator.GreaterAndEqualThan
  • QuerySearchItemOperator.LowerThan
  • QuerySearchItemOperator.LowerAndEqualThan
PropertyValue Object In The value to compare against
Index Integer In The index if an indexed value is to be compared; set to -1 for regular value
FirstMatch BaseClass Out The first object the query returned
Result List<BaseClass> Out The result of the query

Usage

This activity is used to find UBIK® instances during the execution of a workflow, by comparing a named property to a given value. Technically this activity creates a query for a single property on the fly and executes it.

Example

Load the MetaClass named PUMP and find all instances which have a POWER greater than 4 kilowatts:

Argument Value
MetaClass
UBIKObject.Environment _
.GetSystemMetaClass(SystemObjects.METACLASS) _
.AllInstances("PUMP")
PropertyName
"POWER"
Operator
QuerySearchItemOperator.GreaterThan
PropertyValue
4
Index
-1


See also