Sync with Kendo UI Professional

Author: User Jenkins

docs-aspnet/html-helpers/data-management/grid/filtering.md

@@ -27,6 +27,8 @@ Each `Filterable` configuration of the columns allows the setting of a custom Da
     );
     .ShowIndexes(true))
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be filterable. To enable filtering on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/aspnet-core/knowledge-base/grid-enable-operations-for-object-column).
+
 ## Filter Modes
 
 The Grid supports the following filter modes:

docs-aspnet/html-helpers/data-management/grid/grouping/overview.md

@@ -19,6 +19,8 @@ To control grouping in the Grid, use the [`Groupable()`](https://docs.telerik.co
             .Groupable()
 	    	...
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be groupable. To enable grouping on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/aspnet-core/knowledge-base/grid-enable-operations-for-object-column).
+
 You can also render groups by setting group expressions in the DataSource of the Grid even without enabling `Groupable`.
 
         .Name("Grid")       

docs-aspnet/html-helpers/data-management/grid/sorting.md

@@ -19,6 +19,8 @@ To control the sorting in the Grid, use the `Sortable` option.
         .Sortable()
         ...
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be sortable. To enable sorting on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/aspnet-core/knowledge-base/grid-enable-operations-for-object-column).
+
 ## Sort Modes
 
 The Grid supports single and multiple columns sort modes which can be set through its `SortMode` property. You can also specify if the columns can be unsorted by setting the `AllowUnsort` property to `true` or `false`. For a runnable example, refer to the [demo on sorting in the Grid](https://demos.telerik.com/{{ site.platform }}/grid/sorting).

docs-aspnet/html-helpers/datasource/overview.md

@@ -49,7 +49,13 @@ The following example demonstrates how to define the DataSource by using the Dat
 
 ## Basic Configuration
 
-You can declare the DataSource HtmlHelper configuration options by using the available methods—for example, you can define the page size, page, sort order, filter, group, aggregates, and the model. The configuration accepts the definition for all CRUD operations and facilitates the sending of additional data such as the `AntiForgeryTokens`.
+You can declare the DataSource HtmlHelper configuration options by using the available methods—for example, you can define the page size, page, sort order, filter, group, aggregates, and the model. 
+
+> * To [sort](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sort) the data based on an object, set [the data field, by which the data items are sorted,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sortfield) to a property of that object. 
+> * To [group](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group) the data by an object, set [the group by data item field](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group#groupfield) to a property of that object.
+> * To [filter](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter) the data based on an object, set [the data item field, to which the filter operator is applied,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter#filterfield) to a property of that object.
+
+The configuration accepts the definition for all CRUD operations and facilitates the sending of additional data such as the `AntiForgeryTokens`.
 
     @(Html.AntiForgeryToken())
 

docs-aspnet/knowledge-base/grid-enable-operations-for-object-column.md

@@ -20,10 +20,95 @@ component: grid
 
 ## Description
 
-How can I enable sorting, filtering, and grouping for a column which holds complex object values in the Grid HtmlHelper?
+How can I enable sorting, filtering, and grouping for a column which holds complex object values by using the Grid HtmlHelper?
 
 ## Solution
 
+- Enable the sorting, grouping, and filtering through the `.Sortable()`, `.Groupable()`, and `.Filterable()` methods.
+- The `Product` Model has a `Category` property, which is a Model with `CategoryID` and `CategoryName` properties. Bind the column to the `CategoryName` property.
+
+```View
+@model ProjectName.Models
+
+@(Html.Kendo().Grid<Product>()
+    .Name("grid")
+    .Columns(columns =>
+    {
+        columns.Bound(product => product.ProductID);
+        columns.Bound(product => product.Category.CategoryName);
+    })
+    .Pageable()
+    .Sortable()
+    .Filterable()
+    .Groupable()
+    .DataSource(dataSource => dataSource
+        .Ajax()
+        .Read(read => read.Action("Read", "Grid"))
+    )
+)
+```
+```Models
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+
+public class Product
+{
+    public int ProductID  { get; set; }
+    public Category Category { get; set; }
+}
+
+public class Category
+{
+    public int CategoryID { get; set; }
+
+    public string CategoryName { get; set; }
+}
+```
+```Controller
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using ProjectName.Models;
+using Kendo.Mvc.Extensions;
+using Kendo.Mvc.UI;
+using Microsoft.AspNetCore.Mvc;
+
+public class GridController : Controller
+{
+        private static ICollection<Product> products;
+
+        public GridController()
+        {
+            if (products == null)
+            {
+                var random = new Random();
+                products = Enumerable.Range(1, 100).Select(x => new Product
+                {
+                    ProductID = x,
+                    Category = new Category
+                    {
+                        CategoryID = x,
+                        CategoryName = "Category" + x
+                    }
+
+                }).ToList();
+            }
+        }
+        public IActionResult GridController()
+        {
+            return View();
+        }
+
+        public ActionResult Read([DataSourceRequest] DataSourceRequest request)
+        {
+            return Json(products.ToDataSourceResult(request));
+        }
+    }
+```
+
 For the complete implementation on how to enable sorting, filtering, and grouping in a Kendo UI Grid for ASP.NET Core when a Grid column represents complex object values, refer to [this GitHub project](https://github.com/telerik/ui-for-aspnet-core-examples/blob/master/Telerik.Examples.Mvc/Telerik.Examples.Mvc/Views/Grid/EnableOperationsForObjectColumn.cshtml) demonstrates how to.
 
 ## See Also

docs-aspnet/tag-helpers/datasource/overview.md

@@ -25,6 +25,10 @@ The following example demonstrates how to define the DataSource by using the Dat
 
 The DataSource TagHelper configuration options are passed as attributes of the tag. The DataSource is an abstraction for binding the Kendo UI widgets to local and remote data and to handle various data operations with the `databound` Tag Helpers.
 
+> * To [sort](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sort) the data based on an object, set [the data field, by which the data items are sorted,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sortfield) to a property of that object. 
+> * To [group](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group) the data by an object, set [the group by data item field](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group#groupfield) to a property of that object.
+> * To [filter](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter) the data based on an object, set [the data item field, to which the filter operator is applied,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter#filterfield) to a property of that object.
+
 ```tagHelper
     <kendo-datasource name="dataSource" type="DataSourceTagHelperType.Ajax" server-operation="false" page-size="5">
         <transport>

docs/controls/data-management/grid/filtering.md

@@ -12,6 +12,8 @@ By default, the filtering functionality of the Kendo UI Grid is disabled.
 
 To control filtering in the Grid, use the `filterable` property.
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be filterable. To enable filtering on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/kendo-ui/knowledge-base/enable-operations-for-object-column).
+
 The Grid enables you to implement the following filter options:
 * [Header row filtering](#filtering-by-rows)
 * [Filtering by checkboxes](#filtering-by-checkboxes)

docs/controls/data-management/grid/grouping/overview.md

@@ -31,6 +31,8 @@ To sort the grouped content, click the grouping tab. To toggle the sort order of
 
 ![Grid Grouped by Last Name](../grid6_1.png)
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be groupable. To enable grouping on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/kendo-ui/knowledge-base/enable-operations-for-object-column).
+
 ## Using with Row Templates
 
 A row template explicitly defines the row markup while grouping requires you to change the row markup. To use the two features simultaneously, include a script in the row template which adds additional cells depending on the number of the existing groups.

docs/controls/data-management/grid/sorting.md

@@ -22,6 +22,8 @@ To enhance the performance of the Grid, apply the sorting operations on the serv
 
 ![Grid with Sorting Enabled](grid7_1.png)
 
+> Only columns that are [bound to a field](https://docs.telerik.com/kendo-ui/api/javascript/ui/grid/configuration/columns.field) can be sortable. To enable sorting on a column bound to an object, [bind the column to a field of that object](https://docs.telerik.com/kendo-ui/knowledge-base/enable-operations-for-object-column).
+
 ## Sort Modes
 
 The Grid supports the following sort modes:

docs/framework/datasource/overview.md

@@ -15,6 +15,10 @@ The [Kendo UI DataSource component](https://demos.telerik.com/kendo-ui/datasourc
 
 The DataSource is an abstraction for using local data (arrays of JavaScript objects) or remote data (web services returning JSON, JSONP, [oData](http://www.odata.org/) or XML). It fully supports CRUD (Create, Read, Update, Destroy) data operations and provides both client-side and server-side support for sorting, paging, filtering, grouping, and aggregates.
 
+> * To [sort](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sort) the data based on an object, set [the data field, by which the data items are sorted,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/sort#sortfield) to a property of that object. 
+> * To [group](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group) the data by an object, set [the group by data item field](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/group#groupfield) to a property of that object.
+> * To [filter](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter) the data based on an object, set [the data item field, to which the filter operator is applied,](https://docs.telerik.com/kendo-ui/api/javascript/data/datasource/configuration/filter#filterfield) to a property of that object.
+
 The following list includes some of the functionality and features which the DataSource provides. For detailed information on the capabilities of the DataSource, refer to its [configuration API, methods, and events](/api/javascript/data/datasource), and [demos](https://demos.telerik.com/kendo-ui/datasource/index).
 
 * [Retrieval of data from a remote endpoint](/framework/datasource/cors).