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 1Validate.	Function	Condition Values
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
	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
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)