admin-shell-io · BirgitBoss · Oct 23, 2025 · Oct 23, 2025 · Oct 23, 2025 · Oct 23, 2025
diff --git a/README.md b/README.md
@@ -64,12 +64,14 @@ The following release contains the latest version of the AAS schemas
  (see also the [releases](https://github.com/admin-shell-io/aas-specs-metamodel/releases) 
 section of this repository):
 
-* [3.1.1](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.1)
-is the latest release for the `V3.1.1` version of the AAS metamodel, 
+* IN PROGRESS [3.2](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.2)
+is the latest release for the `V3.2` version of the AAS metamodel, 
 containing the normative specification as well as the schemas in xml, JSON and rdf
 *Use this release if you want to work with the latest specified AAS version.*
 
 Previous releases:
+* [3.1.2](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.2) is the release for the  `V3.1.2` bugfix version of the AAS metamodel as published in October 2025
+* [3.1.1](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.1) is the release for the  `V3.1.1` bugfix version of the AAS metamodel as published in August 2025
 * [3.1.0](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.0) is the release for the  `V3.1` version of the AAS metamodel as published in May 2025
 * [3.0.8](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/V3.0.8) minor schema bugfixes for `V3.0` version of the AAS metamodel
 * [3.0.7](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/V3.0.7) minor schema bugfixes for `V3.0` version of the AAS metamodel

diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml
@@ -1,8 +1,6 @@
 name: IDTA-01001
 title: 'Part 1: Metamodel'
-version: 'v3.2'
-display_version: 'in progress'
-prerelease: true
+version: 'v3.1.2'
 start_page: ROOT:index.adoc
 nav:
   - modules/ROOT/nav.adoc
diff --git a/documentation/IDTA-01001/modules/ROOT/nav.adoc b/documentation/IDTA-01001/modules/ROOT/nav.adoc
@@ -88,7 +88,7 @@ SPDX-License-Identifier: CC-BY-4.0
 ** xref:./annex/metamodel-with-inheritance.adoc[Metamodel With Inheritance]
 
 
-* xref:changelog.adoc[Change Log]
+* xref:changelog.adoc[Change Notes]
 
 
 * xref:bibliography.adoc[Bibliography]

diff --git a/documentation/IDTA-01001/modules/ROOT/pages/annex/general.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/general.adoc
@@ -331,7 +331,8 @@ An asset typically may be represented by several different identification proper
 They are used for lookup of Asset Administration Shells in cases the globalAssetId is not available.
 However, they do not need to be globally unique.
 
-| |assetType |IRI a|recommended
+| |assetType |IRI a|
+recommended
 
 In case of AssetInformation/assetKind = Instance, specify the AssetInformation/globalAssetId of the type asset
 

diff --git a/documentation/IDTA-01001/modules/ROOT/pages/annex/usage-metamodel.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/usage-metamodel.adoc
@@ -17,7 +17,7 @@ SPDX-License-Identifier: CC-BY-4.0
 
 == Composite I4.0 Components
 
-As described in  xref:annex/general.adoc#life-cycle-with-type-assets-and-instance-assets[], there is a class of relationships between assets of different hierarchy levels.
+As described in  xref:annex/general.adoc#life-cycle-with-type-assets-and-instance-assets[Life Cycle with Type Assets and Instance Assets], there is a class of relationships between assets of different hierarchy levels.
 In this class of relationships, automation equipment is explained as a complex, interrelated graph of automation devices and products, performing intelligent production and self-learning/optimization tasks.
 
 Details and examples for composite I4.0 Components can be found in xref:bibliography.adoc#bib13[[13\]].

diff --git a/...tation/IDTA-01001/modules/ROOT/pages/annex/valueonly-serialization-example.adoc b/...tation/IDTA-01001/modules/ROOT/pages/annex/valueonly-serialization-example.adoc
@@ -156,11 +156,11 @@ due to the reasons mentioned above.
   "MySubmodelElementFileList": [
     {
       "contentType": "application/pdf",
-      "value": "MyFirstFile.pdf"
+      "value": "https://myDomain/MyFirstFile.pdf"
     },
     {
       "contentType": "application/pdf",
-      "value": "MySecondFile.pdf"
+      "value": "https://myDomain/MySecondFile.pdf"
     }
   ],
   "MySubmodelElementCollection":
@@ -170,4 +170,4 @@ due to the reasons mentioned above.
     "myBooleanElement": true
   }
 }
-----
+----
diff --git a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc
@@ -125,14 +125,14 @@ Available: https://msdn.microsoft.com/en-us/library/system.io.packaging(v=vs.110
 
 
 [#bib24]
-[24] ISO 13584-42 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods" Edition 4.0, 2017-07
+[24] ISO 13584-42 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods" Edition 4.0, 2017-07.
 
 [#bib25]
 [25] IEC 61360-1 "Standard data element types with associated classification scheme – Part 1: Definitions – Principles and methods", Edition 4.0, 2017-07. DIN EN 61360-1:2018-07.
 
 
 [#bib26]
-[26] ISO/TS 29002-10:2009(E) "Industrial automation systems and integration — Exchange of characteristic data — Part 10: Characteristic data exchange format", First edition 2009-12-01
+[26] ISO/TS 29002-10:2009(E) "Industrial automation systems and integration — Exchange of characteristic data — Part 10: Characteristic data exchange format", First edition 2009-12-01.
 
 [#bib27]
 [27] A. Bayha, J. Bock, B. Boss, C. Diedrich, S. Malakuti "Describing Capabilities of Industrie 4.0 Components".
@@ -142,19 +142,19 @@ Available: https://www.plattform-i40.de/PI40/Redaktion/EN/Downloads/Publikation/
 
 ////
 [#bib28]
-[28] AutomationML Association: "Application Recommendations: Asset Administration Shell Representation (AR 004E)", Version 1.0.0, 20.11.2019, 
-Available: https://www.automationml.org/o.red.c/dateien.html
+[28] AutomationML consortium: "Application Recommendation: AAS Representation (AR 004E)", Document Identifier: AR AAS, V1.0.0. November 2019. 
+Accessed: 2025-10-19. [Online].
+Available: https://www.automationml.org/wp-content/uploads/2022/04/Asset-Administration-Shell-Representation-V1_0_0.zip
 ////
 
 [#bib29]
-[29] H. Knublauch, D. Knotokostas "Shapes Constraint Language (SHACL)" W3C Recommendation, 2017, 
+[29] H. Knublauch, D. Knotokostas "Shapes Constraint Language (SHACL)" W3C Recommendation, 2017. 
 Accessed: 2025-03-24. [Online]. 
-Available:
 Available: https://www.w3.org/TR/shacl/
 
 ////
 [#bib30]
-[30] "I4AAS – Industrie 4.09 Asset Administration Shell". June 2021. [Online] Available: https://opcfoundation.org/markets-collaboration/I4AAS/
+[30] "I4AAS – Industrie 4.09 Asset Administration Shell". June 2021. 
 ////
 
 [#bib31]
@@ -177,19 +177,19 @@ Available: https://tomgruber.org/writing/ontolingua-kaj-1993.htm
 Technical Report.
 Version 2.3. October 10, 2020. Industrial Internet Consortium.
 IIC:IIVOC:V2.3:20201025 
-Accessed: 2025-03-24. [Online]. 
+Accessed: 2025-10-19. [Online].
 Available: https://www.iiconsortium.org/vocab/
 
 [#bib35]
 [35] "OMG Unified Modelling Language (OMG UML)".
 Formal/2017-12-05. Version 2.5.1. December 2018. 
-Accessed: 2025-03-24. [Online]. 
+Accessed: 2025-10-19. [Online]
 Available: https://www.omg.org/spec/UML/
 
 [#bib36]
 [36] T. Preston-Werner "Semantic Versioning".
 Version 2.0.0. 
-Accessed: 2025-03-24. [Online]. 
+Accessed: 2025-10-19. [Online]
 Available: https://semver.org/spec/v2.0.0.html
 
 [#bib37]
@@ -205,11 +205,15 @@ Accessed: 2025-03-24. [Online].
 Available: https://industrialdigitaltwin.org/en/wp-content/uploads/sites/2/2022/12/2022-12-07_IDTA_AAS-Reading-Guide.pdf
 
 [#bib39]
-[39] IDTA-02003 "Submodel Template of the Asset Administration Shell - Generic Frame for Technical Data for Industrial Equipment in Manufacturing", Version 1.2, Aug. 2022, Industrial Digital Twin Association 
+[39] IDTA-02003 "Submodel Template of the Asset Administration Shell - Generic Frame for Technical Data for Industrial Equipment in Manufacturing", 
+Version 1.2, Aug. 2022, 
+Industrial Digital Twin Association 
 See xref:bibliography.adoc#bib45[[45\]].
 
 [#bib40]
-[40] IDTA-02006 "Submodel Template of the Asset Administration Shell - Digital Nameplate for Industrial Equipment", Version 2.0, Oct. 2022, Industrial Digital Twin Association 
+[40] IDTA-02006 "Submodel Template of the Asset Administration Shell - Digital Nameplate for Industrial Equipment", 
+Version 2.0, Oct. 2022, 
+Industrial Digital Twin Association 
 See xref:bibliography.adoc#bib45[[45\]].
 
 ////
@@ -218,8 +222,7 @@ See xref:bibliography.adoc#bib45[[45\]].
 ////
 ////
 [#bib41]
-[41] Joint Working Group of the https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA]  
-https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)] 
+[41] Joint Working Group of the link:https://opcfoundation.org/[OPC Foundation] and https://industrialdigitaltwin.org/[IDTA] link:https://profiles.opcfoundation.org/workinggroup/40[Industry 4.0 Asset Administration Shell - AAS (I4AAS)] 
 ////
 ////
 [#bib42]
@@ -256,7 +259,11 @@ Available: https://www.plattform-i40.de/IP/Redaktion/DE/Downloads/Publikation/hm
 
 [#bib48]
 [48] "How to create a submodel template specification".
+V1.1. June 2025. Industrial Digital Twin Association.
 Guideline.
+Accessed: 2025-10-19. [Online]. 
+Available: https://industrialdigitaltwin.org/wp-content/uploads/2025/06/IDTA_How-to-write-a-SMT-v1.1.pdf
+
 December 2022. Industrial Digital Twin Association.
 Accessed: 2025-03-24. [Online]. 
 Available: https://industrialdigitaltwin.org/wp-content/uploads/2022/12/I40-IDTA-WS-Process-How-to-write-a-SMT-FINAL-.pdf
@@ -280,4 +287,4 @@ Industrial Digital Twin Association.
 Accessed: 2025-03-24. [Online]. 
 Available: https://github.com/admin-shell-io
 
-// bib52 see [41]
+// bib52 see [41]
diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc
@@ -36,19 +36,19 @@
 ====
 
 
-== Changes V3.2 vs. V3.1
+== Changes V3.2 vs. V3.1.2
 
 Major Changes:
 
 * IN DISCUSSION: ADDED: New attributes for data ranges in AdministrationInformation  (https://github.com/admin-shell-io/aas-specs-metamodel/issues/484[#484])
-* added new value to enumeration AssetKind: Batch to support Digital Product Passports (https://github.com/admin-shell-io/aas-specs-metamodel/issues/483[#483])
+* added: new value to enumeration AssetKind: Batch to support Digital Product Passports (https://github.com/admin-shell-io/aas-specs-metamodel/issues/483[#483])
 
 Minor Changes:
 
 * description of data type ContentType changed, some explanations with respect to mime types were removed (https://github.com/admin-shell-io/aas-specs-metamodel/issues/604[#604])
-* corrected and added links for definitions of qualifiers in IEC CDD (https://github.com/admin-shell-io/aas-specs-metamodel/issues/611[#611])
 * Annex UML: add information how to graphically depict attributes of type "Reference" (https://github.com/admin-shell-io/aas-specs-metamodel/issues/601[#601])
-* minor changes (including (https://github.com/admin-shell-io/aas-specs-metamodel/issues/600[#600])
+* update bibliography
+* editorial changes
 
 === Metamodel Changes V3.2 vs. V3.1.1
 
@@ -84,12 +84,65 @@
 | | | a| 
 |===
 
+== Changes V3.1.2 vs. V3.1.1
+
+Bugfixes:
+
+* CHANGED: fix AASd-021 (there was no change compared to V3.0, schemas not affected)  (https://github.com/admin-shell-io/aas-specs-metamodel/issues/624[#624])
+* CHANGED: make example for idShortPath consistent to (https://github.com/admin-shell-io/aas-specs-metamodel/issues/618[#618])
+* CHANGED: fix diagram for DataSpecificationContent: add stereotype "Template"
+* CHANGED: fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Operation` for `Operation` within `AasReferableNonIdentifiables` to `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/Operation`
+* CHANGED: fix syntax error in semantic metamodel ID `\https://admin-shell.io/aas/3/1/AAasReferableNonIdentifiables/SubmodelElement` to `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/SubmodelElement`
+* CHANGED: fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Blob` for `Blob` within  `AasNonContainerSubmodelElements` to `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/Blob`
+* CHANGED: fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/Extension` to `\https://admin-shell.io/aas/3/1/Extension/name` for attribute name in class Extension
+* CHANGED: fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/HasSemantics/supplementalId` for `HasSemantics` to `\https://admin-shell.io/aas/3/1/HasSemantics/supplementalSemanticId`
+* CHANGED: fix version number in semantic metamodel ID `\https://admin-shell.io/aas/3/0/BlobType` to `\https://admin-shell.io/aas/3/1/BlobType` for data type `BlobType`
+* CHANGED: Reference: remove recommendation to use an external reference for the referredSemanticId
+* CHANGED: correct references to standards defining qualifiers (https://github.com/admin-shell-io/aas-specs-metamodel/issues/611[#611])
+* CHANGED: DIN SPEC 92000 is a DIN DKE SPEC, reference corrected
+* CHANGED: bibliography, fix or remove non-working links
+* CHANGED: updated references to Submodel Templates Technical Data and Digital Nameplate
+* CHANGED: preamble, review process as defined in IDTA
+* editorial fixes
+
+.Changes in Metamodel
+[cols="5%,42%,48%",options="header",]
+|===
+|*Nc* |*V3.1 Change w.r.t. V3.0.2* |*Comment*
+
+| {empty} | AasNonContainerSubmodelElements/Blob a| fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Blob` for `Blob` within  `AasNonContainerSubmodelElements` to `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/Blob`
+
+| {empty} | AasReferableNonIdentifiables/Operation a| fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Operation` for `Operation` within `AasReferableNonIdentifiables` to `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/Operation`
+
+| {empty} | AasReferableNonIdentifiables/SubmodelElement a| fix syntax error in semantic metamodel ID `\https://admin-shell.io/aas/3/1/AAasReferableNonIdentifiables/SubmodelElement` to `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/SubmodelElement`
+
+| {empty} | BlobType a| fix version number in semantic metamodel ID `\https://admin-shell.io/aas/3/0/BlobType` to `\https://admin-shell.io/aas/3/1/BlobType` for data type `BlobType`
+
+| {empty} | Extension/name a| fix semantic metamodel ID `\https://admin-shell.io/aas/3/1/Extension` to `\https://admin-shell.io/aas/3/1/Extension/name` for attribute name in class `Extension`
+
+|===
+
+.New, Changed or Removed Constraints
+[cols="5%,10%,15%,69%",options="header",]
+|===
+|*Nc* |*V3.1 vs. V3.0* |*New, Update, Removed, Reformulated* |*Comment*
+
+
+|{empty}  | AASd-021| Correct a|
+
+Constraint AASd-021: Every qualifiable can only have one qualifier with the same Qualifier/valueType.
+
+corrected to
+
+Constraint AASd-021: Every qualifiable shall only have one qualifier with the same Qualifier/type.
+
+|===
+
 == Changes V3.1.1 vs. V3.1
 
 Bugfixes:
 
 * CHANGED: fix xml schema w.r.t. ordering of attributes (https://github.com/admin-shell-io/aas-specs-metamodel/issues/585[#585])
-* Added xref:spec-metamodel/core.adoc#AssetInformation[AssetInformation/AssetType] to Annex "General Topics", table "Elements with Allowed Identifying Values"
 
 
 
@@ -256,6 +309,7 @@
 Constraint AASd-021: Every qualifiable can only have one qualifier with the same Qualifier/valueType.
 
 changed to
+
 Constraint AASd-021: Every qualifiable shall only have one qualifier with the same Qualifier/valueType.
 
 |{empty}  |AASd-077 |Update a|
@@ -1062,7 +1116,7 @@
 * bugfix enumeration ReferableElements, no ConceptDictionary any longer + new elements like new submodel elements SubmodelElementList added.

 ====
 Note: ReferableElements was substituted by AasSubmodelElements and Aas Identifiables.
 ====

 * Entity/globalAssetId diagram (table was correct): Type change from reference of Reference* to Reference
@@ -1873,7 +1927,7 @@
 | |AASd-121 |New |Constraint AASd-121: For References the type of the first key of Reference/keys shall be one of GloballyIdentifiables.
 | |AASd-122 |New |Constraint AASd-122: For global references, i.e. References with Reference/type = GlobalReference, the type of the first key of Reference/keys shall be one of GenericGloballyIdentifiables.
 | |AASd-123 |New |Constraint AASd-123: For model references, i.e. References with Reference/type = ModelReference, the type of the first key of Reference/keys shall be one of AasIdentifiables.
 | |AASd-124 |New |Constraint AASd-124: For global references, i.e. References with Reference/type = GlobalReference, the last key of Reference/keys shall be either one of GenericGloballyIdentifiables or one of GenericFragmentKeys.
 | |AASd-125 |New |Constraint AASd-125: For model references, i.e. References with Reference/type = ModelReference, with more than one key in Reference/keys the type of the keys following the first key of Reference/keys shall be one of FragmentKeys.
 | |AASd-126 |New |Constraint AASd-126: For model references, i.e. References with Reference/type = ModelReference, with more than one key in Reference/keys the type of the last Key in the reference key chain may be one of GenericFragmentKeys or no key at all shall have a value out of GenericFragmentKey.
 | |AASd-127 |New |Constraint AASd-127: For model references, i.e. References with Reference/type = ModelReference, with more than one key in Reference/keys a key with type FragmentReference shall be preceded by a key with type File or Blob. All other AAS fragments, i.e. type values out of AasSubmodelElements, do not support fragments.
@@ -2072,7 +2126,7 @@
 Constraint AASd-014: Either the attribute globalAssetId or specificAssetId of an _Entity_ must be set if _Entity/entityType_ is set to "_SelfManagedEntity_". They are not existing otherwise.

 |(x) |AASd-020 |New |Constraint AASd-020: The value of Property/_value_ shall be consistent to the data type as defined in Property/_valueType_.
 |(x) |AASd-021 |New |Constraint AASd-021: Every qualifiable can only have one qualifier with the same _Qualifier/type._
 |(x) |AASd-022 |New a|
 Part from AASd-001 after split

@@ -2329,4 +2383,4 @@
 |PolicyEnforcementPoint/externalPolicyEnforcementPoint |
 |PolicyDecisionPoint |Was foreseen in V1.0 but not yet modelled
 |PolicyDecisionPoint/externalPolicyDecisionPoint |
-|===
+|===