From 684ddee207467b5cba77078fad89eb71c18c4194 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:22:27 +0200 Subject: [PATCH 01/56] bugfix Constraint AASd-021 --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 7 +++++++ .../modules/ROOT/pages/includes/constraints.adoc | 2 +- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 47cfae7c9..5fd2ac497 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -35,6 +35,13 @@ 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) https://github.com/admin-shell-io/aas-specs-metamodel/issues/624[#624]) + + == Changes V3.1.1 vs. V3.1 Bugfixes: diff --git a/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc b/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc index d43753049..d28e9c4ca 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc @@ -21,7 +21,7 @@ every entry needs to be in one line, no \ :aasd012: pass:q[[underline]#Constraint AASd-012:# If both the xref:ROOT:spec-metamodel/submodel-elements.adoc#MultiLanguageProperty[MultiLanguageProperty/value] and the xref:ROOT:spec-metamodel/submodel-elements.adoc#MultiLanguageProperty[MultiLanguageProperty/valueId] are present, the meaning must be the same for each string in a specific language, as specified in xref:ROOT:spec-metamodel/submodel-elements.adoc#MultiLanguageProperty[MultiLanguageProperty/valueId].] :aasd014: pass:q[[underline]#Constraint AASd-014:# Either the attribute xref:ROOT:spec-metamodel/core.adoc#AssetInformation[globalAssetId] or xref:ROOT:spec-metamodel/core.adoc#AssetInformation[specificAssetId] of an _Entity_ must be set if xref:ROOT:spec-metamodel/submodel-elements.adoc#Entity[Entity/entityType] is set to "xref:ROOT:spec-metamodel/submodel-elements.adoc#EntityType[SelfManagedEntity]".] :aasd020: pass:q[[underline]#Constraint AASd-020:# The value of xref:ROOT:spec-metamodel/common.adoc#Qualifier[Qualifier/value] shall be consistent with the data type as defined in xref:ROOT:spec-metamodel/common.adoc#Qualifier[Qualifier/valueType].] -:aasd021: pass:q[[underline]#Constraint AASd-021:# Every qualifiable shall only have one qualifier with the same xref:ROOT:spec-metamodel/common.adoc#Qualifier[Qualifier/valueType].] +:aasd021: pass:q[[underline]#Constraint AASd-021:# Every qualifiable shall only have one qualifier with the same xref:ROOT:spec-metamodel/common.adoc#Qualifier[Qualifier/type].] :aasd022: pass:q[[underline]#Constraint AASd-022:# xref:ROOT:spec-metamodel/common.adoc#Referable[idShort] of non-identifiable referables within the same name space shall be unique (case-sensitive).] :aasd077: pass:q[[underline]#Constraint AASd-077:# The name of an extension (xref:ROOT:spec-metamodel/common.adoc#Extension[Extension/name]) within xref:ROOT:spec-metamodel/common.adoc#HasExtensions[HasExtensions] shall be unique.] :aasd107: pass:q[[underline]#Constraint AASd-107:# If a first level child element in a xref:ROOT:spec-metamodel/submodel-elements.adoc#SubmodelElementList[SubmodelElementList] has a xref:ROOT:spec-metamodel/common.adoc#HasSemantics[semanticId], it shall be identical to xref:ROOT:spec-metamodel/submodel-elements.adoc#SubmodelElementList[SubmodelElementList/semanticIdListElement].] From 22018ab6d4d24c23680f65aad2a7111bde85c309 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:28:56 +0200 Subject: [PATCH 02/56] add that schemas not affected by bugfix --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 5fd2ac497..82c411de2 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -39,7 +39,7 @@ They had separate sections and tables documenting the changes. Bugfixes: -* CHANGED: fix AASd-021 (there was no change compared to V3.0) https://github.com/admin-shell-io/aas-specs-metamodel/issues/624[#624]) +* 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]) == Changes V3.1.1 vs. V3.1 From ec2c51de86f53e5a72203cc4507709220eb258c9 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:42:32 +0200 Subject: [PATCH 03/56] fix metamodel semantic ID for https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/Blob --- .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index 5c0d793c6..664b6ce6c 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -530,7 +530,7 @@ h|Explanation .2+e|BasicEventElement | `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/BasicEventElement` a|Basic event element -.2+e|Blob | `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Blob` +.2+e|Blob | `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/Blob` a|Blob .2+e|Capability | `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/Capability` From 4f88e0b11fbda3bf318a834ffaadc0a88797fd39 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:46:33 +0200 Subject: [PATCH 04/56] Reference: remove recommendation to use an external reference for the referredSemanticId --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 4 ++++ .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 6 ++---- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 82c411de2..90e72deb4 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -40,6 +40,10 @@ They had separate sections and tables documenting the changes. 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: fix diagram for DataSpecificationContent: add stereotype "Template" +* 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` +* Reference: remove recommendation to use an external reference for the referredSemanticId +* editorial fixes == Changes V3.1.1 vs. V3.1 diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index 664b6ce6c..4e9552064 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -68,15 +68,13 @@ Expected semantic ID of the referenced model element (_Reference/type=ModelRefer ==== -Note 1: if Reference/referredSemanticId is defined, the semanticId of the model element referenced should have a matching semantic ID. +Note: if Reference/referredSemanticId is defined, the semanticId of the model element referenced should have a matching semantic ID. If this is not the case, a validator should raise a warning. ==== -==== -Note 2: it is recommended to use an external reference for the semantic ID expected from the referenced model element. -==== + |xref:Reference[Reference] |0..1 From 5d7700692e7b326b0386dcfe1c8d8f097162f357 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:47:09 +0200 Subject: [PATCH 05/56] editorial --- .../modules/ROOT/pages/spec-metamodel/submodel-elements.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc index cb60509ee..da033d5dd 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc @@ -85,7 +85,7 @@ a|Reference to a referable, e.g. a data element or a submodel that is being obse a| Direction of event -Can be \{ input, output } +Can be { input, output } |xref:Direction[Direction]|1 From 7104ce948f563861dfcd1aa5c03cc0d6b684ab53 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:47:33 +0200 Subject: [PATCH 06/56] fix diagram for DataSpecificationContent: add stereotype "Template" --- .../partials/diagrams/classes/data-specification-content.puml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/data-specification-content.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/data-specification-content.puml index 81f288764..bbf39afb4 100644 --- a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/data-specification-content.puml +++ b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/data-specification-content.puml @@ -1,4 +1,4 @@ @startuml -abstract class DataSpecificationContent <> { +abstract class DataSpecificationContent <> { } @enduml \ No newline at end of file From d6178c938adb45aed9972b662825029f514b028b Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:52:24 +0200 Subject: [PATCH 07/56] * 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 --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 2 ++ .../IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 90e72deb4..11f2691b7 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -42,7 +42,9 @@ 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: fix diagram for DataSpecificationContent: add stereotype "Template" * 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 * Reference: remove recommendation to use an external reference for the referredSemanticId +* CHANGED: DIN SPEC 92000 is a DIN DKE SPEC, reference corrected * editorial fixes diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index c693201ba..a5c3f9248 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -219,7 +219,7 @@ h|ID: 3+| `\https://admin-shell.io/aas/3/1/Extension` .2+h|Attribute 3+h| ID h|Explanation h|Type h|Card. -.2+e|name 3+| `\https://admin-shell.io/aas/3/1/Extension` +.2+e|name 3+| `\https://admin-shell.io/aas/3/1/Extension/name` a|Name of the extension |xref:spec-metamodel/datatypes.adoc#NameType[NameType] |1 .2+e|[[Extension_valueType]]valueType 3+| `\https://admin-shell.io/aas/3/1/Extension/valueType` From 377040b575da80b115495e8ff2c2d1095b3f56f1 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:52:46 +0200 Subject: [PATCH 08/56] * CHANGED: DIN SPEC 92000 is a DIN DKE SPEC, reference corrected --- .../IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc index 67947e9d0..36194a869 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc @@ -239,7 +239,7 @@ FTP://unicode.org .2+e|[[QualifierType]]QualifierType 2+| `\https://admin-shell.io/aas/3/1/QualifierType` a|_NameType_ a| -"ExpressionSemantic" (as specified in DIN SPEC 92000:2019-09, see xref:bibliography.adoc#bib16[[16\]]) +"ExpressionSemantic" (as specified in DIN DKE SPEC 92000:2019-09, see xref:bibliography.adoc#bib16[[16\]]) "life cycle qual" (as specified in IEC 61360-7 - IEC/SC 3D - Common Data Dictionary (link:https://cdd.iec.ch/cdd/common/iec61360-7.nsf/SearchFrameset?OpenFrameSet[CDD - V2.0015.0004]) From 67bc5370144019a70cc7a9b7181b4d3246e4c545 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 17:58:18 +0200 Subject: [PATCH 09/56] fix and update bibliography --- .../modules/ROOT/pages/bibliography.adoc | 33 +++++++++++-------- .../modules/ROOT/pages/changelog.adoc | 2 ++ 2 files changed, 22 insertions(+), 13 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc index 2558edc67..059572f3e 100644 --- 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,20 +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] [31] DIN EN IEC 61406-1: "Identification Link - Part 1: General requirements (IEC 61406-1:2022)". @@ -177,19 +176,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 +204,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\]]. //// @@ -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 diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 11f2691b7..fb1915069 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -45,6 +45,8 @@ Bugfixes: * 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 * Reference: remove recommendation to use an external reference for the referredSemanticId * 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 * editorial fixes From db1f2652e2ef5120a76486519ee0441cd052e52c Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:08:11 +0200 Subject: [PATCH 10/56] * CHANGED: make example for idShortPath consistent to https://github.com/admin-shell-io/aas-specs-metamodel/issues/618[#618]) --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 1 + .../modules/ROOT/pages/mappings/encodings/idshortpath.adoc | 3 +++ 2 files changed, 4 insertions(+) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index fb1915069..467cd89fa 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -40,6 +40,7 @@ They had separate sections and tables documenting the changes. 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/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 diff --git a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/idshortpath.adoc b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/idshortpath.adoc index b32160f21..bae1c922d 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/idshortpath.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/idshortpath.adoc @@ -61,6 +61,9 @@ Submodel: MySubmodel *** SML: MySubSubmodelElementList3 **** SMC: MySubmodelElementCollectionInSML3 ***** Property: "MySubTestValue3" +*** SML: MySubSubmodelElementList3 +**** SMC: MySubmodelElementCollection2InSML3 +***** Property: "MySubTestValue3" ==== idShortPaths for SMC MySubmodelElementCollection within the Submodel above: From 7e7b2209a1af0ed2ad81813c4d46f1c28597f0cb Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:13:49 +0200 Subject: [PATCH 11/56] * CHANGED: correct references to standards defining qualifiers https://github.com/admin-shell-io/aas-specs-metamodel/issues/611[#611]) --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 1 + .../IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc | 3 ++- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 467cd89fa..ce4c367cc 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -45,6 +45,7 @@ Bugfixes: * 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 * 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 diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index a5c3f9248..d2b7ee17c 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -449,7 +449,8 @@ include::partial$diagrams/21-qualifier.puml[] Qualifiers may be defined for qualifiable elements. -There are standardized qualifiers defined in IEC CDD, IEC61360-4 – IEC/SC 3D. +There are standardized qualifiers defined in link:https://cdd.iec.ch/cdd/iec61360-7/iec61360-7.nsf/TreeFrameset?OpenFrameSet&ongletactif=1[IEC CDD, IEC61360-7]. +Additionally, link:https://cdd.iec.ch/cdd/iec61987/iec61987.nsf/TreeFrameset?OpenFrameSet&ongletactif=1[IEC 619897] is defining qualifiers. A level qualifier defining the level type minimal, maximal, typical, and nominal value is specified in IEC 62569-1. In DIN SPEC 92000, qualifier types like e.g. expression semantics and expression logic are defined. From c99bc1beb8883bb67dc372767c339542b6ea6be1 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:26:03 +0200 Subject: [PATCH 12/56] editorial --- .../IDTA-01001/modules/ROOT/pages/annex/usage-metamodel.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/annex/usage-metamodel.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/usage-metamodel.adoc index 43eb20c98..cfff834e7 100644 --- 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\]]. From 9b57671516129fd14436954e1daae3cff2e51d48 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:26:17 +0200 Subject: [PATCH 13/56] fix JSON, add , --- .../modules/ROOT/pages/mappings/encodings/metadata-objects.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/metadata-objects.adoc b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/metadata-objects.adoc index 856e0393e..df123ba31 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/metadata-objects.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/metadata-objects.adoc @@ -64,7 +64,7 @@ a| "description": [...], "id": "idTestAAS", ... - "derivedFrom": {...} + "derivedFrom": {...}, "assetInformation": {...}, "submodels": [...] } From a5efbd3ede67f1c21e0e19c9e6e7160c671238f2 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:27:32 +0200 Subject: [PATCH 14/56] update index.adoc to V3.1.2 --- documentation/IDTA-01001/modules/ROOT/pages/index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc index 7047ffd01..4eaedcd05 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc @@ -16,9 +16,9 @@ This specification is part of the https://industrialdigitaltwin.org/en/content-h == Version -This is version 3.1.1 of the specification IDTA-01001. +This is version 3.1.2 of the specification IDTA-01001. -Previous version: 3.1 +Previous version: 3.1.1 [#metamodel-versions] == Dependencies From c055f61996deaa7474f3460ba4c6d589f025a7d9 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:28:42 +0200 Subject: [PATCH 15/56] update index.adoc --- documentation/IDTA-01001/modules/ROOT/pages/index.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc index 4eaedcd05..c74907de8 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc @@ -35,9 +35,9 @@ Copyright: Industrial Digital Twin Association e.V. (IDTA) IDTA Number: IDTA-01001 -Version: 3.1.1 +Version: 3.1.2 -DOI: https://doi.org/10.62628/IDTA.01001-3-1-1 +DOI: https://doi.org/10.62628/IDTA.01001-3-1-2 This work is licensed under a https://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]. From 7ab667b0606d50d4f82b5d39f1edce066feb0d77 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:29:26 +0200 Subject: [PATCH 16/56] add date to index.adoc for V3.1.2 --- documentation/IDTA-01001/modules/ROOT/pages/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc index c74907de8..47395a0af 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc @@ -44,7 +44,7 @@ https://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 In SPDX-License-Identifier: CC-BY-4.0 -July 2025 +October 2025 == How to Get in Contact From 274ab24f575f199f01892fbe9cdc354cf43ee860 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 23 Oct 2025 18:30:54 +0200 Subject: [PATCH 17/56] update antora.yml to V3.1.2 --- documentation/IDTA-01001/antora.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml index fb736b54c..2d7ac7413 100644 --- a/documentation/IDTA-01001/antora.yml +++ b/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 From 802076a90746072d5b326b802c10173b40bf6e18 Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:24:00 +0200 Subject: [PATCH 18/56] Correct metamodel semantic ID of Operation in AasReferablesNinIdentifiabled --- .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index 4e9552064..6352f01b4 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -466,7 +466,7 @@ a|File .2+e|MultiLanguageProperty | `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/MultiLanguageProperty` a|Property with a value that can be provided in multiple languages -.2+e|Operation| `\https://admin-shell.io/aas/3/1/AasSubmodelElements/Operation` +.2+e|Operation| `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/Operation` a|Operation .2+e|Property | `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/Property` From 5e1112fc451984bfcb0d6aa3f405e9b3a0290f5f Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:30:39 +0200 Subject: [PATCH 19/56] Update changelog with recent semantic metamodel fixes --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index ce4c367cc..b3acafeb9 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -42,6 +42,7 @@ 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 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 * Reference: remove recommendation to use an external reference for the referredSemanticId @@ -2296,4 +2297,4 @@ externalInformationPoint renamed to externalInformationPoints |PolicyEnforcementPoint/externalPolicyEnforcementPoint | |PolicyDecisionPoint |Was foreseen in V1.0 but not yet modelled |PolicyDecisionPoint/externalPolicyDecisionPoint | -|=== \ No newline at end of file +|=== From 8076ce1db497b9c6a3d4af9b90a066e3a7593801 Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:32:50 +0200 Subject: [PATCH 20/56] Fix URL for SubmodelElement in referencing.adoc --- .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index 6352f01b4..d460105e6 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -483,7 +483,7 @@ a|Reference a|Relationship -.2+e|SubmodelElement | `\https://admin-shell.io/aas/3/1/AAasReferableNonIdentifiables/SubmodelElement` +.2+e|SubmodelElement | `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/SubmodelElement` a| Submodel element From cd73afa2bb76c7f3fea5c6df82202ca97339e4df Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:33:45 +0200 Subject: [PATCH 21/56] Correct capitalization of 'Data Element' to 'Data element' --- .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index d460105e6..7b40cca87 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -537,7 +537,7 @@ a|Capability .2+e|DataElement | `\https://admin-shell.io/aas/3/1/AasNonContainerSubmodelElements/DataElement` a| -Data Element +Data element ==== From 83c50c42a73a7ccfcd7ccf8592037ba67852a01c Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:35:31 +0200 Subject: [PATCH 22/56] Editorial constraints in constraints.adoc --- .../IDTA-01001/modules/ROOT/pages/includes/constraints.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc b/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc index d28e9c4ca..b6dd5f69f 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/includes/constraints.adoc @@ -39,7 +39,7 @@ every entry needs to be in one line, no \ :aasd124: pass:q[[underline]#Constraint AASd-124:# For external references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with _Reference/type_ = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ExternalReference], the last _key_ of _Reference/keys_ shall be either one of xref:ROOT:spec-metamodel/referencing.adoc#GenericGloballyIdentifiables[GenericGloballyIdentifiables] or one of xref:ROOT:spec-metamodel/referencing.adoc#GenericFragmentKeys[GenericFragmentKeys].] :aasd125: pass:q[[underline]#Constraint AASd-125:# For model references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference/type] = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ModelReference] with more than one key in _Reference/keys_, the value of xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] of each of the keys following the first key of _Reference/keys_ shall be one of xref:ROOT:spec-metamodel/referencing.adoc#FragmentKeys[FragmentKeys].] :aasd126: pass:q[[underline]#Constraint AASd-126:# For model references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with _Reference/type_ = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ModelReference] with more than one key in _Reference/keys,_ the value of xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] of the last xref:ROOT:spec-metamodel/referencing.adoc#Key[Key] in the reference key chain may be one of xref:ROOT:spec-metamodel/referencing.adoc#GenericFragmentKeys[GenericFragmentKeys] or no key at all shall have a value out of xref:ROOT:spec-metamodel/referencing.adoc#GenericFragmentKeys[GenericFragmentKeys].] -:aasd127: pass:q[[underline]#Constraint AASd-127:# For model references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with _Reference/type_ = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ModelReference] with more than one key in _Reference/keys,_ a key with xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] _FragmentReference_ shall be preceded by a key with xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] _File_ or _Blob_. All other Asset Administration Shell fragments, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] values out of xref:ROOT:spec-metamodel/referencing.adoc#AasSubmodelElements[AasSubmodelElements] , do not support fragments.] +:aasd127: pass:q[[underline]#Constraint AASd-127:# For model references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with _Reference/type_ = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ModelReference] with more than one key in _Reference/keys,_ a key with xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] _FragmentReference_ shall be preceded by a key with xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] _File_ or _Blob_. All other Asset Administration Shell fragments, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] values out of xref:ROOT:spec-metamodel/referencing.adoc#AasSubmodelElements[AasSubmodelElements], do not support fragments.] :aasd128: pass:q[[underline]#Constraint AASd-128:# For model references, i.e. xref:ROOT:spec-metamodel/referencing.adoc#Reference[Reference]s with _Reference/type_ = xref:ROOT:spec-metamodel/referencing.adoc#ReferenceTypes[ModelReference], the xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/value] of a xref:ROOT:spec-metamodel/referencing.adoc#Key[Key] preceded by a xref:ROOT:spec-metamodel/referencing.adoc#Key[Key] with xref:ROOT:spec-metamodel/referencing.adoc#Key[Key/type] = xref:ROOT:spec-metamodel/submodel-elements.adoc#SubmodelElementList[SubmodelElementList] is an integer number denoting the position in the array of the submodel element list.] :aasd129: pass:q[[underline]#Constraint AASd-129:# If any xref:ROOT:spec-metamodel/common.adoc#Qualifier[Qualifier/kind] value of a xref:ROOT:spec-metamodel/submodel-elements.adoc#SubmodelElement[SubmodelElement/qualifier] (attribute _qualifier_ inherited via xref:ROOT:spec-metamodel/common.adoc#Qualifiable[Qualifiable]) is equal to xref:ROOT:spec-metamodel/common.adoc#QualifierKind[TemplateQualifier], the submodel element shall be part of a submodel template, i.e. a _Submodel_ with xref:ROOT:spec-metamodel/core.adoc#Submodel[Submodel/kind] (attribute _kind_ inherited via xref:ROOT:spec-metamodel/common.adoc#HasKind[HasKind]) value equal to xref:ROOT:spec-metamodel/common.adoc#ModellingKind[Template].] :aasd130: pass:q[[underline]#Constraint AASd-130:# An attribute with data type "string" shall be restricted to the characters as defined in XML Schema 1.0, i.e. the string shall consist of these characters only: ^[\x09\x0A\x0D\x20-\uD7FF\uE000-\uFFFD\u00010000-\u0010FFFF]*$.] From c2cffa80ed1b6589d922f230298af036076dccd6 Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:39:23 +0200 Subject: [PATCH 23/56] Fix changelog formatting and update references --- .../IDTA-01001/modules/ROOT/pages/changelog.adoc | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index b3acafeb9..7b5eda60c 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -39,14 +39,14 @@ They had separate sections and tables documenting the changes. 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 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 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/Extension` to `\https://admin-shell.io/aas/3/1/Extension/name` for attribute name in class Extension * 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: 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 From f487c88ce0d7edf54b59c395ca00781bd0a0ade5 Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:42:54 +0200 Subject: [PATCH 24/56] Update changelog.adoc --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 7b5eda60c..dc992d42d 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -43,6 +43,7 @@ Bugfixes: * 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 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 * Reference: remove recommendation to use an external reference for the referredSemanticId From 50af536d0781cc109a2cdd40569f4242333b5caf Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 21:58:47 +0200 Subject: [PATCH 25/56] Value only File: absolute path, no relative path --- .../modules/ROOT/pages/mappings/encodings/valueonly.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/valueonly.adoc b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/valueonly.adoc index 63e8a9bba..6839c1c37 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/valueonly.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/valueonly.adoc @@ -425,7 +425,7 @@ For a _File_ named "Document", the Value-Only payload is minimized to the follow ---- { "contentType": "application/pdf", - "value": "SafetyInstructions.pdf" + "value": "https://myDomain/SafetyInstructions.pdf" } ---- From 15e86180b6f1caa5f41fbb779d4df042f556f1af Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 22:05:41 +0200 Subject: [PATCH 26/56] Fix bibliography links formatting in bibliography.adoc --- .../IDTA-01001/modules/ROOT/pages/bibliography.adoc | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc index 059572f3e..4b7bffc6f 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc @@ -221,8 +221,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] @@ -287,4 +286,4 @@ Industrial Digital Twin Association. Accessed: 2025-03-24. [Online]. Available: https://github.com/admin-shell-io -// bib52 see [41] \ No newline at end of file +// bib52 see [41] From bd33bd8d74704de840d5018966c6daa1cb3dc731 Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Fri, 24 Oct 2025 22:09:24 +0200 Subject: [PATCH 27/56] Absolute path instead of relative path for File SME Updated file references to use URLs instead of local file names. --- .../ROOT/pages/annex/valueonly-serialization-example.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/annex/valueonly-serialization-example.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/valueonly-serialization-example.adoc index 3c300dc2a..c1a760570 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/annex/valueonly-serialization-example.adoc +++ b/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 } } ----- \ No newline at end of file +---- From 5f3344e11543f39f2f6282404416893c01715782 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 09:28:37 +0100 Subject: [PATCH 28/56] improve changelog: add constraint table --- .../modules/ROOT/pages/changelog.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index dc992d42d..c097d3daf 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -54,6 +54,22 @@ Bugfixes: * editorial fixes +.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. + +changed to + +Constraint AASd-021: Every qualifiable shall only have one qualifier with the same Qualifier/type. + +|=== + == Changes V3.1.1 vs. V3.1 Bugfixes: @@ -225,6 +241,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| From ed2540ca6809a2887f307bd9964cdbf240796b67 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 09:36:16 +0100 Subject: [PATCH 29/56] improve changelog: add metamodel change table --- .../modules/ROOT/pages/changelog.adoc | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index c097d3daf..0073418ab 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -43,7 +43,7 @@ Bugfixes: * 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 semantic metamodel ID `\https://admin-shell.io/aas/3/1/AAasReferableNonIdentifiables/SubmodelElement` to `\https://admin-shell.io/aas/3/1/AasReferableNonIdentifiables/SubmodelElement` +* 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 * Reference: remove recommendation to use an external reference for the referredSemanticId @@ -53,6 +53,20 @@ Bugfixes: * CHANGED: updated references to Submodel Templates Technical Data and Digital Nameplate * editorial fixes +.Changes in Metamodel +[cols="5%,42%,48%",options="header",] +|=== +|*Nc* |*V3.1 Change w.r.t. V3.0.2* |*Comment* + +| {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} | 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} | 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",] @@ -64,7 +78,7 @@ Bugfixes: Constraint AASd-021: Every qualifiable can only have one qualifier with the same Qualifier/valueType. -changed to +corrected to Constraint AASd-021: Every qualifiable shall only have one qualifier with the same Qualifier/type. From dbef238d58a36ef8f98cf76bdd5e3788665f5801 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 09:43:04 +0100 Subject: [PATCH 30/56] fix semantic metamodel ID for data type BlobType --- .../IDTA-01001/modules/ROOT/pages/changelog.adoc | 9 ++++++--- .../modules/ROOT/pages/spec-metamodel/datatypes.adoc | 2 +- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 0073418ab..7f1a87bb4 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -46,7 +46,8 @@ Bugfixes: * 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 -* Reference: remove recommendation to use an external reference for the referredSemanticId +* 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 @@ -58,13 +59,15 @@ Bugfixes: |=== |*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} | 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} | 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` +| {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` |=== diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc index 36194a869..dfe7ed8f1 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc @@ -76,7 +76,7 @@ Note: see xref:spec-metamodel/constraints.adoc#constraints-for-types[Constraint .2+h|Primitive 2+h| ID h|Definition h|Value Examples -.2+e|[[BlobType]]BlobType 2+| `\https://admin-shell.io/aas/3/0/BlobType` +.2+e|[[BlobType]]BlobType 2+| `\https://admin-shell.io/aas/3/1/BlobType` a| _base64binary_ From 77a0d82be161d4af0d3c4a6d675c498bf28a79ca Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 09:56:42 +0100 Subject: [PATCH 31/56] update Preamble: review as defined in IDTA --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 1 + documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 7f1a87bb4..56ca01977 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -52,6 +52,7 @@ Bugfixes: * 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 diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index 5d1ae932a..03a8e95ee 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -84,6 +84,6 @@ See Annex xref:annex/concepts-aas.adoc[] for more information. The partners represented in the link:https://github.com/admin-shell-io/aas-specs-iec61360/issues/43[Plattform Industrie 4.0] and the link:https://industrialdigitaltwin.org/[Industrial Digital Twin Association (IDTA)] and associations such as link:https://www.zvei.org/[ZVEI], link:https://www.vdma.org[VDMA], link:https://www.vdi.de/en/home[VDI]/link:https://www.vde.com/en[VDE] and link:https://www.bitkom.org/EN[Bitkom], ensure that there is broad sectoral coverage of process, hybrid, and factory automation and in terms of integrating information technology (IT) and operational technology (OT). Design alternatives were intensively discussed within the working group. -An extensive feedback process of this document series is additionally performed within the working groups of Plattform Industrie 4.0 and IDTA. +An extensive feedback process of this document series is additionally performed conformant to the review process as defined by IDTA. Guiding principle for the specification was to provide detailed information, which can be easily implemented also by small and medium-sized enterprises. From 4b40b620da54a93c33b11ff66e25abff289d2fec Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 09:58:51 +0100 Subject: [PATCH 32/56] structure of document: add Annex Overview Constraints --- documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index 03a8e95ee..a8e00d970 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -64,7 +64,8 @@ Annex xref:annex/uml.adoc[] contains information about UML, while Annex xef:anne Annex xref:annex/grammar-semantic-ids-metamodel.adoc[] explains how semantic identifiers for the elements of the metamodel itself are derived. -xref:annex/handling-constraints.adoc[] explains the numbering of constraints used in the specification. +xref:annex/handling-constraints.adoc[] explains the numbering of constraints used in the specification. +An overview of all constraints contained in the specification can be found in xref:annex/overview-constraints.adoc[]. Annex xref:annex/usage-metamodel.adoc[] provides some hints for modelers. Annex xref:annex/metamodel-with-inheritance.adoc[] shows selected metamodel diagrams including all inherited attributes for developers. From 0e4a79fdb9eb53b12633743ef872ef24ea85339a Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:00:02 +0100 Subject: [PATCH 33/56] Change "Change Log" to "Change Notes" to be more consistent --- documentation/IDTA-01001/modules/ROOT/nav.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/nav.adoc b/documentation/IDTA-01001/modules/ROOT/nav.adoc index a2297daaa..aaf4224a2 100644 --- 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] From 4d9db1c37e38ba549470890959545e80a0697141 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:02:39 +0100 Subject: [PATCH 34/56] fix xref --- documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index a8e00d970..52cf6b6ea 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -48,7 +48,7 @@ xref:spec-metamodel/index.adoc[] is the main normative part of the document. It stipulates structural principles of the Administration Shell in a formal manner to ensure an exchange of information using Asset Administration Shells. A UML diagram has been defined for this purpose. -xref:data-specifications.adoc[] explains how to define predefined data specifications, including those for defining concept descriptions. A discussion on the difference of data specification templates, inheritance, qualifiers and categories can be found in the xref:annex/uml.adoc[]#templates-inheritance-qualifiers-and-categories[Annex]. +xref:data-specifications.adoc[] explains how to define predefined data specifications, including those for defining concept descriptions. A discussion on the difference of data specification templates, inheritance, qualifiers and categories can be found in the xref:annex/uml.adoc#templates-inheritance-qualifiers-and-categories[Annex]. xref:mappings/mappings.adoc[] provides information on the exchange of information compliant to this specification in existing data formats like XML, JSON, or RDF. For this purpose additional formats are defined as well as needed text serializations of complex types. From 796f3a7d5e48c8eac0cf8350e1828443beefa624 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:06:04 +0100 Subject: [PATCH 35/56] fix xref --- documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index 52cf6b6ea..645327bb7 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -48,7 +48,8 @@ xref:spec-metamodel/index.adoc[] is the main normative part of the document. It stipulates structural principles of the Administration Shell in a formal manner to ensure an exchange of information using Asset Administration Shells. A UML diagram has been defined for this purpose. -xref:data-specifications.adoc[] explains how to define predefined data specifications, including those for defining concept descriptions. A discussion on the difference of data specification templates, inheritance, qualifiers and categories can be found in the xref:annex/uml.adoc#templates-inheritance-qualifiers-and-categories[Annex]. +xref:data-specifications.adoc[] explains how to define predefined data specifications, including those for defining concept descriptions. +A discussion on the difference of data specification templates, inheritance, qualifiers and categories can be found in the xref:annex/uml.adoc#templates-inheritance-qualifiers-and-categories[Annex]. xref:mappings/mappings.adoc[] provides information on the exchange of information compliant to this specification in existing data formats like XML, JSON, or RDF. For this purpose additional formats are defined as well as needed text serializations of complex types. @@ -60,7 +61,7 @@ Annex xref:annex/concepts-aas.adoc[] contains additional background information Annex xref:annex/valueonly-serialization-example.adoc[] and example of a Value-Only serialization as explained in xref:mappings/mappings.adoc#value-only-serialization-in-json[Mappings] is given. Annex xref:annex/backus-naur-form.adoc[] defines the grammar language used in the specification. -Annex xref:annex/uml.adoc[] contains information about UML, while Annex xef:annex/uml-templates.adoc[] provides the tables used to specify UML classes etc. as used in this specification. +Annex xref:annex/uml.adoc[] contains information about UML, while Annex xref:annex/uml-templates.adoc[] provides the tables used to specify UML classes etc. as used in this specification. Annex xref:annex/grammar-semantic-ids-metamodel.adoc[] explains how semantic identifiers for the elements of the metamodel itself are derived. From 60fca09da15286fb34236bdef878e05619347261 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:14:42 +0100 Subject: [PATCH 36/56] syntax only --- .../IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index d2b7ee17c..a1edc7b6f 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -65,11 +65,11 @@ If an AAS contains two different Submodels guided by the same Submodel Template In this case both Submodels shall have a templateId assigned to them (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]). ==== -Note 3: In some cases there is neither a semanticId (xref:spec-metamodel/common.adoc#semanticId[Submodel/semanticId]) nor a template ID (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]) defined for the Submodel. In this case there is no way for the data consumer to formally see whether two Submodels are providing the same semantic information. +Note 3: in some cases there is neither a semanticId (xref:spec-metamodel/common.adoc#semanticId[Submodel/semanticId]) nor a template ID (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]) defined for the Submodel. In this case there is no way for the data consumer to formally see whether two Submodels are providing the same semantic information. ==== ==== -Note 4: If a template ID of one of the standardized Submodel Templates of the IDTA is used to guide the creation of a Submodel then there is also a semantic ID defined for the Submodel. +Note 4: if a template ID of one of the standardized Submodel Templates of the IDTA is used to guide the creation of a Submodel then there is also a semantic ID defined for the Submodel. ==== From 5119c7e497bdf62a687a961eb7085cf13152b51e Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:17:26 +0100 Subject: [PATCH 37/56] General is now Annex: update structure --- documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index 645327bb7..dc7acbc40 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -40,7 +40,7 @@ xref:terms-definitions-and-abbreviations.adoc[] provides terms and definitions a xref:introduction.adoc[] gives a short introduction into the content of this document. -xref:annex/general.adoc[] summarizes relevant, existing content from the standardization of Industry 4.0; i.e. it provides an overview and explains the motives, but is not absolutely necessary for an understanding of the subsequent definitions. + @@ -57,6 +57,7 @@ For this purpose additional formats are defined as well as needed text serializa xref:summary-and-outlook.adoc[] summarizes the content and gives an outlook on future work. Annex xref:annex/concepts-aas.adoc[] contains additional background information on Asset Administration Shell. +Annex xref:annex/general.adoc[] summarizes relevant, existing content from the standardization of Industry 4.0; i.e. it provides an overview and explains the motives, but is not absolutely necessary for an understanding of the specification. Annex xref:annex/valueonly-serialization-example.adoc[] and example of a Value-Only serialization as explained in xref:mappings/mappings.adoc#value-only-serialization-in-json[Mappings] is given. From 2297c7427812353efd0432727d8b99fe7421ff0f Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:22:29 +0100 Subject: [PATCH 38/56] Add "Annex" before xref to Annex --- documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc | 2 +- .../modules/ROOT/pages/spec-metamodel/referencing.adoc | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc index dc7acbc40..7530338d5 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/preamble.adoc @@ -25,7 +25,7 @@ This document focuses on: * an introduction to the need of mappings to suitable technologies used in different life cycle phases of a product, providing mappings for XML, JSON, and RDF. This document presumes some familiarity with the concept of the Asset Administration Shell. -Some of the concepts are described in xref:annex/concepts-aas.adoc[] for convenience’s sake. +Some of the concepts are described in Annex xref:annex/concepts-aas.adoc[] for convenience’s sake. The concepts are being standardized as IEC standard IEC 63278 series, xref:bibliography.adoc#bib44[[44\]] and xref:bibliography.adoc#bib37[[37\]]. The main stakeholders addressed in this document are architects and software developers aiming to implement a digital twin using the Asset Administration Shell in an interoperable way. Additionally, the content can also be used as input for discussions with international standardization organizations and further initiatives. diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc index 7b40cca87..806a88e64 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/referencing.adoc @@ -33,7 +33,7 @@ include::partial$diagrams/48-reference.puml[] .... -See xref:annex/general.adoc#matching-algorithm-for-references[Matching Algorithm for References] for reference matching. +See Annex xref:annex/general.adoc#matching-algorithm-for-references[Matching Algorithm for References] for reference matching. [.table-with-appendix-table] [cols="25%,40%,25%,10%"] From 2da193f33e7b79b43d9b1a19777217bfa51bc146 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 10:25:55 +0100 Subject: [PATCH 39/56] summary: change Part 2 ref to overall ass-spec. ref --- .../IDTA-01001/modules/ROOT/pages/summary-and-outlook.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/summary-and-outlook.adoc b/documentation/IDTA-01001/modules/ROOT/pages/summary-and-outlook.adoc index fe46de349..3b042c251 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/summary-and-outlook.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/summary-and-outlook.adoc @@ -8,7 +8,7 @@ Several serializations and mappings are offered for the Asset Administration She * JSON, mainly used for API definition, but also for file exchange as alternative to XML, and * RDF for reasoning. -Additional parts of the document series cover (see xref:bibliography.adoc#bib37[[37\]]): +Additional parts of the document series cover (see xref:bibliography.adoc#bib46[[46\]]): * interfaces and APIs for accessing the information of Asset Administration Shells (access, modify, query, and execute information and active functionality), Part 2; the payload of these APIs is based on the definitions of the information model in this document, Part 1, * predefined data specification templates (Part 3 series), for example for concept descriptions of properties conformant to IEC61360 (Part 3a), From fe78e2ee7a560a9642b5b64fbd39cb4dac5a83ad Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 12:52:34 +0100 Subject: [PATCH 40/56] fix bibliography: comment ending was missing --- documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc | 1 + 1 file changed, 1 insertion(+) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc index 4b7bffc6f..ac40b65d1 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/bibliography.adoc @@ -155,6 +155,7 @@ Available: https://www.w3.org/TR/shacl/ //// [#bib30] [30] "I4AAS – Industrie 4.09 Asset Administration Shell". June 2021. +//// [#bib31] [31] DIN EN IEC 61406-1: "Identification Link - Part 1: General requirements (IEC 61406-1:2022)". From 7ae6337075c3edefab086e93d8a26d6cb97087fe Mon Sep 17 00:00:00 2001 From: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> Date: Mon, 27 Oct 2025 12:58:27 +0100 Subject: [PATCH 41/56] Update antora.yml --- documentation/IDTA-01001/antora.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml index 2d7ac7413..6a81d47e7 100644 --- a/documentation/IDTA-01001/antora.yml +++ b/documentation/IDTA-01001/antora.yml @@ -1,6 +1,6 @@ name: IDTA-01001 title: 'Part 1: Metamodel' -version: 'v3.1.2' +version: 'v3.1.2 in progress' start_page: ROOT:index.adoc nav: - modules/ROOT/nav.adoc From d8f1b9fd071af812e6082d3adfbef81cba2ae751 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 13:00:55 +0100 Subject: [PATCH 42/56] antora: add "in progress" --- documentation/IDTA-01001/antora.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml index 2d7ac7413..6a81d47e7 100644 --- a/documentation/IDTA-01001/antora.yml +++ b/documentation/IDTA-01001/antora.yml @@ -1,6 +1,6 @@ name: IDTA-01001 title: 'Part 1: Metamodel' -version: 'v3.1.2' +version: 'v3.1.2 in progress' start_page: ROOT:index.adoc nav: - modules/ROOT/nav.adoc From 078859c6052f6c4c544cd86271a51de66157f7e9 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 13:19:19 +0100 Subject: [PATCH 43/56] 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` --- documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc | 1 + .../IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 56ca01977..d4f19965a 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -46,6 +46,7 @@ Bugfixes: * 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]) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index a1edc7b6f..2b045cc92 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -331,7 +331,7 @@ Identifier of the semantic definition of the element called semantic ID or also |xref:spec-metamodel/referencing.adoc#Reference[Reference] |0..1 -.2+e|supplementalSemanticId 3+| `\https://admin-shell.io/aas/3/1/HasSemantics/supplementalId` +.2+e|supplementalSemanticId 3+| `\https://admin-shell.io/aas/3/1/HasSemantics/supplementalSemanticId` a| Identifier of a supplemental semantic definition of the element called supplemental semantic ID of the element From d9cc1982a50d20104edacafa2ad8aee47d3d2854 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Mon, 27 Oct 2025 13:21:09 +0100 Subject: [PATCH 44/56] editorial only --- .../IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index 2b045cc92..95793c1fa 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -65,7 +65,8 @@ If an AAS contains two different Submodels guided by the same Submodel Template In this case both Submodels shall have a templateId assigned to them (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]). ==== -Note 3: in some cases there is neither a semanticId (xref:spec-metamodel/common.adoc#semanticId[Submodel/semanticId]) nor a template ID (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]) defined for the Submodel. In this case there is no way for the data consumer to formally see whether two Submodels are providing the same semantic information. +Note 3: in some cases there is neither a semanticId (xref:spec-metamodel/common.adoc#semanticId[Submodel/semanticId]) nor a template ID (xref:spec-metamodel/common.adoc#templateId[Submodel/administration/templateId]) defined for the Submodel. +In this case there is no way for the data consumer to formally see whether two Submodels are providing the same semantic information. ==== ==== From adc8f148842d1ec9b99ce4dce4bb07e8b24ec6c9 Mon Sep 17 00:00:00 2001 From: juileetikekar Date: Mon, 27 Oct 2025 14:21:06 +0100 Subject: [PATCH 45/56] Update README --- README.md | 5 +++-- documentation/IDTA-01001/antora.yml | 2 +- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index e59afca3e..c60dfe052 100644 --- a/README.md +++ b/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 diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml index 6a81d47e7..2d7ac7413 100644 --- a/documentation/IDTA-01001/antora.yml +++ b/documentation/IDTA-01001/antora.yml @@ -1,6 +1,6 @@ name: IDTA-01001 title: 'Part 1: Metamodel' -version: 'v3.1.2 in progress' +version: 'v3.1.2' start_page: ROOT:index.adoc nav: - modules/ROOT/nav.adoc From cd30709d72ab0c09b619c73e9bd624c9cc8fa6ca Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Wed, 26 Nov 2025 18:02:51 +0100 Subject: [PATCH 46/56] add changelog for 3.1.2 and update changelog for 3.2 correspondingly --- .../IDTA-01001/modules/ROOT/pages/changelog.adoc | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index d4f19965a..06019cdd2 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -35,6 +35,22 @@ 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.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]) + +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]) +* Annex UML: add information how to graphically depict attributes of type "Reference" (https://github.com/admin-shell-io/aas-specs-metamodel/issues/601[#601]) +* update bibliography +* editorial changes + + == Changes V3.1.2 vs. V3.1.1 Bugfixes: From c3cd788e002f15f5c5757a922f393f3260fdf002 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Wed, 26 Nov 2025 18:06:53 +0100 Subject: [PATCH 47/56] add "Batch" to enum "AssetKind" --- .../IDTA-01001/modules/ROOT/pages/spec-metamodel/core.adoc | 7 +++++-- .../ROOT/partials/diagrams/classes/enum-asset-kind.puml | 1 + 2 files changed, 6 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/core.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/core.adoc index 47448a702..c5a0e4d28 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/core.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/core.adoc @@ -91,7 +91,7 @@ h|ID: 3+| `\https://admin-shell.io/aas/3/1/AssetInformation` h|Explanation h|Type h|Card. .2+e|[[assetKind]]assetKind 3+| `\https://admin-shell.io/aas/3/1/AssetInformation/assetKind` -a|Denotes whether the asset is of kind "Type", Instance", "Role" or none of these types is applicable |xref:AssetKind[AssetKind]|1 +a|Denotes whether the asset is of kind "Type", Instance", "Batch", "Role" or none of these types is applicable |xref:AssetKind[AssetKind]|1 .2+e|[[globalAssetId]]globalAssetId 3+| `\https://admin-shell.io/aas/3/1/AssetInformation/globalAssetId` a| @@ -171,7 +171,7 @@ The content type states which file extensions the file can have. |=== |Enumeration: e|[[AssetKind]]AssetKind h|Explanation: a|Enumeration for denoting whether an asset is a type asset or -an instance asset or is a role or whether this kind of classification is not applicable +an instance asset or a batch asset or is a role or whether this kind of classification is not applicable h|Set of: |-- h|ID: | `\https://admin-shell.io/aas/3/1/AssetKind` @@ -184,6 +184,9 @@ a|Type asset .2+e|Instance | `\https://admin-shell.io/aas/3/1/AssetKind/Instance` a|Instance asset +.2+e|Batch | `\https://admin-shell.io/aas/3/1/AssetKind/Batch` +a|batch asset + .2+e|Role | `\https://admin-shell.io/aas/3/1/AssetKind/Role` a|Role asset diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/enum-asset-kind.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/enum-asset-kind.puml index a27baef35..90cc7c53d 100644 --- a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/enum-asset-kind.puml +++ b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/enum-asset-kind.puml @@ -2,6 +2,7 @@ enum AssetKind <> { Type Instance + Batch Role NotApplicable } From cd7935eeaa53ec3bbc4f4dad14e58524d8d05ee4 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Wed, 26 Nov 2025 18:14:43 +0100 Subject: [PATCH 48/56] explain Reference notation in UML + split uml-bascis and uml-specific --- .../modules/ROOT/pages/annex/uml.adoc | 28 +++++++++++++------ .../81-composite-aggregation-composition.puml | 0 .../82-shared-aggregation.puml | 0 .../83-generalization-inheritance.puml | 0 .../84-enumeration-with-inheritance.puml | 0 .../85-experimental-classes.puml | 0 .../87-template-class.puml | 0 .../deprecated-attribute.puml | 0 .../deprecated-class.puml | 0 9 files changed, 19 insertions(+), 9 deletions(-) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/81-composite-aggregation-composition.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/82-shared-aggregation.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/83-generalization-inheritance.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/84-enumeration-with-inheritance.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/85-experimental-classes.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/87-template-class.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/deprecated-attribute.puml (100%) rename documentation/IDTA-01001/modules/ROOT/partials/diagrams/{uml-basics => uml-specific}/deprecated-class.puml (100%) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/annex/uml.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/uml.adoc index 00b253a45..297b2c9e4 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/annex/uml.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/annex/uml.adoc @@ -341,17 +341,27 @@ _Class2_ instance only exists if the parent object of type _Class1_ exists. [[image-81-composite-aggregation-composition]] [plantuml, 81-composite-aggregation-composition, svg] .... -include::partial$diagrams/uml-basics/81-composite-aggregation-composition.puml[] +include::partial$diagrams/uml-specific/81-composite-aggregation-composition.puml[] .... - +//// <> shows a representation of a shared aggregation: a _Class2_ instance can exist independently of a _Class1_ instance. It is assumed that only the end member of the aggregation association is navigable per default, i.e. it is possible to navigate from an instance of _Class1_ to the owned instance of _Class2_ but not vice versa. .Graphical Representation of Shared Aggregation [[image-82-shared-aggregation]] [plantuml, 82-shared-aggregation, svg] .... -include::partial$diagrams/uml-basics/82-shared-aggregation.puml[] +include::partial$diagrams/uml-specific/82-shared-aggregation.puml[] +.... +//// + +<> shows a representation of an attribute of type "Reference": _Class1_ has an attribute _attr_ of type _Reference_. Reference handling is specific to the Asset Administration Shell. An attribute of this type references another class within the model via its identifier. Therefore additionally an association between _Class1_ and _Class2_ is added to denote that the referenced object shall be an instance of _Class2_. + +.Graphical Representation of Shared Aggregation +[[image-attribute_with_type_feference]] +[plantuml, attribute_with_type_feference, svg] +.... +include::partial$diagrams/uml-specific/attribute_with_type_Reference.puml[] .... <> show different graphical representations of generalization. @@ -367,7 +377,7 @@ Typically, the inherited elements are not shown. [[image-83-generalization-inheritance]] [plantuml, 83-generalization-inheritance, svg] .... -include::partial$diagrams/uml-basics/83-generalization-inheritance.puml[] +include::partial$diagrams/uml-specific/83-generalization-inheritance.puml[] .... @@ -383,7 +393,7 @@ This can be seen on the right side of <> [[image-84-enumeration-with-inheritance]] [plantuml, 84-enumeration-with-inheritance, svg] .... -include::partial$diagrams/uml-basics/84-enumeration-with-inheritance.puml[] +include::partial$diagrams/uml-specific/84-enumeration-with-inheritance.puml[] .... @@ -397,7 +407,7 @@ Note 2: in this specification all elements of an enumeration are ordered alphabe [[image-85-experimental-classes]] [plantuml, 85-experimental-classes, svg] .... -include::partial$diagrams/uml-basics/85-experimental-classes.puml[] +include::partial$diagrams/uml-specific/85-experimental-classes.puml[] .... @@ -407,14 +417,14 @@ include::partial$diagrams/uml-basics/85-experimental-classes.puml[] [[image-deprecated-class]] [plantuml, deprecated-class, svg] .... -include::partial$diagrams/uml-basics/deprecated-class.puml[] +include::partial$diagrams/uml-specific/deprecated-class.puml[] .... .Graphical Representation for Deprecated Attribute [[image-deprecated-attribute]] [plantuml, deprecated-attribute, svg] .... -include::partial$diagrams/uml-basics/deprecated-attribute.puml[] +include::partial$diagrams/uml-specific/deprecated-attribute.puml[] .... <> shows a class representing a template. @@ -424,5 +434,5 @@ It is marked by the stereotype "Template". [[image-87-template-class]] [plantuml, 87-template-class, svg] .... -include::partial$diagrams/uml-basics/87-template-class.puml[] +include::partial$diagrams/uml-specific/87-template-class.puml[] .... diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/81-composite-aggregation-composition.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/81-composite-aggregation-composition.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/81-composite-aggregation-composition.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/81-composite-aggregation-composition.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/82-shared-aggregation.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/82-shared-aggregation.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/82-shared-aggregation.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/82-shared-aggregation.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/83-generalization-inheritance.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/83-generalization-inheritance.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/83-generalization-inheritance.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/83-generalization-inheritance.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/84-enumeration-with-inheritance.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/84-enumeration-with-inheritance.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/84-enumeration-with-inheritance.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/84-enumeration-with-inheritance.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/85-experimental-classes.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/85-experimental-classes.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/85-experimental-classes.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/85-experimental-classes.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/87-template-class.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/87-template-class.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/87-template-class.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/87-template-class.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/deprecated-attribute.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/deprecated-attribute.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/deprecated-attribute.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/deprecated-attribute.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/deprecated-class.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/deprecated-class.puml similarity index 100% rename from documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-basics/deprecated-class.puml rename to documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/deprecated-class.puml From f7027b15f89aeec21111ab8a2eb7dc6e904d1ff9 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 08:47:25 +0100 Subject: [PATCH 49/56] annex uml: new puml for reference --- .../uml-specific/attribute_with_type_Reference.puml | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/attribute_with_type_Reference.puml diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/attribute_with_type_Reference.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/attribute_with_type_Reference.puml new file mode 100644 index 000000000..18e84b40b --- /dev/null +++ b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/uml-specific/attribute_with_type_Reference.puml @@ -0,0 +1,9 @@ +@startuml + +class Class1 { + +attr: Reference[0..1] +} + +Class1 -->"+attr 0..1" Class2 :Reference + +@enduml \ No newline at end of file From 929d689b6d9dd65a7dbf4d4c7e7663a33931ddca Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 08:52:16 +0100 Subject: [PATCH 50/56] update README w.r.t. versions --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c60dfe052..24172d5a0 100644 --- a/README.md +++ b/README.md @@ -64,13 +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.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, +* 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.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.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 From 743433c14d6a60e23d8267a79fbb045b5eac5ba3 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 08:58:37 +0100 Subject: [PATCH 51/56] update index.adoc: add Part 3b as depependency --- documentation/IDTA-01001/modules/ROOT/pages/index.adoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc index 47395a0af..7d6b97b36 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc @@ -26,8 +26,9 @@ Previous version: 3.1.1 For the schemas derived from this document there is a dependency to the following parts of the “Specification of the Asset Administration Shell” series: * IDTA-01003-a Part 3a: Data Specification – IEC 61360 in version 3.1 xref:bibliography.adoc#bib46[[46\]] +* IDTA-01003-b Part 3b: Data Specification – Measurement Units in version 3.0 xref:bibliography.adoc#bib46[[46\]] -If there is a bugfix of this parts, this shall be used. +If there is a bugfix of these parts, they shall be used. == Notice From 3e3b1eb3b85f84c0463578e67d6b224c779ac786 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 10:13:43 +0100 Subject: [PATCH 52/56] changelog: add tables for createdAt and updatedAt Attributes for AdministrativeInformation --- .../modules/ROOT/pages/changelog.adoc | 39 ++++++++++++++++--- 1 file changed, 33 insertions(+), 6 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc index 43fe42418..545635be6 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/changelog.adoc @@ -36,17 +36,13 @@ They had separate sections and tables documenting the changes. ==== - == 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]) - 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]) @@ -54,6 +50,39 @@ Minor Changes: * update bibliography * editorial changes +=== Metamodel Changes V3.2 vs. V3.1.1 + +.Changes in Metamodel +[cols="5%,42%,48%",options="header",] +|=== +|*Nc* |*V3.2 Change w.r.t. V3.1.1* |*Comment* + +| {empty} | xref:spec-metamodel/core.adoc#AssetKind[AssetKind] a| Add new value "Batch" to enumeration AssetKind + +|=== + +.Changes in Metamodel +[cols="5%,42%,48%",options="header",] +|=== +h|Nc h|V3.2 Change w.r.t. V3.1.1 h|Comment + +| {empty} | a| + +|=== + +.New Elements in Metamodel +[cols="5%,41%,51%",options="header",] +|=== +h|{empty} h|New Elements V3.2 vs V3.1 h|Comment +{empty} | AdministrativeInformation/createdAt | a| TO BE CLARIFIED +{empty} | AdministrativeInformation/updatedAt | a| TO BE CLARIFIED +|=== + +[cols="5%,10%,15%,69%",options="header",] +|=== +h|Nc h|V3.2 vs. V3.1 h|New, Update, Removed, Reformulated h|Comment +| | | a| +|=== == Changes V3.1.2 vs. V3.1.1 @@ -76,7 +105,6 @@ Bugfixes: * CHANGED: preamble, review process as defined in IDTA * editorial fixes - .Changes in Metamodel [cols="5%,42%,48%",options="header",] |=== @@ -115,7 +143,6 @@ Constraint AASd-021: Every qualifiable shall only have one qualifier with the sa 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" From 3020253aee29106e5adedd38916304f82a6a1089 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 12:39:32 +0100 Subject: [PATCH 53/56] add administrativeData with createdAt and updatedAt + reforumlate sentence for qualifiers and IEC CDD --- .../modules/ROOT/pages/spec-metamodel/common.adoc | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc index 9a1888471..2934d963e 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/common.adoc @@ -98,6 +98,12 @@ h|Explanation h|Type h|Card. .2+e|[[creator]]creator 3+| `\https://admin-shell.io/aas/3/1/AdministrativeInformation/creator` a|The subject ID of the subject responsible for making the element |xref:spec-metamodel/referencing.adoc#Reference[Reference] |0..1 +.2+e|[[createdAt]]createdAt 3+| `\https://admin-shell.io/aas/3/1/AdministrativeInformation/createdAt ` +a| date of creation | dateTime |0..1 + +.2+e|[[updatedAt]]updatedAt 3+| `\https://admin-shell.io/aas/3/1/AdministrativeInformation/updatedAt` +a| date of update | dateTime |0..1 + .2+e|[[templateId]]templateId 3+| `\https://admin-shell.io/aas/3/1/AdministrativeInformation/templateId` a| Identifier of the template that guided the creation of the element @@ -450,10 +456,8 @@ include::partial$diagrams/21-qualifier.puml[] Qualifiers may be defined for qualifiable elements. - -There are standardized qualifiers defined in (https://cdd.iec.ch/cdd/iec61360-7/iec61360-7.nsf/TreeFrameset?OpenFrameSet&ongletactif=1)[IEC CDD, IEC61360-7, CAA002]. -and (https://cdd.iec.ch/cdd/iec61987/iec61987.nsf/TreeFrameset?OpenFrameSet&ongletactif=1)[IEC CDD, IEC 61987, ABJ604]. - +There are standardized qualifiers defined in link:https://cdd.iec.ch/cdd/iec61360-7/iec61360-7.nsf/TreeFrameset?OpenFrameSet&ongletactif=1[IEC CDD, IEC61360-7, CAA002] +and link:https://cdd.iec.ch/cdd/iec61987/iec61987.nsf/TreeFrameset?OpenFrameSet&ongletactif=1[IEC CDD, IEC 619897, ABJ604]. A level qualifier defining the level type minimal, maximal, typical, and nominal value is specified in IEC 62569-1. In DIN SPEC 92000, qualifier types like e.g. expression semantics and expression logic are defined. From 58bb143bb24bdc43ad7add261c7b1af1ddce89fc Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 12:43:05 +0100 Subject: [PATCH 54/56] update index.adoc with 3.2 --- .../IDTA-01001/modules/ROOT/pages/index.adoc | 24 +++++++------------ 1 file changed, 8 insertions(+), 16 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc index 3e60beeec..f88ee1e1f 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/index.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/index.adoc @@ -16,45 +16,37 @@ This specification is part of the https://industrialdigitaltwin.org/en/content-h == Version - - +IN PROGRESS This is version 3.2 of the specification IDTA-01001. -Previous version: 3.1.1 - +Previous version: 3.1.2 [#metamodel-versions] == Dependencies For the schemas derived from this document there is a dependency to the following parts of the “Specification of the Asset Administration Shell” series: - * IDTA-01003-a Part 3a: Data Specification – IEC 61360 in version 3.1 xref:bibliography.adoc#bib46[[46\]] * IDTA-01003-b Part 3b: Data Specification – Measurement Units in version 3.0 xref:bibliography.adoc#bib46[[46\]] - If there is a bugfix of these parts, they shall be used. == Notice Copyright: Industrial Digital Twin Association e.V. (IDTA) +IDTA Number: IDTA-01001 +Version: 3.2 -IDTA Document Number: IDTA-01001-3-2 - -DOI: to be added - +DOI: https://doi.org/10.62628/IDTA.01001-3-2 This work is licensed under a https://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 International License]. SPDX-License-Identifier: CC-BY-4.0 - - -**DATE to be added** - +DATE TO BE ADDED == How to Get in Contact @@ -72,9 +64,9 @@ Feedback: === History -This document (version 3.2) is produced by the Work Stream "Specification of the Asset Administration Shell" of the Working Group "Open Technology" of the https://industrialdigitaltwin.org/[Industrial Digital Twin Association (IDTA)]. +This document (version 3.2) was produced by the Work Stream "Specification of the Asset Administration Shell" of the Working Group "Open Technology" of the https://industrialdigitaltwin.org/[Industrial Digital Twin Association (IDTA)]. -This document (version 3.1) was finalized in May 2025 by the Work Stream "Specification of the Asset Administration Shell" of the Working Group "Open Technology" of the https://industrialdigitaltwin.org/[Industrial Digital Twin Association (IDTA)]. +This document (version 3.1) was produced by the Work Stream "Specification of the Asset Administration Shell" of the Working Group "Open Technology" of the https://industrialdigitaltwin.org/[Industrial Digital Twin Association (IDTA)], published in May 2025. It is the first version published as html document and maintained completely open source. Version 3.0, a major release, was finalized from June 2022 to January 2023 by the joint sub working group "Asset Administration Shell" of the working group "Reference Architectures, Standards and Norms" of the Plattform Industrie 4.0 and the working group "Open Technology" of the Industrial Digital Twin Association (IDTA). From 78889e789743668425884bfebe16d8eebf03df14 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 12:50:46 +0100 Subject: [PATCH 55/56] data type ContentType - update description IANA and RFC --- .../modules/ROOT/pages/spec-metamodel/datatypes.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc index 16afab4d6..4c22b04a4 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/datatypes.adoc @@ -94,11 +94,11 @@ for "Hello, World!" a| _string_ with max 128 and min 1 characters +Any content type as specified in link:https://datatracker.ietf.org/doc/html/rfc2046[RFC2046]. + +The content type should be registered by the Internet Assigned Numbers Authority (link:https://www.iana.org/assignments/media-types/media-types.xhtml[IANA]) as specified in link:https://datatracker.ietf.org/doc/html/rfc2048[RFC2048]. -Any content type as specified in [RFC2046](https://datatracker.ietf.org/doc/html/rfc2046). -The content type should be registered by the Internet Assigned Numbers Authority (IANA([link](https://www.iana.org/assignments/media-types/media-types.xhtml))) - as specified in [RFC2048](https://datatracker.ietf.org/doc/html/rfc2048). a| application/pdf From 9e957aa926d730aa0443a9f15914084ca9e0b3e8 Mon Sep 17 00:00:00 2001 From: Birgit Boss Date: Thu, 27 Nov 2025 12:53:55 +0100 Subject: [PATCH 56/56] annex general: add assetType as attribute representing an ID --- documentation/IDTA-01001/antora.yml | 6 +----- .../IDTA-01001/modules/ROOT/pages/annex/general.adoc | 3 ++- .../ROOT/pages/spec-metamodel/submodel-elements.adoc | 4 +++- .../diagrams/classes/administrative-information.puml | 2 ++ schemas/json/README.md | 2 +- schemas/rdf/README.md | 2 +- schemas/xml/README.md | 2 +- 7 files changed, 11 insertions(+), 10 deletions(-) diff --git a/documentation/IDTA-01001/antora.yml b/documentation/IDTA-01001/antora.yml index 547c66a45..2d7ac7413 100644 --- a/documentation/IDTA-01001/antora.yml +++ b/documentation/IDTA-01001/antora.yml @@ -1,10 +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/pages/annex/general.adoc b/documentation/IDTA-01001/modules/ROOT/pages/annex/general.adoc index f75d3a6d5..bbe3640d1 100644 --- 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/spec-metamodel/submodel-elements.adoc b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc index 44c238efb..da033d5dd 100644 --- a/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc +++ b/documentation/IDTA-01001/modules/ROOT/pages/spec-metamodel/submodel-elements.adoc @@ -490,9 +490,11 @@ include::partial$diagrams/37-file.puml[] .... +A media type (also MIME type and content type) is a two-part identifier for file formats and format contents transmitted via the Internet. +The Internet Assigned Numbers Authority (IANA) is the official authority for the standardization and publication of these classifications. ==== -Note: for information on handling supplementary external files in exchanging Asset Administration Shells in AASX Package File Format see also Part 5 of the series link:https://industrialdigitaltwin.org/en/content-hub/aasspecifications["Specification of the Asset Administration Shell"]. +Note: for information on handling supplementary external files in exchanging Asset Administration Shells in AASX package format see also Part 5 of the series link:https://industrialdigitaltwin.org/en/content-hub/aasspecifications["Specification of the Asset Administration Shell"]. An absolute path is used in case the file exists independently of the Asset Administration Shell. A relative path, relative to the package root, should be used if the file is part of a serialized package of the Asset Administration Shell. ==== diff --git a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/administrative-information.puml b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/administrative-information.puml index 37c82f8d3..2f23fd5e5 100644 --- a/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/administrative-information.puml +++ b/documentation/IDTA-01001/modules/ROOT/partials/diagrams/classes/administrative-information.puml @@ -3,6 +3,8 @@ class AdministrativeInformation { +version: VersionType[0..1] +revision: RevisionType[0..1] +creator: Reference[0..1] + +createdAt: dateTime[0..1] + +updatedAt: dateTime[0..1] +templateId: Identifier[0..1] } @enduml \ No newline at end of file diff --git a/schemas/json/README.md b/schemas/json/README.md index 548b131c1..9177bf9c1 100644 --- a/schemas/json/README.md +++ b/schemas/json/README.md @@ -1,3 +1,3 @@ # JSON -Refer to the [json.adoc](../../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/json.adoc) for detailed information. +Refer to the [json.adoc](../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/json.adoc) for detailed information. \ No newline at end of file diff --git a/schemas/rdf/README.md b/schemas/rdf/README.md index dff06fc0d..9162e553a 100644 --- a/schemas/rdf/README.md +++ b/schemas/rdf/README.md @@ -1,3 +1,3 @@ # Resource Description Framework -Refer to the [rdf.adoc](../../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/rdf.adoc) for detailed information. +Refer to the [rdf.adoc](../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/rdf.adoc) for detailed information. \ No newline at end of file diff --git a/schemas/xml/README.md b/schemas/xml/README.md index 63156031d..c8193405e 100644 --- a/schemas/xml/README.md +++ b/schemas/xml/README.md @@ -1,3 +1,3 @@ # XML -Refer to the [xml.adoc](../../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/xml.adoc) for detailed information. +Refer to the [xml.adoc](../documentation/IDTA-01001/modules/ROOT/pages/mappings/formats/xml.adoc) for detailed information.