From 9f0cb2f14d91be8d9fe9e2956ca2295b9db98b55 Mon Sep 17 00:00:00 2001 From: Sebastian Bader Date: Wed, 19 Mar 2025 18:10:01 +0100 Subject: [PATCH 1/4] extend note for PostAllAssetLinksById --- .../modules/ROOT/pages/specification/interfaces.adoc | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) 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 e033cba5..030b53d1 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1804,6 +1804,7 @@ These interfaces allow to publish information about Asset Administration Shells h|Operation Name h|Description e| xref:GetAllAssetAdministrationShellIdsByAssetLink[GetAllAssetAdministrationShellIdsByAssetLink] |Returns a list of Asset Administration Shell ids based on asset identifier key-value-pairs e| xref:GetAllAssetLinksById[GetAllAssetLinksById] |Returns a list of asset identifier key-value-pairs based on a given Asset Administration Shell id +e| xref:SearchAllAssetAdministrationShellIdsByAssetLink[SearchAllAssetAdministrationShellIdsByAssetLink] |Returns a list of Asset Administration Shell IDs linked to specific asset identifiers or the global asset ID e| xref:PostAllAssetLinksById[PostAllAssetLinksById] |Creates or replaces all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content e| xref:DeleteAllAssetLinksById[DeleteAllAssetLinksById] |Deletes all asset identifier key-value-pair linked to an Asset Administration Shell |=== @@ -1912,8 +1913,10 @@ Asset identifier, which could be the globalAssetId or specificAssetIds. ==== -Note: the name for the globalAssetId is defined in Contraint AASd-116 in IDTA-0001. -It is the predefined name “_globalAssetId_” that would refer to the _AssetInformation/globalAssetId_. +Note: The SpecificAssetId/name “_globalAssetId_” is defined in Contraint AASd-116 in IDTA-0001. +Its value shall be used as the value for the _AssetInformation/globalAssetId_ attribute of the associated AAS. +It shall not be treated as an additional item of _AssetInformation/specificAssetIds_. +Furthermore, a potentially included SpecificAssetId/externalSubjectId attribute shall be ignored, if and only if the SpecificAssetId/name is equal to “_globalAssetId_”. ==== From 59432dc12993e1029c170acb48a6cdc2730e068e Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Fri, 21 Mar 2025 16:59:26 +0100 Subject: [PATCH 2/4] 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 | 3 ++- 1 file changed, 2 insertions(+), 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 030b53d1..5a54d52c 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1916,7 +1916,8 @@ Asset identifier, which could be the globalAssetId or specificAssetIds. Note: The SpecificAssetId/name “_globalAssetId_” is defined in Contraint AASd-116 in IDTA-0001. Its value shall be used as the value for the _AssetInformation/globalAssetId_ attribute of the associated AAS. It shall not be treated as an additional item of _AssetInformation/specificAssetIds_. -Furthermore, a potentially included SpecificAssetId/externalSubjectId attribute shall be ignored, if and only if the SpecificAssetId/name is equal to “_globalAssetId_”. +Furthermore, a potentially included SpecificAssetId/externalSubjectId attribute for a specific asset ID with name "globalAssetId" shall be considered an invalid specific asset ID. +Potentially included semanticId or supplementalSemanticIds are ignored. ==== From 7741ba96c5cc3f5d39348e9bc3141a89f513f599 Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Fri, 21 Mar 2025 16:59:39 +0100 Subject: [PATCH 3/4] 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 5a54d52c..fd5f8da2 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1913,7 +1913,7 @@ Asset identifier, which could be the globalAssetId or specificAssetIds. ==== -Note: The SpecificAssetId/name “_globalAssetId_” is defined in Contraint AASd-116 in IDTA-0001. +Note: “_globalAssetId_” is a predefined name (see Constraint AASd-116 in IDTA-0001). Its value shall be used as the value for the _AssetInformation/globalAssetId_ attribute of the associated AAS. It shall not be treated as an additional item of _AssetInformation/specificAssetIds_. Furthermore, a potentially included SpecificAssetId/externalSubjectId attribute for a specific asset ID with name "globalAssetId" shall be considered an invalid specific asset ID. From 77c3c8227852125b8af9ac7998df24a66932dea1 Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Fri, 21 Mar 2025 17:00:00 +0100 Subject: [PATCH 4/4] 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 fd5f8da2..f6cd2665 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1914,7 +1914,7 @@ Asset identifier, which could be the globalAssetId or specificAssetIds. ==== Note: “_globalAssetId_” is a predefined name (see Constraint AASd-116 in IDTA-0001). -Its value shall be used as the value for the _AssetInformation/globalAssetId_ attribute of the associated AAS. +If a specific asset ID uses this predefined name "_globalAssetId_" then its value shall be used as the value for the _AssetInformation/globalAssetId_ attribute of the associated AAS. It shall not be treated as an additional item of _AssetInformation/specificAssetIds_. Furthermore, a potentially included SpecificAssetId/externalSubjectId attribute for a specific asset ID with name "globalAssetId" shall be considered an invalid specific asset ID. Potentially included semanticId or supplementalSemanticIds are ignored.