Merge pull request #632 from admin-shell-io/IDTA-01001-3-1-2_Working

BugFix 3.1.2

Author: juileetikekar

README.md

@@ -64,12 +64,13 @@ 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, 
+* [3.1.2](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.2)
+is the latest release for the `V3.1.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.1](https://github.com/admin-shell-io/aas-specs-metamodel/releases/tag/v3.1.1) is the release for the  `V3.1.1` 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

documentation/IDTA-01001/antora.yml

@@ -1,6 +1,6 @@
 name: IDTA-01001
 title: 'Part 1: Metamodel'
-version: 'v3.1.1'
+version: 'v3.1.2'
 start_page: ROOT:index.adoc
 nav:
   - modules/ROOT/nav.adoc

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]

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\]].

documentation/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
   }
 }
-----
+----

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]

documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc

@@ -35,6 +35,60 @@ Note: before V3.0, the security metamodel (now IDTA-01004) and the predefined da
 They had separate sections and tables documenting the changes.
 ====
 
+== 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:
@@ -206,6 +260,7 @@ use "shall" instead of "can"
 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|
@@ -2279,4 +2334,4 @@ externalInformationPoint renamed to externalInformationPoints
 |PolicyEnforcementPoint/externalPolicyEnforcementPoint |
 |PolicyDecisionPoint |Was foreseen in V1.0 but not yet modelled
 |PolicyDecisionPoint/externalPolicyDecisionPoint |
-|===
+|===