diff --git a/vocabularies/Org.OData.Capabilities.V1.json b/vocabularies/Org.OData.Capabilities.V1.json index c92909c5..501c149c 100644 --- a/vocabularies/Org.OData.Capabilities.V1.json +++ b/vocabularies/Org.OData.Capabilities.V1.json @@ -748,7 +748,8 @@ "UnsupportedExpressions": { "$Type": "Capabilities.SearchExpressions", "$DefaultValue": "none", - "@Core.Description": "Expressions not supported in $search" + "@Core.Description": "Expressions not supported in $search as specified by the standard syntax [OData-URL, section 5.1.8.1](https://docs.oasis-open.org/odata/odata/v4.02/odata-v4.02-part2-url-conventions.html#SearchExpressions)", + "@Core.LongDescription": "An unsupported expression may be treated as a term to be matched even if the\n standard syntax treats it as a keyword." }, "SearchSyntax": { "$Nullable": true, diff --git a/vocabularies/Org.OData.Capabilities.V1.md b/vocabularies/Org.OData.Capabilities.V1.md index 0d64d45c..d815641b 100644 --- a/vocabularies/Org.OData.Capabilities.V1.md +++ b/vocabularies/Org.OData.Capabilities.V1.md @@ -71,22 +71,22 @@ Term|Type|Description [SortRestrictions](./Org.OData.Capabilities.V1.xml#L506:~:text=Restrictions on orderby expressions [ExpandRestrictions](./Org.OData.Capabilities.V1.xml#L532:~:text=Restrictions on expand expressions [SearchRestrictions](./Org.OData.Capabilities.V1.xml#L562:~:text=Restrictions on search expressions -[KeyAsSegmentSupported](./Org.OData.Capabilities.V1.xml#L604:~:text=Supports [key-as-segment convention](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_KeyasSegmentConvention) for addressing entities within a collection -[QuerySegmentSupported](./Org.OData.Capabilities.V1.xml#L608:~:text=Supports [passing query options in the request body](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_PassingQueryOptionsintheRequestBody) -[InsertRestrictions](./Org.OData.Capabilities.V1.xml#L614:~:text=Restrictions on insert operations -[DeepInsertSupport](./Org.OData.Capabilities.V1.xml#L693:~:text=Deep Insert Support of the annotated resource (the whole service, an entity set, or a collection-valued resource) -[UpdateRestrictions](./Org.OData.Capabilities.V1.xml#L706:~:text=Restrictions on update operations -[DeepUpdateSupport](./Org.OData.Capabilities.V1.xml#L792:~:text=Deep Update Support of the annotated resource (the whole service, an entity set, or a collection-valued resource) -[DeleteRestrictions](./Org.OData.Capabilities.V1.xml#L805:~:text=Restrictions on delete operations -[CollectionPropertyRestrictions](./Org.OData.Capabilities.V1.xml#L849:~:text=Describes restrictions on operations applied to collection-valued structural properties -[OperationRestrictions](./Org.OData.Capabilities.V1.xml#L890:~:text=Restrictions for function or action operation -[AnnotationValuesInQuerySupported](./Org.OData.Capabilities.V1.xml#L910:~:text=Supports annotation values within system query options -[ModificationQueryOptions](./Org.OData.Capabilities.V1.xml#L914:~:text=Support for query options with modification requests (insert, update, action invocation) -[ReadRestrictions](./Org.OData.Capabilities.V1.xml#L938:~:text=Restrictions for retrieving a collection of entities, retrieving a singleton instance. -[CustomHeaders](./Org.OData.Capabilities.V1.xml#L980:~:text=Custom headers that are supported/required for the annotated resource ([Example](./Org.OData.Capabilities.V1.xml#L982)) -[CustomQueryOptions](./Org.OData.Capabilities.V1.xml#L1006:~:text=Custom query options that are supported/required for the annotated resource ([Example](./Org.OData.Capabilities.V1.xml#L1009))
If the entity container is annotated, the query option is supported/required by all resources in that container. -[MediaLocationUpdateSupported](./Org.OData.Capabilities.V1.xml#L1058:~:text=Stream property or media stream supports update of its media edit URL and/or media read URL -[DefaultCapabilities](./Org.OData.Capabilities.V1.xml#L1063:~:text=Default capability settings for all collection-valued resources in the container

Annotating a specific capability term, which is included as property in DefaultCapabilitiesType, for a specific collection-valued resource overrides the default capability with the specified properties using PATCH semantics:

  • Primitive or collection-valued properties specified in the specific capability term replace the corresponding properties specified in DefaultCapabilities
  • Complex-valued properties specified in the specific capability term override the corresponding properties specified in DefaultCapabilities using PATCH semantics recursively
  • Properties specified neither in the specific term nor in DefaultCapabilities have their default value
+[KeyAsSegmentSupported](./Org.OData.Capabilities.V1.xml#L608:~:text=Supports [key-as-segment convention](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_KeyasSegmentConvention) for addressing entities within a collection +[QuerySegmentSupported](./Org.OData.Capabilities.V1.xml#L612:~:text=Supports [passing query options in the request body](http://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_PassingQueryOptionsintheRequestBody) +[InsertRestrictions](./Org.OData.Capabilities.V1.xml#L618:~:text=Restrictions on insert operations +[DeepInsertSupport](./Org.OData.Capabilities.V1.xml#L697:~:text=Deep Insert Support of the annotated resource (the whole service, an entity set, or a collection-valued resource) +[UpdateRestrictions](./Org.OData.Capabilities.V1.xml#L710:~:text=Restrictions on update operations +[DeepUpdateSupport](./Org.OData.Capabilities.V1.xml#L796:~:text=Deep Update Support of the annotated resource (the whole service, an entity set, or a collection-valued resource) +[DeleteRestrictions](./Org.OData.Capabilities.V1.xml#L809:~:text=Restrictions on delete operations +[CollectionPropertyRestrictions](./Org.OData.Capabilities.V1.xml#L853:~:text=Describes restrictions on operations applied to collection-valued structural properties +[OperationRestrictions](./Org.OData.Capabilities.V1.xml#L894:~:text=Restrictions for function or action operation +[AnnotationValuesInQuerySupported](./Org.OData.Capabilities.V1.xml#L914:~:text=Supports annotation values within system query options +[ModificationQueryOptions](./Org.OData.Capabilities.V1.xml#L918:~:text=Support for query options with modification requests (insert, update, action invocation) +[ReadRestrictions](./Org.OData.Capabilities.V1.xml#L942:~:text=Restrictions for retrieving a collection of entities, retrieving a singleton instance. +[CustomHeaders](./Org.OData.Capabilities.V1.xml#L984:~:text=Custom headers that are supported/required for the annotated resource ([Example](./Org.OData.Capabilities.V1.xml#L986)) +[CustomQueryOptions](./Org.OData.Capabilities.V1.xml#L1010:~:text=Custom query options that are supported/required for the annotated resource ([Example](./Org.OData.Capabilities.V1.xml#L1013))
If the entity container is annotated, the query option is supported/required by all resources in that container. +[MediaLocationUpdateSupported](./Org.OData.Capabilities.V1.xml#L1062:~:text=Stream property or media stream supports update of its media edit URL and/or media read URL +[DefaultCapabilities](./Org.OData.Capabilities.V1.xml#L1067:~:text=Default capability settings for all collection-valued resources in the container

Annotating a specific capability term, which is included as property in DefaultCapabilitiesType, for a specific collection-valued resource overrides the default capability with the specified properties using PATCH semantics:

  • Primitive or collection-valued properties specified in the specific capability term replace the corresponding properties specified in DefaultCapabilities
  • Complex-valued properties specified in the specific capability term override the corresponding properties specified in DefaultCapabilities using PATCH semantics recursively
  • Properties specified neither in the specific term nor in DefaultCapabilities have their default value
## [ConformanceLevelType](./Org.OData.Capabilities.V1.xml#L118:~:text=An unsupported expression may be treated as a term to be matched even if the standard syntax treats it as a keyword. +[SearchSyntax](./Org.OData.Capabilities.V1.xml#L582:~:text= -## [SearchExpressions](./Org.OData.Capabilities.V1.xml#L583:~:text= -## [InsertRestrictionsBase](./Org.OData.Capabilities.V1.xml#L618:~:text= -## [InsertRestrictionsType](./Org.OData.Capabilities.V1.xml#L649:~:text= -## [PermissionType](./Org.OData.Capabilities.V1.xml#L664:~:text= -## [ScopeType](./Org.OData.Capabilities.V1.xml#L673:~:text=Possible string value identifiers when specifying properties are `*`, _PropertyName_, `-`_PropertyName_.
`*` denotes all properties are accessible.
`-`_PropertyName_ excludes that specific property.
_PropertyName_ explicitly provides access to the specific property.
The absence of `RestrictedProperties` denotes all properties are accessible using that scope. +[Scope](./Org.OData.Capabilities.V1.xml#L678:~:text=Possible string value identifiers when specifying properties are `*`, _PropertyName_, `-`_PropertyName_.
`*` denotes all properties are accessible.
`-`_PropertyName_ excludes that specific property.
_PropertyName_ explicitly provides access to the specific property.
The absence of `RestrictedProperties` denotes all properties are accessible using that scope. -## [DeepInsertSupportType](./Org.OData.Capabilities.V1.xml#L697:~:text= -## [UpdateRestrictionsBase](./Org.OData.Capabilities.V1.xml#L710:~:text= -## [UpdateRestrictionsType](./Org.OData.Capabilities.V1.xml#L756:~:text= -## [HttpMethod](./Org.OData.Capabilities.V1.xml#L768:~:text= -## [DeepUpdateSupportType](./Org.OData.Capabilities.V1.xml#L796:~:text= -## [DeleteRestrictionsBase](./Org.OData.Capabilities.V1.xml#L809:~:text= -## [DeleteRestrictionsType](./Org.OData.Capabilities.V1.xml#L843:~:text= -## [CollectionPropertyRestrictionsType](./Org.OData.Capabilities.V1.xml#L852:~:text=If not specified, null, or empty, all functions and operators may be attempted. -[FilterRestrictions](./Org.OData.Capabilities.V1.xml#L860:~:text=If additionally annotated with [Core.PositionalInsert](Org.OData.Core.V1.md#PositionalInsert), members can be inserted at a specific position -[Updatable](./Org.OData.Capabilities.V1.xml#L882:~:text=If not specified, null, or empty, all functions and operators may be attempted. +[FilterRestrictions](./Org.OData.Capabilities.V1.xml#L864:~:text=If additionally annotated with [Core.PositionalInsert](Org.OData.Core.V1.md#PositionalInsert), members can be inserted at a specific position +[Updatable](./Org.OData.Capabilities.V1.xml#L886:~:text= -## [OperationRestrictionsType](./Org.OData.Capabilities.V1.xml#L893:~:text= -## [ModificationQueryOptionsType](./Org.OData.Capabilities.V1.xml#L917:~:text= -## [*ReadRestrictionsBase*](./Org.OData.Capabilities.V1.xml#L942:~:text= -## [ReadByKeyRestrictionsType](./Org.OData.Capabilities.V1.xml#L967:~:text= -## [ReadRestrictionsType](./Org.OData.Capabilities.V1.xml#L970:~:text=Only valid when applied to a collection. If a property of `ReadByKeyRestrictions` is not specified, the corresponding property value of `ReadRestrictions` applies. +[*Readable*](./Org.OData.Capabilities.V1.xml#L947:~:text=Only valid when applied to a collection. If a property of `ReadByKeyRestrictions` is not specified, the corresponding property value of `ReadRestrictions` applies. -## [CustomParameter](./Org.OData.Capabilities.V1.xml#L1037:~:text= -## [DefaultCapabilitiesType](./Org.OData.Capabilities.V1.xml#L1072:~:text= -## [HttpResponse](./Org.OData.Capabilities.V1.xml#L1123:~:text= - + + + An unsupported expression may be treated as a term to be matched even if the + standard syntax treats it as a keyword. +