Clause (TQL)

A TQL query statement consists of a command, either Select or Update, and a list of clauses. The clauses provide further specification of the query statement, or a refinement, spatially or property wise.

A clause consists of a clause parameter and a clause value, where currently the only supported operator between the parameter and value is IS.

Spatial

These parameters can be used to limit the search polygon that is used to query Buildings.

Param	Value	Description	Limits search polygon
AREA	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Area with ID	true
AREA_WITH_ATTRIBUTE	Attribute	Area with non zero Attribute value	true
BUFFER	decimal	Buffer the limiting search Polygon with this value.	true
GRIDVALUE	decimal	Only include Grid Overlay cells that have a value equal to the one specified	true
LAYERTYPE	Layer, X, Y, XA, YA	Only include Buildings and Terrains that are part of this Layer	true
MAP	Map Type, X, Y, XA, YA	Only Items present in this Map Type	true
MAXGRIDVALUE	decimal	Only include Grid Overlay cells that have a value smaller than the one specified	true
MINGRIDVALUE	decimal	Only include Grid Overlay cells that have a value larger than or equal to the one specified	true
NEIGHBORHOOD	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Neighborhood with ID	true
NEIGHBORHOOD_WITH_ATTRIBUTE	Attribute	Neighborhood with non zero Attribute value	true
STAKEHOLDER	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Stakeholder with ID. Only include Plots that are owned by the stakeholder with this ID. Only include Items that are related to this stakeholder.	true
STAKEHOLDERTYPE	Stakeholder Type	Stakeholder Type with this value. Only include Plots that are owned by this type of Stakeholder.	true
TERRAIN	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Terrain of Terrain Type with ID	true
TERRAIN_WITH_ATTRIBUTE	Attribute	Terrain is of Terrain Type with non zero Attribute value	true
ZONE	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Zone with ID	true
ZONE_WITH_ATTRIBUTE	Attribute	Zone with non zero Attribute value	true

Attribute

These parameters are related to Attributes.

Param	Value	Description	Limits search polygon
ATTRIBUTE	Attribute	The Attribute used for Buildings to obtain a value.	false
ATTRIBUTE_MIN	decimal	Only include Buildings that have an Attribute value larger than or equal to this value.	false
ATTRIBUTE_MAX	decimal	Only include Buildings that have an Attribute value smaller than this value.	false
ATTRIBUTE_MULT	Attribute	Multiply the calculated value with the value of this Attribute for a Building	false
INDEX	positive integer, X, Y, XA, YA	Allows to specify which value in an Attribute' s value array to select.	false

Grid

These parameters are specifically related to grids.

Param	Value	Description	Limits search polygon
GRID	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Grid of Grid Overlay with ID	false
GRID_WITH_ATTRIBUTE	Attribute	Grid of Grid Overlay with non zero Attribute value	false
GRIDTYPE	Grid Type, X, Y, XA, YA	Grid of Grid Overlay with specified type	true
RESULTTYPE	Result type, X, Y, XA, YA	Grid of Grid Overlay with specified Result type	true
GRIDVALUE	decimal	Only include Grid Overlay cells that have a value equal to the one specified	true
MINGRIDVALUE	decimal	Only include Grid Overlay cells that have a value larger than or equal to the one specified	true
MAXGRIDVALUE	decimal	Only include Grid Overlay cells that have a value smaller than the one specified	true
TIMEFRAME	timeframe, X, Y, XA, YA	Specifies which Timeframe to select when processing a particular Grid	false

Item

These parameters filter for specific types of Items.

Param	Value	Description	Limits search polygon
ADDRESS	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Address with ID	false
AREA	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Area with ID	true
BUILDING	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Building with ID	false
BUILDING_WITH_ATTRIBUTE	Attribute	Building with non zero Attribute value	false
FUNCTION	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Function with ID	false
GLOBAL	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Global with ID	false
GRID	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Grid of Grid Overlay with ID	false
INDICATOR	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Indicator with ID	false
LEVEE	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Levee with ID	false
MEASURE	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Measure with ID
NEIGHBORHOOD	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Neighborhood with ID	true
OVERLAY	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Overlay with ID	false
PANEL	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Panel with ID	false
RELATION	Relation	Changes the context of a selected Item to another related Item.	false
STAKEHOLDER	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Stakeholder with ID. Only include Plots that are owned by the stakeholder with this ID. Only include Items that are related to this stakeholder.	true
TERRAIN	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Terrain of Terrain Type with ID	true
ZONE	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Zone with ID	true

Net

These parameter are specific to Network related Items. Some can also be used to limit the selected Buildings.

Param	Value	Description	Limits search polygon
NET_LINE	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Net Line with ID	false
NET_TYPE	Net type, X, Y, XA, YA	Only Net Items of this Net Type	false
NET_FUNCTION	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Net Function with ID	false
NET_LOAD	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Net Load with ID	false
NET_CLUSTER	Integer (Item ID), ID, X, Y, XC, YC, XA, YA, XK or YK	Net Cluster with ID	true

Property

These parameters primarily filter Building properties, though some apply to other items like Stakeholders.

Param	Value	Description	Limits search polygon
CATEGORY	Category, X, Y, XA, YA	Category with this value. Buildings of this Category.	false
CATEGORYMULT	Category Value	Multiply the calculated value with this Category Value of a Building	false
CRS	positive integer	CRS EPSG number of requested coordinate system	false
FUNCTIONMULT	Function Value	Multiply the calculated value with this Function Value of a Building	false
ITERATION	positive integer	Query only executes when the current Iteration matches this value	false
KEY	String	Select Attribute based on Overlay Key value	false
LAYERTYPE	Layer, X, Y, XA, YA	Only include Buildings and Terrains that are part of this Layer	true
MAP	Map Type, X, Y, XA, YA	Only Items present in this Map Type	true
NAME	String	Select Attribute or Global with specified name	false
RESIDENCE	boolean	When true, consider only Buildings that are Residences	false
ROAD_SYSTEM	boolean	When true, consider only Buildings that are part of the road system	false
STAKEHOLDERTYPE	Stakeholder Type	Stakeholder Type with this value. Only include Plots that are owned by this type of Stakeholder.	true
STATE	Timestate	Only include Buildings and Measures that are in this Timestate	false
TERM	Client Word, Server Word	Client Word or Server Word with name.	false