Extend a Retail Server OData Controller
Important
This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.
Applies To: Microsoft Dynamics AX 2012 R3
A controller is a mapping for a commerce entity that controls CRUD behaviors and actions for a commerce entity type. Each commerce entity must have a corresponding controller. You can extend a controller that comes with Microsoft Dynamics AX to add new business actions to fulfill business needs.
Note
You can find the sample code from this topic in the Retail SDK.
Extend the Customer controller
To extend an existing controller, you need to define a new class that extends an existing controller class. In the new class, you use the ExtendedController attribute to indicate that the new class extends an existing controller, and to indicate which controller it extends. In this example, the new class extends the controller for the Customer entity type. Each entity type is associated with only one controller. When you create a new controller that overrides an existing controller, the new controller that has the ExtendedController attribute is used instead of the original controller.
In the following example, the ExtendedCustomersController class extends the CustomersController class and takes the entity type and the key field of the Customers entity type as parameters.
namespace Microsoft.Dynamics.RetailServer.ExtensionSamples
{
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.InteropServices;
using Microsoft.Dynamics.Commerce.Runtime.DataModel;
using Microsoft.Dynamics.Retail.StoreServerServiceLibrary;
using Microsoft.Dynamics.Retail.StoreServerServiceLibrary.ODataControllers;
[ExtendedController("Customers")]
[ComVisible(false)]
public class ExtendedCustomersController : CustomersController
{
public override IQueryable<Customer> Get()
{
List<Customer> customers = new List<Customer>();
for (int i = 0; i < 10; i++)
{
var customer = new Customer();
customer.AccountNumber = "customer" + i;
customer.Name = "Name" + i;
customers.Add(customer);
}
return customers.AsQueryable();
}
}
}