From ca685fd370bc70d8cc7122da189eb7dd6f01b38c Mon Sep 17 00:00:00 2001 From: aorzelskiGH Date: Fri, 17 Apr 2026 17:22:22 +0200 Subject: [PATCH] docs(query-language): reference cross-spec terminology matrix Add a NOTE next to the FieldIdentifier root-element table that explicitly maps each $-prefix to the corresponding Metamodel class (IDTA-01001) and API resource path. References the new normative terminology matrix in IDTA-01001 as the single source of truth and states that prefixes are lower-case only. Refs: Review Finding T-09 Made-with: Cursor --- .../IDTA-01002-3/modules/ROOT/pages/query-language.adoc | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/query-language.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/query-language.adoc index 59ceef1e..14033494 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/query-language.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/query-language.adoc @@ -107,6 +107,11 @@ Can start at any possible Submodel Element, is *not* restricted to Submodel Elem | `$smdesc` a| Starting point for fields available in Submodel Descriptors | `$smdesc#endpoints[0].protocolinformation.href` |=== +[NOTE] +==== +The prefixes `$aas`, `$sm`, `$sme`, `$cd`, `$aasdesc` and `$smdesc` correspond directly to the AAS Metamodel classes `AssetAdministrationShell`, `Submodel`, `SubmodelElement`, `ConceptDescription`, `AssetAdministrationShellDescriptor` and `SubmodelDescriptor`, and to the API resources `/shells`, `/submodels`, `.../submodel-elements/{idShortPath}`, `/concept-descriptions`, `/shell-descriptors` and `/submodel-descriptors` respectively. The normative cross-specification mapping is given in the "Terminology Across IDTA-01001, IDTA-01002 and IDTA-01004" section of IDTA-01001 (AAS Metamodel). All prefixes are lower-case; variants such as `$aasDesc` or `$SmDesc` MUST be rejected by conforming parsers. +==== + Attribute declarations point to literal values that provide the input for comparisons. It is not possible to point to objects or lists, only atomic values. Attribute declarations present a subset of the attributes defined by the AAS Metamodel and the extension classes of Clause xref:specification/interfaces-payload.adoc[Data Types for Payload]. .Attribute Elements for Field Identifiers. `` is an optional nonNegativeInteger value. No `` shall be interpreted as 'anywhere in the list'.