Data Cube Handler Options

The following options are available for creating or editing a handler for data sources:

Option

Description

Name

The name of the handler that is displayed in Data Cube.

Default Search Field

The name of the default data field that you want use for searching the data.

You can also select multiple search fields, or leave Default Search Field blank to include all the fields in searches.

Default Search Keyword

The default query to filter data based on keywords.

Only data that matches the query is included in the response.

You can include wildcard patterns, such as * and ?.

Column Names

The names of the data fields from the data source that will be returned in the response.

Unless you select Override, some system-generated fields are also included in the response, including data_source_type, data_source_name, data_source (id), contented, and score.

Filter Criteria

The names of data fields and specific values that must be true for a data row to include the data in the response.

You can combine multiple filter criteria into conditional statements using AND, OR, and NOT.

Sort By

The names of the data fields that are used to sort the data in the response and the sorting method, either ascending or descending.

You can separate multiple sorting fields with a comma, and the fields will be sorted by the order in which they are listed.

Facet

A check box that specifies whether faceting is enabled in the response.

Facets Field

The data fields to use as facet categories, if you select Facet.

Facets Query

The query to override the default facet count values generated in the response, if you select Facet.

You can specify a range of values to count for a facet field, instead of the default values that are generated in the response.

For example, if you have a handler with a facets field named Parking _Spaces that contains integer values, then you can specify a limited set of integer ranges to display in the facet counts, instead of the complete list of unique values in the Parking Spaces data field. Enter the query as: {!key=facet count display name}Facet Field name:facets query.

The facets query parameter can be a unique value, such as 0; a range of values, such as [1 TO 50]; or a minimum value, such as [51 TO *].

  • {!key=NoParking}Parking_Spaces:0

  • {!key=1TO50ParkingSpaces}Parking_Spaces:[1 TO 50]

  • {!key=Above50ParkingSpaces}Parking_Spaces:[50 TO *]

Additional Criteria

Option

Description

Count

The maximum number of rows from the data source that are included in the response.

Response Type

A list of the format types in which the data in the response can be formatted.

Raw Query

The raw parameter-value pairs to include in the response.

The values that you enter in Raw Query override most values for parameters that are included in the handler form. If the handler form parameter can have multiple entries, such as Filter Criteria, then the values in Raw Query are appended to the parameter in the handler form.

Default

When selected, these values are overridden by the request if the same parameters are found.

Append

When selected, these values are appended to any values that you specify in the request.

Override

When selected, these values overwrite any values that you specify in the request.

Loading...