Notes on Element Rule Syntax

AVEVA Clash Manager™ 14.3 User Guide

Entry Information : Notes on Element Rule Syntax

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

•

Obstruction, Check and Exclude lists on the AVEVA Clash Manager - Clash Set Data window

•

Tracking Selection Rules entered at the Gtype/Tracking tab of the AVEVA 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™ 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"

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.