Merge pull request #607 from admin-shell-io/BiBo/Value-Only#599

Value-Only there are idShort for elements in SML

Author: BirgitBoss

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

@@ -16,17 +16,18 @@ This specification is part of the https://industrialdigitaltwin.org/en/content-h
 
 == Version
 
-This is version 3.1 of the specification IDTA-01001.
+This is version 3.1.1 of the specification IDTA-01001.
 
-Previous version: 3.0.2
+Previous version: 3.1
 
 [#metamodel-versions]
 == Dependencies
 
-For the schemas derived from this document (version 3.1) there is a dependency to the following parts of the “Specification of the Asset Administration Shell” series:
+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\]]
 
+If there is a bugfix of this parts, this shall be used.
 
 == Notice
 
@@ -41,7 +42,7 @@ https://creativecommons.org/licenses/by/4.0/[Creative Commons Attribution 4.0 In
 
 SPDX-License-Identifier: CC-BY-4.0
 
-May 2025
+July 2025
 
 == How to Get in Contact
 

documentation/IDTA-01001/modules/ROOT/pages/mappings/encodings/valueonly.adoc

@@ -342,12 +342,15 @@ The protected elements shall not be serialized.
 
 In the following examples for Value-Only serializations for all submodel element types are given.
 
+===== Property
+
 For a single _Property_ named "MaxRotationSpeed", the value-Only payload is minimized to the following (assuming its value is 5000):
 
 [source,json,linenums]
 ----
   5000
 ----
+===== SubmodelElementCollection
 
 For a _SubmodelElementCollection_ named "ProductClassification" or being part of a list "ProductionClassifications", the Value-Only payload is minimized to the following, i.e. the name of the SubmodelElementCollection or its index in the list is not part of the Value-Only serialization:
 
@@ -360,7 +363,9 @@ For a _SubmodelElementCollection_ named "ProductClassification" or being part of
 }
 ----
 
-For a _SubmodelElementList_ named "Authors" with string Properties as its value, the Value-Only payload is minimized to the following (values within a SubmodelElementList do not have idShort values)footnote:[The Value-Only serialization of the product classification example can be seen above]:
+===== SubmodelElementList
+
+For a _SubmodelElementList_ named "Authors" with string Properties as its value, the Value-Only payload is minimized to the following (idShort of values within a SubmodelElementList are ignored):footnote:[The Value-Only serialization of the product classification example can be seen above]:
 
 [source,json,linenums]
 ----
@@ -371,6 +376,8 @@ For a _SubmodelElementList_ named "Authors" with string Properties as its value,
 ]
 ----
 
+===== MultiLanguageProperty
+
 For a _MultiLanguageProperty_ the Value-Only payload is minimized to the following:
 
 [source,json,linenums]
@@ -381,6 +388,7 @@ For a _MultiLanguageProperty_ the Value-Only payload is minimized to the followi
 ]
 
 ----
+===== Range
 
 For a _Range_ named "TorqueRange", the Value-Only payload is minimized to the following:
 
@@ -392,6 +400,8 @@ For a _Range_ named "TorqueRange", the Value-Only payload is minimized to the fo
 }
 ----
 
+===== ReferenceElement
+
 For a _ReferenceElement_ named "MaxRotationSpeedReference", the Value-Only payload is minimized to the following:
 
 [source,json,linenums]
@@ -407,6 +417,8 @@ For a _ReferenceElement_ named "MaxRotationSpeedReference", the Value-Only paylo
 }
 ----
 
+===== File
+
 For a _File_ named "Document", the Value-Only payload is minimized to the following:
 
 [source,json,linenums]
@@ -415,7 +427,9 @@ For a _File_ named "Document", the Value-Only payload is minimized to the follow
     "contentType": "application/pdf",
     "value": "SafetyInstructions.pdf"
 }
+
 ----
+===== Blob
 
 For a _Blob_ named "Library", there are two possibilities for the Value-Only payload.
 In case the Blob value - that can be very large - shall not be part of the payload, the payload is minimized to the followingfootnote:[
@@ -438,6 +452,8 @@ In the second case the Blob value is part of the payload.footnote:[in this case
 }
 ----
 
+===== RelationshipElement
+
 For a _RelationshipElement_ named "CurrentFlowsFrom", the Value-Only payload is minimized to the following:
 
 [source,json,linenums]
@@ -472,6 +488,8 @@ For a _RelationshipElement_ named "CurrentFlowsFrom", the Value-Only payload is
 }
 ----
 
+===== AnnotatedRelationshipElement
+
 For an _AnnotatedRelationshipElement_ named "CurrentFlowFrom", with an annotated _Property_-DataElement "AppliedRule", the Value-Only-payload is minimized to the following:
 
 [source,json,linenums]
@@ -511,6 +529,8 @@ For an _AnnotatedRelationshipElement_ named "CurrentFlowFrom", with an annotated
 }
 ----
 
+===== Entity
+
 For an _Entity_ named "MySubAssetEntity", the Value-Only-payload is minimized to the following:
 
 [source,json,linenums]
@@ -532,6 +552,8 @@ For an _Entity_ named "MySubAssetEntity", the Value-Only-payload is minimized to
 }
 ----
 
+===== BasicEventElement
+
 For a BasicEventElement named "MyBasicEvent", the Value-Only-payload is minimized to the following:
 
 [source,json,linenums]