From aef7da370a89c55016377bb10001786f5c108565 Mon Sep 17 00:00:00 2001 From: aorzelskiGH Date: Fri, 17 Apr 2026 17:25:34 +0200 Subject: [PATCH] docs(index): align cross-spec versions with IDTA-01001/01002 v3.2 Update the "Metamodel Versions" section and the corresponding bibliography entries to reference the current versions of the companion specifications: - IDTA-01001 Part 1: Metamodel v3.1 -> v3.2 - IDTA-01002 Part 2: APIs v3.1 -> v3.2 In addition, add an explicit "Alignment with other AAS Specifications" table that states which Metamodel and API versions this Security version (v3.1) is designed to be used with, and clarifies the substitution rule for bugfix releases. Refs: Review Finding T-08 Made-with: Cursor --- .../modules/ROOT/pages/bibliography.adoc | 8 +++---- .../IDTA-01004/modules/ROOT/pages/index.adoc | 24 +++++++++++++++++-- 2 files changed, 26 insertions(+), 6 deletions(-) diff --git a/documentation/IDTA-01004/modules/ROOT/pages/bibliography.adoc b/documentation/IDTA-01004/modules/ROOT/pages/bibliography.adoc index e70bb18..5e4f5f5 100644 --- a/documentation/IDTA-01004/modules/ROOT/pages/bibliography.adoc +++ b/documentation/IDTA-01004/modules/ROOT/pages/bibliography.adoc @@ -13,13 +13,13 @@ SPDX-License-Identifier: CC-BY-4.0 [#bib1] [1] IDTA 01001 Specification of the Asset Administration Shell. -Part 1: Metamodel, Version 3.1. Industrial Digital Twin Association (IDTA), January 2025. Online. -Available: https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/index.html +Part 1: Metamodel, Version 3.2. Industrial Digital Twin Association (IDTA). Online. +Available: https://industrialdigitaltwin.org/en/content-hub/aasspecifications [#bib2] [2] IDTA 01002 Specification of the Asset Administration Shell. -Part 2: Application Programming Interfaces, Version 3.1. Industrial Digital Twin Association (IDTA), January 2025. Online. -Available: https://industrialdigitaltwin.io/aas-specifications/IDTA-01002/v3.1/index.html +Part 2: Application Programming Interfaces, Version 3.2. Industrial Digital Twin Association (IDTA). Online. +Available: https://industrialdigitaltwin.org/en/content-hub/aasspecifications [#bib3] [3] IDTA 01003-a Specification of the Asset Administration Shell. diff --git a/documentation/IDTA-01004/modules/ROOT/pages/index.adoc b/documentation/IDTA-01004/modules/ROOT/pages/index.adoc index bb23ae6..c06ff19 100644 --- a/documentation/IDTA-01004/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01004/modules/ROOT/pages/index.adoc @@ -27,12 +27,32 @@ Previous version: 3.0. This document uses the following parts and versions of the “Specification of the Asset Administration Shell” series: -* IDTA-01001 Part 1: Metamodel in version 3.1 xref:bibliography.adoc#bib1[[1\]] -* IDTA-01002 Part 2: Application Programming Interfaces in version 3.1 xref:bibliography.adoc#bib2[[2\]] +* IDTA-01001 Part 1: Metamodel in version 3.2 xref:bibliography.adoc#bib1[[1\]] +* IDTA-01002 Part 2: Application Programming Interfaces in version 3.2 xref:bibliography.adoc#bib2[[2\]] * IDTA-01003-a Part 3a: Data Specification – IEC 61360 in version 3.1 xref:bibliography.adoc#bib3[[3\]] If there are bugfixes of the parts, these shall be used. +[#cross-spec-alignment] +=== Alignment with other AAS Specifications + +This version of IDTA-01004 (v3.1) is designed to be used together with the following companion specifications: + +[cols="2,2,3",options="header"] +|=== +| Specification | Aligned Version | Notes + +| IDTA-01001 Part 1: Metamodel +| v3.2 +| Defines the classes referenced by FieldIdentifier prefixes (`$aas`, `$sm`, `$sme`, `$cd`, `$aasdesc`, `$smdesc`). + +| IDTA-01002 Part 2: Application Programming Interfaces +| v3.2 +| HTTP/REST API and AAS Query Language. IDTA-01002 and IDTA-01004 share the same BNF grammar and JSON Schema for formula expressions; the Query Language chapter in IDTA-01002 is normative for formula semantics. +|=== + +Bugfix (patch) releases of aligned specifications MAY be substituted. Implementations conforming to this version of IDTA-01004 SHOULD declare which versions of IDTA-01001 and IDTA-01002 they implement. + == Notice Copyright: Industrial Digital Twin Association e.V. (IDTA)