Adding Capability Annotations with the OData Model Builder
Applies To:# OData WebApi v7 for aspnet webapi supported
OData AspNet WebApi V7# OData Webapi for Webapi supported
OData AspNet WebApi V6
The model builder now allows you to configure the capabilities of a service. Please follow the link for more information on capabilities vocabulary.
It is available on the Nuget gallery
You can install or update the NuGet package for OData Migration Extensions v1.0.0 using the Package Manager Console:
PM> Install-Package Microsoft.OData.ModelBuilder
Examples
Find below some sample usage...
Unless otherwise specified, examples will be based on the model below.
public class Customer
{
public int CustomerId { get; set; }
public string Name { get; set; }
}
var builder = new ODataConventionModelBuilder();
var customerConfiguration = builder.EntitySet<Customer>("Customers");
which produces the $metadata below
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
</Schema>
CountRestrictions
Restrictions on /$count path suffix and $count=true system query option
_ = customerConfiguration.HasCountRestrictions().IsCountable(false);
$metadata
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
<Annotations Target="Default.Container/Customers">
<Annotation Term="Org.OData.Capabilities.V1.CountRestrictions">
<Record>
<PropertyValue Property="Countable" Bool="false" />
</Record>
</Annotation>
</Annotations>
</Schema>
SelectSupport
Support for $select and nested query options within $select
_ = customerConfiguration.HasSelectSupport()
.IsSupported(true) // Supports $select
.IsInstanceAnnotationsSupported(false) // Does *not* support instance annotations in $select list
.IsExpandable(false) // $expand within $select is *not* supported
.IsFilterable(true) // $filter within $select is supported
.IsSearchable(false) // $search within $select is *not* supported
.IsTopSupported(true) // $top within $select is supported
.IsSkipSupported(false) // $skip within $select is *not* supported
.IsComputeSupported(false) // $compute within $select is *not* supported
.IsCountable(true) // $count within $select is supported
.IsSortable(false); // $orderby within $select is *not* supported
$metadata
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
<Annotations Target="Default.Container/Customers">
<Annotation Term="Org.OData.Capabilities.V1.SelectSupport">
<Record>
<PropertyValue Property="Supported" Bool="true" />
<PropertyValue Property="InstanceAnnotationsSupported" Bool="false" />
<PropertyValue Property="Expandable" Bool="false" />
<PropertyValue Property="Filterable" Bool="true" />
<PropertyValue Property="Searchable" Bool="false" />
<PropertyValue Property="TopSupported" Bool="true" />
<PropertyValue Property="SkipSupported" Bool="false" />
<PropertyValue Property="ComputeSupported" Bool="false" />
<PropertyValue Property="Countable" Bool="true" />
<PropertyValue Property="Sortable" Bool="false" />
</Record>
</Annotation>
</Annotations>
</Schema>
Note that only specified properties will be output eg
_ = customerConfiguration.HasSelectSupport()
.IsSupported(true) // Supports $select
.IsCountable(true) // $count within $select is supported
.IsSortable(false); // $orderby within $select is *not* supported
$metadata
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
<Annotations Target="Default.Container/Customers">
<Annotation Term="Org.OData.Capabilities.V1.SelectSupport">
<Record>
<PropertyValue Property="Supported" Bool="true" />
<PropertyValue Property="Countable" Bool="true" />
<PropertyValue Property="Sortable" Bool="false" />
</Record>
</Annotation>
</Annotations>
</Schema>
ReadRestrictions
Restrictions for retrieving a collection of entities, retrieving a singleton instance.
_ = customerConfiguration
.HasReadRestrictions()
.IsReadable(true)
.HasDescription("Permissions Required To Access Resource")
.HasPermissions(permission =>
permission.HasSchemeName("Application")
.HasScopes(scope => scope.HasScope("Customers.ReadWrite"))
.HasScopes(scope => scope.HasScope("Customers.ReadAll")))
.HasPermissions(permission =>
permission.HasSchemeName("Delegated")
.HasScopes(scope => scope.HasScope("Customers.ReadWrite"))
.HasScopes(scope => scope.HasScope("Customers.ReadAll")));
$metadata
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
<Annotations Target="Default.Container/Customers">
<Annotation Term="Org.OData.Capabilities.V1.ReadRestrictions">
<Record>
<PropertyValue Property="Readable" Bool="true" />
<PropertyValue Property="Permissions">
<Collection>
<Record>
<PropertyValue Property="SchemeName" String="Application" />
<PropertyValue Property="Scopes">
<Collection>
<Record>
<PropertyValue Property="Scope" String="Customers.ReadWrite" />
</Record>
<Record>
<PropertyValue Property="Scope" String="Customers.ReadAll" />
</Record>
</Collection>
</PropertyValue>
</Record>
<Record>
<PropertyValue Property="SchemeName" String="Delegated" />
<PropertyValue Property="Scopes">
<Collection>
<Record>
<PropertyValue Property="Scope" String="Customers.ReadWrite" />
</Record>
<Record>
<PropertyValue Property="Scope" String="Customers.ReadAll" />
</Record>
</Collection>
</PropertyValue>
</Record>
</Collection>
</PropertyValue>
<PropertyValue Property="Description" String="Permissions Required To Access Resource" />
</Record>
</Annotation>
</Annotations>
</Schema>
DeleteRestrictions
Restrictions on delete operations
_ = customerConfiguration
.HasDeleteRestrictions()
.IsDeletable(false)
.HasDescription("Delete not allowed")
.HasLongDescription("Configuration could be done as shown in the read restrictions above, this is just for demo purposes");
$metadata
<Schema Namespace="Default" xmlns="http://docs.oasis-open.org/odata/ns/edm">
<EntityType Name="Customer">
<Key>
<PropertyRef Name="CustomerId" />
</Key>
<Property Name="CustomerId" Type="Edm.Int32" Nullable="false" />
<Property Name="Name" Type="Edm.String" />
</EntityType>
<EntityContainer Name="Container">
<EntitySet Name="Customers" EntityType="Default.Customer" />
</EntityContainer>
<Annotations Target="Default.Container/Customers">
<Annotation Term="Org.OData.Capabilities.V1.DeleteRestrictions">
<Record>
<PropertyValue Property="Deletable" Bool="false" />
<PropertyValue Property="Description" String="Delete not allowed" />
<PropertyValue Property="LongDescription" String="Configuration could be done as shown in the read restrictions above, this is just for demo purposes" />
</Record>
</Annotation>
</Annotations>
</Schema>
Sample Project
A sample project can be found in the ODataSamples repository on github
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for