Skip to main content

/Data/KPIDrillthrough

Executes a detail listing using a compiled KPI class.

Request Method

POST

URL Parameters

None. Note that a request body is required; see the next heading.

Request Body Details

This endpoint uses the following properties of the request body:

KPI

Required. Logical name of the KPI. This must be a KPI that supports detail listings; that is, it must implement the %OnGetListingSQL() callback.

RANGE

Specifies the range of cells in the KPI for which you are requesting a detail listing. The value of this property should be a string with the form “startRow,startColumn,endRow,endColumn”. (Note that numbering for rows and columns should be 1-based.)

ITEMS

Specifies the KPI values of the rows for which you are requesting a detail listing, as a comma-separated list. Any comma within these values should be replaced with a backslash character (\). If no property of the KPI is configured as the KPI’s value, this property can specify the series name.

SORTCOL

Specifies the number of the column by which the detail listing’s results should be sorted. If you do not wish to sort the results, specify 0.

SORTDIR

Specifies the order by which the results should be sorted: ascending ("ASC") or descending ("DESC").

LISTING

Name of the listing to display.

FILTERS

An array that describes the filters which should be applied to the detail listing. Each filter should correspond to a JSON object in the array. The filter object should include the following properties:

  • name — the logical name of the filter (for example: [aged].[h1].[agegroup])

  • value — the user-specified value for the filter (for example: [0 to 29])

Example Request

FeedbackOpens in a new tab