AVEVA™ Unified Engineering

Notes on Element Rule Syntax

Save PDF

TABLE OF CONTENTS

Notes on Element Rule Syntax

Save PDF

Last UpdatedMay 26, 2023
3 minute read

The syntax for elements and their attributes discussed here applies to the items and expressions in the

Obstruction, Check and Exclude lists on the Clash Manager - Clash Set Data window
Tracking Selection Rules entered at the Gtype/Tracking tab of the Clash Manager Configuration window.

The syntax can be:

<elementName>
OR
<gtype> ::= BRAN\|SUBE\|STRU\|FRMW\|SUBS\|PIPE\|EQUI\|SITE\|REST\|HVAC\|ZONE
OR
<expression> [and <expression>]...
where:
<expression> ::= <expressionStyleA> \| <expressionStyleB>
	where:
	<expresionStyleA>::= <attribute> [OF <gtype>\|<eleName>] [NOT] <op> <value>
	<expresionStyleB>::= <attribute> [NOT] <op> <value> [OF <gtype>\| <eleName>]
		where:
		<attribute> ::= AVEVA E3D Design Element Attribute or UDA
		<op> ::= for example \| ne \| gt \| lt \| = \| != \| <> \| > \| < \| like
		<value> ::= [<quote>] string [<quote>] \| numeric \| <inches> \| <wildcard>
			where:
			<quote> ::= <singleQuote:‘> \| <verticalBar:\|>
			<inches> ::= numeric"
			<wildcard> ::= regular expression

where:

<wildcard> ::= regular expression

Note:
For Regular Expression syntax, refer to Notes on Wildcards.
Strings must be quoted if they would otherwise be confused with a keyword for example a <GTYPE> or <OP> etc
The <discardwildcard>’s are applied after all other expressions, they have the effect of discarding or removing items from the list.

Examples

name of zone like ^/STRU	returns ZONE names beginning "/STRU"
site	returns all SITES
zone	returns all ZONEs
bore of pipe gt 100	returns PIPEs with bore > 100mm
bore gt 100 of pipe	returns PIPEs with bore > 100mm
bore gt 4" of pipe	returns PIPEs with bore > 4 inches
bore gt 100 and :pdmsarea like 15A of pipe	returns PIPEs with bore > 100mm and :PDMSAREA contains 15A
bore gt 100 and :pdmsarea = 15A of pipe and name of site like ^/STRU	returns PIPEs with bore > 100mm and :PDMSAREA equals 15A which are under a SITE whose name begins "/STRU"
name of pipe like 'PIPE'	syntax error if 'PIPE' is not quoted (would otherwise be an unexpected GTYPE)
name of pipe like /PIPE	/PIPE does not need to be quoted, it will not be confused with a GTYPE
name of pipe not like 'PIPE'	returns all pipes whose name does not contain 'PIPE'
!PIPE	removes from the resulting list, any name containing the text 'PIPE'
Note: Name of pipe not like 'PIPE' and !PIPE are very different, the former ADDs to the resulting List, the latter only removes items from the List.
name of bblock like .* and name of blevel like ACC	returns all blevels whose names contain "ACC" below all bblocks
Note: For default Group Level element types (ZONE, PIPE, HVAC, BRAN, EQUI, SUBE, SUBS, FRMW, SBFR, SCTN, REST, HANG), the expression can use this type alone. Other types require sub-expressions which reference each prior level in order to locate the element. In the above example an expression such as "name of blevel like ACC" alone would not provide enough information and would generate an "Incomplete expression" error message.
Note: Any GTYPE used in an expression, unless it is one of the default Group Level element types, should be added to the GTYPE list on the GType/Tracking window (refer to Gtype/Tracking for further information). Examples that would need to be added would include BBLOCK and BBLEVEL.
Note: When using UDETs, do not add the actual type to the GType/Tracking window. Instead add the base type and use the base type in the expression. The actual type may be used as a sub-expression if required, for example: name of equi like '15A' and acttype like :pump.

The List may only contain consistent element types. For example a SITE may not be added to the List if it already contains ZONES. Note however that items below the level defined for Grouping Clashes will be elevated to that Group Level. For example if clashes in a pipe are configured to be grouped at the PIPE level, any expression which would return a BRANch or a component will if fact return a (single) PIPE. The Evaluate option may be used on any of the Obstruction/Exclude or Check lists to display what would be used when the Clash Set is run.

Default units are mm, inches may be used but the inch symbol, a double quote (") MUST be specified. An alphanumeric string ending with a double quote must itself be quoted if it is to be evaluated against a string. For example: :mystringatt = |4"| of pipe.

AVEVA™ Unified Engineering

Notes on Element Rule Syntax

Table of Contents

Notes on Element Rule Syntax

Related Links