Skip to content

Conversation

HeikoTheissen
Copy link
Contributor

Fixes #298

@HeikoTheissen HeikoTheissen changed the base branch from main to v4.02-release-candidate October 2, 2025 06:47
Comment on lines 117 to 124
Services can specify a different set of restrictions specific to a path given through the
following mechanisms:
- an external annotation target of the form `ns.container/EntitySet/NavProp1/.../NavPropN`
- a navigation property path in `Capabilities.NavigationRestrictions/RestrictedProperties/NavigationProperty`
- a combination of both.

In these cases the more specific restrictions take precedence. It is an error to specify
conflicting restrictions of the same capability through different mechanisms.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reword along the lines of:

Suggested change
Services can specify a different set of restrictions specific to a path given through the
following mechanisms:
- an external annotation target of the form `ns.container/EntitySet/NavProp1/.../NavPropN`
- a navigation property path in `Capabilities.NavigationRestrictions/RestrictedProperties/NavigationProperty`
- a combination of both.
In these cases the more specific restrictions take precedence. It is an error to specify
conflicting restrictions of the same capability through different mechanisms.
Services can specify a different set of restrictions specific to a resource path given through the
following mechanisms:
- an external annotation target of the form `ns.container/EntitySet/NavProp1/.../NavPropN`
- a navigation property path formed by appending the target navigation property to the an element annotated with the NavigationRestrictions term `Capabilities.NavigationRestrictions/RestrictedProperties/NavigationProperty`
- a combination of both.
Restrictions specific to a path take precedence over restrictions applied directly to a containment path. It is an error to specify conflicting restrictions for the same resource path.

Comment on lines +111 to 113
Capabilities annotations targeting a canonical collection (in the
sense of [OData-Protocol, section 10](https://oasis-tcs.github.io/odata-specs/odata-protocol/odata-protocol.html#ContextURL))
apply to every entity in that collection, even if it is addressed via a non-canonical path.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this also apply to Capabilities.NavigationRestrictions on an entity set where RestrictedProperties/NavigationProperty is a containment navigation property? The concatenation of entity set and navigation property is then a canonical path.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Relative precedence of "restrictions specific to a path"

2 participants