Skip to content

Commit

Permalink
mention RequiresExplicitBinding
Browse files Browse the repository at this point in the history
  • Loading branch information
HeikoTheissen committed Feb 13, 2025
1 parent 490c3e7 commit 2233a2d
Show file tree
Hide file tree
Showing 3 changed files with 5 additions and 3 deletions.
2 changes: 1 addition & 1 deletion vocabularies/Common.json
Original file line number Diff line number Diff line change
Expand Up @@ -1359,7 +1359,7 @@
"$AppliesTo": ["EntityContainer"],
"@Common.Experimental": true,
"@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."
"@Core.LongDescription": "Use this tag on services that do not restrict requests to certain resource paths\n via [`Capabilities`]((https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Capabilities.V1.html)\n or [`Core.RequiresExplicitBinding`](https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Core.V1.html#RequiresExplicitBinding)\n annotations, but that prefer requests on a resource path that\n contains the navigation properties reflecting the object composition."
}
}
}
2 changes: 1 addition & 1 deletion vocabularies/Common.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 name="PrimitivePropertyPath"></a>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|<a name="WebSocketBaseURL"></a>Base URL for WebSocket connections<br>This annotation MUST be unqualified.
[WebSocketChannel](Common.xml#L1510) *([Experimental](Common.md#Experimental))*|String?|<a name="WebSocketChannel"></a>Channel for WebSocket connections<br><p>Messages sent over the channel follow the <a href="https://community.sap.com/t5/application-development-blog-posts/specification-of-the-push-channel-protocol-pcp/ba-p/13137541">ABAP Push Channel Protocol</a>. To consume a channel, the client opens a web socket connection at the <a href="#WebSocketBaseURL"><code>WebSocketBaseURL</code></a> followed by URL parameters</p> <ul> <li>parameter name = annotation qualifier, parameter value = channel ID (see below)</li> <li>parameter name = <code>relatedService</code>, parameter value = base URL (relative to server root) of the OData service of the app</li> </ul> <dl>Supported qualifiers and channel IDs: <dt>`sideEffects` <dd>Notifications about side effects to be triggered by the client (channel ID = non-null annotation value) </dl>
[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)|<a name="AddressViaNavigationPath"></a>Service prefers requests to use a resource path with navigation properties<br>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.
[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)|<a name="AddressViaNavigationPath"></a>Service prefers requests to use a resource path with navigation properties<br>Use this tag on services that do not restrict requests to certain resource paths via [`Capabilities`]((https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Capabilities.V1.html) or [`Core.RequiresExplicitBinding`](https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Core.V1.html#RequiresExplicitBinding) annotations, but that prefer requests on a resource path that contains the navigation properties reflecting the object composition.

<a name="TextFormatType"></a>
## [TextFormatType](Common.xml#L134)
Expand Down
4 changes: 3 additions & 1 deletion vocabularies/Common.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1528,7 +1528,9 @@ followed by URL parameters
<Annotation Term="Core.Description" String="Service prefers requests to use a resource path with navigation properties" />
<Annotation Term="Core.LongDescription">
<String>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
via [`Capabilities`]((https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Capabilities.V1.html)
or [`Core.RequiresExplicitBinding`](https://oasis-tcs.github.io/odata-vocabularies/vocabularies/Org.OData.Core.V1.html#RequiresExplicitBinding)
annotations, but that prefer requests on a resource path that
contains the navigation properties reflecting the object composition.</String>
</Annotation>
</Term>
Expand Down

0 comments on commit 2233a2d

Please sign in to comment.