YA (TQL)

From Tygron Support wiki
Jump to navigation Jump to search

The 'YA' clause value is a variation on the 'Y' clause value. The characters 'YA' should be followed by an underscore and the name of an Attribute; for example YA_MONUMENTAL. Also see the example below.

The result of using 'XA' for the clause value, is the automatic creation of multiple TQL statements, one with each Item ID for that Clause Parameter that can be found in the project data. Items are only taken into account of they have a non zero value for the specified attribute.

Internally, the resulting TQL statements are placed in an array of arrays; Similarly the result will be an array of TQL result arrays.

Example

Consider the following (simplified) Building data of a project:

[ 
 { "id" : 0, "name" : "Lindelaan 3", "attributes": { "MONUMENTAL" : [0.0], "MEASURED_M2" : [200.0] } },
 { "id" : 1, "name" : "Kerklaan 40", "attributes": { "MONUMENTAL" : [1.0] } }, 
 { "id" : 2, "name" : "Achterweg 7", "attributes": { "MONUMENTAL" : [-3.5] } }, 
 { "id" : 3, "name" : "Achterweg 9", "attributes": { },
 { "id" : 4, "name" : "Kerklaan 61", "attributes": { "MONUMENTAL" : [2.0]} 
 { "id" : 5, "name" : "Duiker 1235", "attributes": { "CULVERT_DIAMETER" : [1.0]},
]

The TQL statement to obtain the names of the monumental Buildings is:

SELECT_NAME_WHERE_BUILDING_IS_YA_MONUMENTAL

which internally is replaced with a list of TQL statements, separated by a comma:

SELECT_NAME_WHERE_BUILDING_IS_1, SELECT_NAME_WHERE_BUILDING_IS_2, SELECT_NAME_WHERE_BUILDING_IS_4

Its result will be a list of arrays with names, separated by a comma:

["Kerklaan 40"], ["Achterweg 7"], ["Kerklaan 61"]

Similarly, the TQL statement to obtain the culvert Diameters of the Culverts used by the water Overlay is:

SELECT_ATTRIBUTE_WHERE_BUILDING_IS_YA_MONUMENTAL_AND_NAME_IS_MONUMENTAL

Its result will be a list of arrays of values, separated by a comma:

[1.0], [-3.5], [2.0]

Clause Parameters

The YA value can be used in the following TQL Clause parameters: