# Interface ExecuteQueryByWidgetIdParams

Parameters for useExecuteQueryByWidgetId hook.

# Properties

# count

count?: number

Number of rows to return in the query result

If not specified, the default value is 20000

# dashboardOid

dashboardOid: string

Identifier of the dashboard that contains the widget

# enabled

enabled?: boolean

Boolean flag to control if query is executed

If not specified, the default value is true

# filters

filters?: Filter[]

Filters that will slice query results.

The provided filters will be merged with the existing widget filters based on filtersMergeStrategy

# filtersMergeStrategy

filtersMergeStrategy?: "widgetFirst" | "codeFirst" | "codeOnly"

Strategy for merging the existing widget filters (including highlights) with the filters provided via the filters and highlights props:

widgetFirst - prioritizes the widget filters over the provided filters in case of filter conflicts by certain attributes.
codeFirst - prioritizes the provided filters over the widget filters in case of filter conflicts by certain attributes.
codeOnly - applies only the provided filters and completely ignores the widget filters.

If not specified, the default strategy is codeFirst.

# highlights

highlights?: Filter[]

Highlight filters that will highlight results that pass filter criteria

# includeDashboardFilters

includeDashboardFilters?: boolean

Boolean flag whether to include dashboard filters in the widget's filters and highlights

If not specified, the default value is false.

# offset

offset?: number

Offset of the first row to return

If not specified, the default value is 0

# onBeforeQuery

onBeforeQuery?: (jaql) => any

Sync or async callback that allows to modify the JAQL payload before it is sent to the server.

Note: In React, wrap this function in useCallback hook to avoid triggering query execution on each render.

const onBeforeQuery = useCallback((jaql) => {
  // modify jaql here
  return jaql;
}, []);

# Parameters

Parameter	Type
`jaql`	`any`

# Returns

any

# widgetOid

widgetOid: string

Identifier of the widget