diff --git a/vocabularies/Common.json b/vocabularies/Common.json index a18f9c76..7c21c782 100644 --- a/vocabularies/Common.json +++ b/vocabularies/Common.json @@ -1352,14 +1352,14 @@ "@Core.Description": "Channel for WebSocket connections", "@Core.LongDescription": "Messages sent over the channel follow the [ABAP Push Channel Protocol](https://community.sap.com/t5/application-development-blog-posts/specification-of-the-push-channel-protocol-pcp/ba-p/13137541).\nTo consume a channel, the client opens a web socket connection at the [`WebSocketBaseURL`](#WebSocketBaseURL)\nfollowed by URL parameters\n- parameter name = annotation qualifier, parameter value = channel ID (see below)\n- parameter name = `relatedService`, parameter value = base URL (relative to server root) of the OData service of the app\n\n
Supported qualifiers and channel IDs:\n
`sideEffects`
Notifications about side effects to be triggered by the client (channel ID = non-null annotation value)\n
" }, - "ChangeViaNavigationPath": { + "AddressViaNavigationPath": { "$Kind": "Term", "$Type": "Core.Tag", "$DefaultValue": true, "$AppliesTo": ["EntityContainer"], "@Common.Experimental": true, - "@Core.Description": "Service prefers change requests to use a resource path with navigation properties", - "@Core.LongDescription": "Use this tag on services that do not restrict update and delete operations to certain resource paths\n via `Capabilities` annotations, but that prefer update and delete operations on a resource path that\n contains the navigation properties reflecting the object composition." + "@Core.Description": "Service prefers requests to use a resource path with navigation properties", + "@Core.LongDescription": "Use this tag on services that do not restrict requests to certain resource paths\n via `Capabilities` annotations, but that prefer requests on a resource path that\n contains the navigation properties reflecting the object composition." } } } diff --git a/vocabularies/Common.md b/vocabularies/Common.md index 6644e9d1..4d4e9f18 100644 --- a/vocabularies/Common.md +++ b/vocabularies/Common.md @@ -113,7 +113,7 @@ Term|Type|Description [PrimitivePropertyPath](Common.xml#L1497) *([Experimental](Common.md#Experimental))*|[Tag](https://github.com/oasis-tcs/odata-vocabularies/blob/main/vocabularies/Org.OData.Core.V1.md#Tag)|A term or term property with this tag whose type is (a collection of) `Edm.PropertyPath` MUST resolve to a primitive structural property [WebSocketBaseURL](Common.xml#L1502) *([Experimental](Common.md#Experimental))*|URL|Base URL for WebSocket connections
This annotation MUST be unqualified. [WebSocketChannel](Common.xml#L1510) *([Experimental](Common.md#Experimental))*|String?|Channel for WebSocket connections

Messages sent over the channel follow the ABAP Push Channel Protocol. To consume a channel, the client opens a web socket connection at the WebSocketBaseURL followed by URL parameters

Supported qualifiers and channel IDs:
`sideEffects`
Notifications about side effects to be triggered by the client (channel ID = non-null annotation value)
-[ChangeViaNavigationPath](Common.xml#L1526) *([Experimental](Common.md#Experimental))*|[Tag](https://github.com/oasis-tcs/odata-vocabularies/blob/main/vocabularies/Org.OData.Core.V1.md#Tag)|Service prefers change requests to use a resource path with navigation properties
Use this tag on services that do not restrict update and delete operations to certain resource paths via `Capabilities` annotations, but that prefer update and delete operations on a resource path that contains the navigation properties reflecting the object composition. +[AddressViaNavigationPath](Common.xml#L1526) *([Experimental](Common.md#Experimental))*|[Tag](https://github.com/oasis-tcs/odata-vocabularies/blob/main/vocabularies/Org.OData.Core.V1.md#Tag)|Service prefers requests to use a resource path with navigation properties
Use this tag on services that do not restrict requests to certain resource paths via `Capabilities` annotations, but that prefer requests on a resource path that contains the navigation properties reflecting the object composition. ## [TextFormatType](Common.xml#L134) diff --git a/vocabularies/Common.xml b/vocabularies/Common.xml index eb6ebbb4..8ee4da48 100644 --- a/vocabularies/Common.xml +++ b/vocabularies/Common.xml @@ -1523,12 +1523,12 @@ followed by URL parameters - + - + - Use this tag on services that do not restrict update and delete operations to certain resource paths - via `Capabilities` annotations, but that prefer update and delete operations on a resource path that + Use this tag on services that do not restrict requests to certain resource paths + via `Capabilities` annotations, but that prefer requests on a resource path that contains the navigation properties reflecting the object composition.