DataInspectorExtensionOptions Interface

Provides options for customizing the DataInspectorExtension.

Declaration

export interface DataInspectorExtensionOptions

Remarks

See the following topic for information on how to use the DashboardControl’s client-side API: Extensions Overview.

For more information on how to enable and customize Data Inspector, refer to the following articles based on the platform:

• Manage Data Inspector in the Dashboard Control for JavaScript Applications
• Manage Data Inspector in the ASP.NET Core Dashboard Control
• Manage Data Inspector in the ASP.NET MVC Dashboard Extension
• Manage Data Inspector in the ASP.NET Web Forms Dashboard Control

You can enable export to Excel. Refer to the following topic for details: Export Data.

Properties

allowInspectAggregatedData Property

Specifies whether to display aggregated data in the Data Inspector.

Declaration

allowInspectAggregatedData?: boolean

Property Value

Type	Description
boolean	true, to display aggregated data in the Data Inspector; otherwise, false.

Remarks

Set the allowInspectRawData property to true to display raw data in the Data Inspector.

When only one property is set to true, the window contains a single grid with raw or aggregated data, depending on what property is enabled. The window caption displays the dashboard item caption text and the inspected item type (raw or aggregated) in parentheses.

When both properties are set to true, the window contains two grids with raw and aggregated data and allows a user to switch between them. The window caption displays the dashboard item caption text.

For more information on Data Inspector, refer to the following article: Manage Data Inspector in the Dashboard Control for JavaScript Applications.

allowInspectRawData Property

Specifies whether to display raw data in the Data Inspector.

Declaration

allowInspectRawData?: boolean

Property Value

Type	Description
boolean	true, to display raw data in the Data Inspector; otherwise, false.

Remarks

Set the allowInspectAggregatedData property to true to display aggregated data in the Data Inspector.

When only one property is set to true, the window contains a single grid with raw or aggregated data, depending on what property is enabled. The window caption displays the dashboard item caption text and the inspected item type (raw or aggregated) in parentheses.

When both properties are set to true, the window contains two grids with raw and aggregated data and allows a user to switch between them. The window caption displays the dashboard item caption text.

For more information on Data Inspector, refer to the following article: Manage Data Inspector in the Dashboard Control for JavaScript Applications.

onDialogHidden Property

A handler for the event that occurs when the Data Inspector dialog is hidden.

Declaration

onDialogHidden?: (args: DataInspectorDialogArgs) => void

Property Value

Type	Description
(args: DataInspectorDialogArgs) => void	A function that is executed when the export dialog is hidden.

onDialogShowing Property

A handler for the event that occurs before the Data Inspector dialog is shown.

Declaration

onDialogShowing?: (args: DataInspectorDialogArgs) => void

Property Value

Type	Description
(args: DataInspectorDialogArgs) => void	A function that is executed before the Data Inspector dialog is shown.

onDialogShown Property

A handler for the event that occurs after the Data Inspector dialog is shown.

Declaration

onDialogShown?: (args: DataInspectorDialogArgs) => void

Property Value

Type	Description
(args: DataInspectorDialogArgs) => void	A function that is executed after the Data Inspector dialog is shown.

onGridContentReady Property

A handler for the event that occurs after the Grid widget’s content is loaded.

Declaration

onGridContentReady?: (args: DataInspectorGridArgs) => void

Property Value

Type	Description
(args: DataInspectorGridArgs) => void	A function that is executed after the Grid widget’s content is loaded.

Remarks

The Data Inspector uses the DevExtreme DataGrid to display raw or aggregated data. Use the component property to obtain the DataGrid instance. The following code snippet shows how to change the DataGrid options (hide the “CategoryName” column):

function onGridContentReady(args) {
    args.component.columnOption("CategoryName", "visible", false);
}

onGridInitialized Property

A handler for the event that occurs before the Grid widget’s content is loaded.

Declaration

onGridInitialized?: (args: DataInspectorGridArgs) => void

Property Value

Type	Description
(args: DataInspectorGridArgs) => void	A function used in JavaScript frameworks to save the widget instance.

Remarks

The Data Inspector uses the DevExtreme DataGrid to display raw or aggregated data. Use the component property to obtain the dxGrid instance. The following code snippet shows how to change the DataGrid options (enable export to Excel):

Control

extensions:{
    "dataInspector": {
        allowInspectAggregatedData: true,
        allowInspectRawData: true,
        onGridInitialized: onGridInitialized
    }
}

Script

function onGridInitialized(args) {
    args.component.option({
        export: {
            enabled: true
        }
    });
}

Note that client-side export in the DataGrid widget requires the ExcelJS v4+ and FileSaver third-party libraries.