Jump to: navigation, search

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


 
(2 intermediate revisions by the same user not shown)
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 =
 
{{ActivityInfoBox
 
{{ActivityInfoBox
 
| title = Get Objects By Property Value
 
| title = Get Objects By Property Value
Line 60: Line 62:
 
|}
 
|}
  
{{Activity/End}}
+
<!-- DO NOT REMOVE THIS -->{{Activity/End}}<!-- DO NOT REMOVE THIS -->
  
 
==See also==
 
==See also==
Line 66: Line 68:
 
* [[Activity:GetObjectsByQuery (Activity)]]
 
* [[Activity:GetObjectsByQuery (Activity)]]
  
[[Category:Activities]]
+
[[Category:Activities|GetObjectsByPropertyValue (Activity)]]

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