Grids and subgrids in Customer Engagement (Client API reference)
Applies to Dynamics 365 (online), version 9.x
Grids present data in a tabular format in Customer Engagement. Grids can span the entire form or can be one of the items on a form; the latter are called subgrids.
Types of grids
There are two types of grids in Customer Engagement:
- Read-only grids: Display data in a tabular format. To edit the data displayed in a read-only grid, you have to click the record in the grid to open the form, edit the data, and then save.
- Editable grids: In addition to displaying data in a tabular format, provides rich inline editing capabilities on web and mobile clients including the ability to group, sort, and filter data within the same grid so that you do not have to switch records or views. The editable grid is a custom control, and is supported in the main grid and subgrids on a form in the web client and in dashboards and on form grids on the mobile clients. Although the editable grid control provides editing capability, it honors the read-only grid metadata and field-level security settings.
Getting the grid context
|Subgrid OnLoad Event||Occurs every time the subgrid refreshes. This includes when users sort values in subgrid by clicking the column headings.||Read-only grid|
|Grid OnChange||Occurs when a value is changed in a cell in the editable grid and the cell loses focus||Editable grid|
|Grid OnRecordSelect||Occurs when a single row (record) is selected in the editable grid||Editable grid|
|Grid OnSave||Occurs before sending the updated information to the server, and when any of the following occurs: there is a change in the record selection, the user explicitly triggers a save operation using the editable grid’s save button, or the user applies a sort, filter, group, pagination, or navigation operation from the editable grid while there are pending changes.||Editable grid|
You can register for the OnChange, OnRecordSelect, and OnSave events using the Events tab of the Dynamics 365 Customer Engagement page that is used to enable editable grids for an entity or a read-only grid.
|GridControl||Provides methods to work with the grid or subgrid control.||Read-only and editable grids|
|Grid||Provides methods to access information about data in the grid.||Read-only and editable grids|
|GridRow||Provides methods to work with rows or selected rows in the grid.||Read-only and editable grids|
|GridRowData||Provides methods to work with rows or selected rows in the grid.||Read-only and editable grids|
|GridEntity||Provides methods to access data about the specific records in the rows.||Read-only and editable grids|
|GridAttribute||Provides methods to access the data in the cell of an editable grid.||Editable grid|
|GridCell||Provides methods to access the data related to control on a form that is tied to an attribute in an editable grid.||Editable grid|
|ViewSelector||Provides methods to get or set information about the view selector of the subgrid control.||Read-only grid|