From 3b8ce75ac143c36b7ad1ba2bacf671781003d379 Mon Sep 17 00:00:00 2001 From: Sebastian Bader Date: Fri, 28 Nov 2025 18:06:51 +0100 Subject: [PATCH 1/2] add note for the operation GenerateSerializationByIds --- .../modules/ROOT/pages/changelog.adoc | 24 +++++++++++++++++++ .../ROOT/pages/specification/interfaces.adoc | 7 +++++- 2 files changed, 30 insertions(+), 1 deletion(-) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index c1bc7480..cec9ec8d 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,6 +9,30 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they have an impact on the payload of many operations. ==== +== Changes w.r.t. V3.1.1 to V3.2 + +Major Changes: + +* ... + + +Minor Changes: + +* ... + + + +=== Operation Changes w.r.t. V3.1.1 to V3.2 + +[%autowidth,width="100%",cols="40%,15%,45%",options="header",] +|=== +h|Operation h|Kind of Change h|Comment + + | GenerateSerializationByIds|change a| Added a note to clarify the intended behavior for transitively referenced concept descriptions. (https://github.com/admin-shell-io/aas-specs-api/issues/510[#510]) + +|=== + + == Changes w.r.t. V3.1 to V3.1.1 Major Changes: diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc index 8ca6b186..d81fba0c 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -654,7 +654,12 @@ h|Name h|Description h|Mand. h|Type h|Card. 5+h|Input Parameter |aasIds |The unique ids of the Asset Administration Shells to be contained in the serialization |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..* |submodelIds |The unique ids of the Submodels to be contained in the serialization |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..* -|includeConceptDescriptions a|Include all concept descriptions that are referenced in the Submodels contained in the serialization and that are known to the server |no |boolean |1 +|includeConceptDescriptions a|Include all concept descriptions that are referenced in the Submodels contained in the serialization and that are known to the server +==== +Note: This shall also include the concept descriptions that are indirectly referenced by a Submodel, e.g., via the `valueList` attribute from a data specification template. +==== + +|no |boolean |1 |serializationFormat |Denotes in which serialization format the requested content shall be delivered |no |xref:specification/interfaces.adoc#SerializationFormat[SerializationFormat] |1 5+h|Output Parameter |statusCode |Status code |yes |xref:specification/interfaces-payload.adoc#StatusCode[StatusCode] |1 From a6e6f146dbc5667afae41b8c24046ba57b119c83 Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Thu, 4 Dec 2025 08:26:18 +0100 Subject: [PATCH 2/2] Update documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc Co-authored-by: Birgit Boss <59824205+BirgitBoss@users.noreply.github.com> --- .../modules/ROOT/pages/specification/interfaces.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc index d81fba0c..db65bb62 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -656,7 +656,7 @@ h|Name h|Description h|Mand. h|Type h|Card. |submodelIds |The unique ids of the Submodels to be contained in the serialization |no |link:https://industrialdigitaltwin.io/aas-specifications/IDTA-01001/v3.1/spec-metamodel/datatypes.html#Identifier[Identifier] |1..* |includeConceptDescriptions a|Include all concept descriptions that are referenced in the Submodels contained in the serialization and that are known to the server ==== -Note: This shall also include the concept descriptions that are indirectly referenced by a Submodel, e.g., via the `valueList` attribute from a data specification template. +Note: This shall also include the concept descriptions that are indirectly referenced by a Submodel, e.g., via the `valueList` attribute from the IEC 63260 data specification template. ==== |no |boolean |1