Values

A value is a constant, a reference to objects or a calculation. Values are compared using relationships (see Relationships).

Types of Values

Value	Description	Parameters	Child Nodes
Aggregate Value	Calculates a single value by combining others, using functions such as Count, Sum, Average, max, min or geometric union. This value should have a condition to test and zero or more child values. This value is computed by aggregating the values over any objects that are satisfied by the condition. There are a number of different types of aggregate functions. Detailed information on the child values required are provided in a tool-tip within 1Integrate.	Function	Condition Values
Array Element	An indexed element in an array. The first value should be the array. The second value should be the index into the array, always starting from 0.
Built-in Function Value	A value which is computed by applying the specified built-in function to one or more parameters. There are typically one or more child values of this element, to specify the parameters which will be passed to the function. When a function has been selected from the list of all possible built-in functions, a help icon provides a tool tip with information about the parameters required by this function. See Built-in Functions.	Function name	Value 1 Value n (optional)
Class Name	Returns the name of the class of an object. The object is specified by the class label or object label pair.	Class label Object label	None
Conditional Value	This value should have a condition to test and two child values to choose between. If the condition is true, the result is the first child value. If the condition is false, the result is the second child value.	None	Condition Value 1 Value 2
Difference	This value should have two child values (integers or real numbers). The result is obtained by subtracting the second value from the first.	None	Value 1 Value 2
Division	This value should have two child values (integers or real numbers). The result is obtained by dividing the first value by the second.	None	Value 1 Value 2
Dynamic Value	An attribute from an object. An object’s geometry is one of its attributes. You must specify the class of the object and the attribute to read. You may also need to select the name of an object identified in an earlier part of the rule, if it is necessary to distinguish between different objects of the same class.	Class label Object label Attribute name	None
Named Constant	A named constant is a lookup value. Rule authors can specify a key word that equates to a value used when running rules or performing actions. Named constants are listed in a metadata store (see Metadata Stores). When you insert a named constant, you must select a metadata store, a table of named constants within the metadata store, and a key word within the table. If the key word has an associated code value, when the rule or action is run it will use the code value instead of the key word. If there are no code values specified for this metadata table then the key is used, which allows for restricting a value to one from a fixed codelist.
Negative	This value should have one child value (an integer or a real number), containing a sign that will be inverted. For example, -1 becomes +1 and vice-versa.	None	Value
Nested Value	A value nested within a composite value. These are used in two ways: Some custom data stores or built-in functions allow attributes that are structures containing a number of sub-attributes. Some custom built-in functions return objects. A nested value allows you to access attributes of these objects, because they are not accessible via an attribute value as the object is not ‘in scope’.
Null Value	A Null value always evaluates as null. This can be used to verify if an object attribute value or the result of a calculation is null. Note: Searching on a null value is not valid for arrays.	None	None
Object or Element Value	An object or an element from a collection. These are used in two ways: To access a whole object directly, e.g. to compare objects to check whether they are or the same object or not, or to pass an object in to a built-in function or store it as a temporary value. In this case, users specify the class and, if required, the name alias of the object. To access an element when looping through a collection or array. One example is to use a “For All in Collection” or “Loop over a Collection” over a geometry in order to access each part of the geometry. Within the loop, access the element using this Object or Element value, leaving the class name blank but selecting the name specified by the loop.	Class label Object label	None
Product	This value should have two child values (integers or real numbers). The result is obtained by multiplying together all child values.	None	Value 1 Value 2
Remainder	This value should have two child values (integers or real numbers). The result is obtained by dividing the first value by the second, and taking the remainder.	None	Value 1 Value 2
Static Value	A Static Value is fixed, and does not change. This can be used on either side of a comparison condition or as part of a more complicated expression. It can be a boolean, an integer, a real (floating point) or a string (text or timestamp). You must specify both the type of value, and the value itself.	Datatype	None
Sum	This value should have at least two child values (integers or real numbers). The result is the sum of all child values. Alternatively, the values can be string types, in which case they are joined together.	None	Value 1 Value 2 Value n (optional)
Temporary Value	A temporary value is initially null and can be used to hold temporary results during an action. Note: A temporary value can be used in an action but not in a rule. The value can have either local or global scope. If it has local scope, the value will be reset to null before the action is applied to each object. If it has global scope, the value will be reset to null only at the start of the whole task. A temporary value can be any type, but this type is determined by the value it is given.	Scope Value	None