From 7e764a525232d11bd953fa459066258ac225b3e8 Mon Sep 17 00:00:00 2001 From: Sebastian Bader Date: Fri, 11 Jul 2025 14:33:53 +0200 Subject: [PATCH 1/4] replace explanation in the PostAllAssetLinksByID detail table --- .../IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 12 ++++++++++++ .../modules/ROOT/pages/specification/interfaces.adoc | 3 +-- 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index 1686c5a2..cda39956 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -20,6 +20,18 @@ Minor Changes: * changed: Removed second regex pattern from Blob/contentType, File/contentType, File/value, Referable/idShort, Resource/path, and Resource/contentType attributes in the Part1-MetaModel-Schemas OpenAPI file. The first regex pattern is sufficient to cover all valid content types. While this is not directly fixing a bug, many downstream tools report issues, e.g. during code generation, when two regex patterns are defined for the same attribute. (https://github.com/admin-shell-io/aas-specs-api/issues/481[#481]) + +=== Operation Changes w.r.t. V3.0.4 to V3.1 + +[%autowidth,width="100%",cols="40%,15%,45%",options="header",] +|=== +h|Operation h|Kind of Change h|Comment + + | PostAllAssetLinksByID|change a| Corrected description of PostAllAssetLinksById operation to clarify that it creates or replaces all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content. + +|=== + + == Changes w.r.t. V3.0.4 to V3.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 9d47ede8..7515dbc4 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1901,8 +1901,7 @@ It is the predefined key “_globalAssetId_” that would refer to the _AssetInf |=== h|Operation Name 4+e|[[PostAllAssetLinksById]]PostAllAssetLinksById h|Explanation 4+a| -Creates new asset identifier key-value-pairs linked to an Asset Administration Shell for discoverable content. -The existing content might have to be deleted first. +Creates or replaces all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content. h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAllAssetLinksById/3/1` h|Name h|Description h|Mand. h|Type h|Card. From 4a20eceb51374396160d55c9b7b1c76a14827305 Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Mon, 14 Jul 2025 18:10:00 +0200 Subject: [PATCH 2/4] correct copy-paste error in subsection title --- documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 2 +- 1 file changed, 1 insertion(+), 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 cda39956..ca5b1da8 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -21,7 +21,7 @@ Minor Changes: -=== Operation Changes w.r.t. V3.0.4 to V3.1 +=== Operation Changes w.r.t. V3.1 to V3.1.1 [%autowidth,width="100%",cols="40%,15%,45%",options="header",] |=== From 92ad8f26441233a5a7d9db86aa307db6909d5bcc Mon Sep 17 00:00:00 2001 From: sebbader-sap <107036549+sebbader-sap@users.noreply.github.com> Date: Mon, 14 Jul 2025 18:13:31 +0200 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 7515dbc4..b77a48b6 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1901,7 +1901,7 @@ It is the predefined key “_globalAssetId_” that would refer to the _AssetInf |=== h|Operation Name 4+e|[[PostAllAssetLinksById]]PostAllAssetLinksById h|Explanation 4+a| -Creates or replaces all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content. +Creates or replaces all asset links associated to the Asset Administration Shell. h|semanticId 4+|`\https://admin-shell.io/aas/API/PostAllAssetLinksById/3/1` h|Name h|Description h|Mand. h|Type h|Card. From f97a785a1b290fa52f6cfc2aa3590f2cda933f40 Mon Sep 17 00:00:00 2001 From: Sebastian Bader Date: Mon, 14 Jul 2025 18:16:03 +0200 Subject: [PATCH 4/4] fix PostAllAssetLinksById explanation --- DiscoveryServiceSpecification/V3.1_SSP-001.yaml | 2 +- Entire-API-Collection/V3.1.yaml | 2 +- documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 2 +- .../modules/ROOT/pages/specification/interfaces.adoc | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml index dc069f7d..f633d867 100644 --- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml +++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml @@ -111,7 +111,7 @@ paths: post: tags: - Asset Administration Shell Basic Discovery API - summary: Creates specific asset identifiers linked to an Asset Administration Shell to edit discoverable content + summary: Creates or replaces all asset links associated to the Asset Administration Shell. operationId: PostAllAssetLinksById x-semanticIds: - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0 diff --git a/Entire-API-Collection/V3.1.yaml b/Entire-API-Collection/V3.1.yaml index be5718fa..956d0d12 100644 --- a/Entire-API-Collection/V3.1.yaml +++ b/Entire-API-Collection/V3.1.yaml @@ -7281,7 +7281,7 @@ paths: post: tags: - Asset Administration Shell Basic Discovery API - summary: Creates specific asset identifiers linked to an Asset Administration Shell to edit discoverable content + summary: Creates or replaces all asset links associated to the Asset Administration Shell. operationId: PostAllAssetLinksById x-semanticIds: - https://admin-shell.io/aas/API/PostAllAssetLinksById/3/0 diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index ca5b1da8..5eb73e05 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -27,7 +27,7 @@ Minor Changes: |=== h|Operation h|Kind of Change h|Comment - | PostAllAssetLinksByID|change a| Corrected description of PostAllAssetLinksById operation to clarify that it creates or replaces all asset identifier key-value-pairs linked to an Asset Administration Shell to edit discoverable content. + | PostAllAssetLinksByID|change a| Corrected description of PostAllAssetLinksById operation to clarify that it creates or replaces all asset links associated to the Asset Administration Shell to edit discoverable content. |=== 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 b77a48b6..dc7da607 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc @@ -1805,7 +1805,7 @@ 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:PostAllAssetLinksById[PostAllAssetLinksById] |Creates or replaces all asset links associated to the Asset Administration Shell. e| xref:DeleteAllAssetLinksById[DeleteAllAssetLinksById] |Deletes all asset identifier key-value-pair linked to an Asset Administration Shell |===