Skip to main content

Attribute node

Reference an item's attribute value

The Attribute node references the value of a specific attribute for each queried item, which can be on:

  • the design/interface being queried

  • a linked design/interface reached via one or more Link attributes,
    e.g. the Teams design → its Members attribute → the Team Members design

It's similar to a Value from item attribute node but has a narrower scope.

See comparison
Attribute NodeValue From Item Attribute Node
What items can be accessed?Each item fetched by the queryAny items from a specific design/interface
Can you access specific items?NoYes
Can you access items outside the query's results?NoYes
Does the value change per queried item?Yes - it's a live referenceNo - it's a fixed value

Usage

This node is an input, so you can add it to the segments of:

An Equals node with two empty segments

Compatibility

This node fills one segment. A second segment must hold a matching value type, but not a Property node.

NodeAccepted Value TypeNotes
Another AttributeSame typeCompare two attributes of the same type, on the same item. Not possible for Link or Geometry attributes
CountNumber
Yes/NoYes/No
NumberNumber
Date / Date Time / Seasonal / TimeDate, Date Time, Seasonal, TimeSeasonal ignores the year, Time ignores the date
Relative Date / Relative Date TimeDate, Date TimeDerived each time the query runs
TextText
GeoJSONGeometry
ItemItem IdOnly Link attributes are compatible
Value From Item AttributeSame typeFrom one or more items of any design/interface
LengthNumber
Arithmetic nodesNumber

Options

Select the node to access its options:

  • Open in Pathfinder - use the Pathfinder to change the selected attribute. You can perform one or more "hops" to visit a linked design/interface, then choose one there.

  • Delete - remove the node from the segment.

Example

Fetch all defects that are awaiting inspection.

In AQS terms:

Fetch items of the Defects interface where their Status attribute equals Awaiting Inspection.

To build this step-by-step, see Example 1 - Check an attribute.

An Equals node comparing the Status attribute to Awaiting Inspection
See JSON code

This code may reference designs, interfaces, attributes or items that don't exist in your company project.

{
"type": "Query",
"properties": {
"collectionCode": "Live",
"dodiCode": "designInterfaces_defects"
},
"children": [
{
"type": "Equals",
"children": [
{
"type": "Attribute",
"properties": {
"attributeCode": "attributes_defectsStatus"
}
},
{
"type": "AlloyId",
"properties": {
"value": ["5c8bdfb58ae862230019dc1f"]
}
}
]
}
]
}