All Products
Search
Document Center

Quick BI:Field Configuration and Filtering

Last Updated:Apr 01, 2026

On the dataset edit page, you can configure fields, create folders, and perform other operations to refine your dataset.

Configure fields

After you build a model, Quick BI automatically previews the data and parses it into dimension and measure fields for further analysis.

You can edit field names, field types, and default display formats for numeric or date values.

Entry points

  • In the Field Outline area, hover over the target field and click ① to configure it.

  • In the Data Preview area, click ② to configure the field.

image

  • The Field Details area displays basic information about the field. You can also create a dataset.

Features

Actions

Description

Edit field information

Modify the display name and description for a dimension or measure.

Edit formula

You can edit the formula for a newly created calculated field.

Note

You can edit formulas only for newly created calculated fields.

Switch field type

You can set the field type to Text, Date, Geo, Number, or Image. You can also convert a dimension field to a measure, or a measure field to a dimension.

Note

If a calculated field contains a Level of Detail (LOD) function:

  • You can switch numeric calculated fields between measures and dimensions.

  • You can switch text-based calculated fields between measures and dimensions.

  • You cannot convert the type of date-based calculated fields.

image

  • For date fields, you can configure the source data format.

    For example, if your source data is in the format 20210101, select YYYYMMDD. Selecting the correct format ensures proper data parsing and type conversion.

    To change the display format of a date field, use the Display format settings.

  • If a field contains geographic data, such as provinces or cities, and you plan to use it in map charts, set the field type to Geo and select the appropriate geographic granularity.

  • Image

    • Image (URL)

      If a field contains image URLs and you want to display the images in dashboard components such as pivot tables, leaderboards, or scorecards, set the field type to Image.

      Note

      Image URLs must begin with HTTPS. HTTP is not supported.

    • Image (File Upload)

      If a field corresponds to uploaded image files, such as images uploaded through a data entry form, the system automatically converts these files into a displayable format for use in datasets and reports.

      For more information, see Image Upload.

Default aggregation method

You can configure a default aggregation method only for measure fields.

When analyzing data in a dashboard, dashboards use the default aggregation method configured in the dataset.

image

Display format settings

  • Date display format

    You can set a display format for date fields, and a default format for each date granularity.

    • Day

      • YYYYMMDD (Example:20200106)

      • MMDD (Example:0106)

      • MM/DD (Example:01/06)

      • MM/DD/YYYY (Example:01/06/2020)

    • Week

      • YYYYMMDD~YYYYMMDD (Example:20200106~20200112)

      • YYYY[W]W(MMDD~MMDD) (Example:2020W02(0106~0112))

      • MMDD~MMDD (Example:0106~0112)

    • Month

      • YYYYMM (Example:202001)

    • Quarter

      • YYYYQ (Example: 2020Q1)

      • FYYYYY-Q (Example: FY2020-Q1)

    • Year

      • YYYY (Example: 2020)

      • FYYYYY (Example: FY2020)

  • Null value display style

    For dimension fields, you can set the display style for null values or empty strings.

    • Null Value:

    • Empty String:

Note

A custom display value for nulls can contain Chinese and English characters, numbers, and the following special characters: underscores (_), slashes (/), backslashes (\), vertical bars (|), parentheses (()), and brackets ([]). The custom value cannot exceed 150 characters.

  • Numeric display format

    For measure fields, you can set the numeric display format.

    • Auto

    • Integer

    • 1 decimal place

    • 2 decimal places

    • Percentage

    • Percentage with 1 decimal place

    • Percentage with 2 decimal places

    • Custom

      You can define a custom display format as a Number, Percentage, or through Manual Input.

      image

Date properties

Date fields support both the standard Calendar Year and a custom Fiscal Year.

When you select Fiscal Year, you can specify the month the Fiscal Year Starts In.

  • Fiscal Year Starts In

    You can select the starting month of the fiscal year based on your business requirements.

    image

    Note
    • For example, if you set the Fiscal Year Starts In to April, the period from April 1, 2023, to March 31, 2024, is considered fiscal year 2024 (FY24). The calculation logic for year-over-year and month-over-month comparisons will differ from the standard calendar year. For more information, see year-over-year and month-over-month comparison.

    • The fiscal year number corresponds to the calendar year in which it ends.

      • If the fiscal year starts in January: January 2024 to December 2024 is fiscal year 2024 (FY24).

      • If the fiscal year starts in February: February 2024 to January 2025 is fiscal year 2025 (FY25).

  • Week Starts On

    Note

    For a list of data sources that support custom week start times, see Data Source Feature List.

    You can select the day on which the week starts as needed.

    imageClick Register Function to automatically register the necessary date functions.image

    • If you do not have write permissions for the database, you cannot use the automatic Register Function feature. Instead, you can Download Script Manually and run it on the data source.

    • Data sources such as MaxCompute, Presto, Hive, and Apache Doris do not support automatic registration. You must Download Script Manually and run the script on the data source.

Sync date granularity

This feature is only available for date fields.

If you accidentally delete some date granularity fields, click Sync Date Granularity. This action automatically syncs all date granularity fields from the source data to the dataset.

Sort

Set the default sort order to No Sorting, Ascending, Descending, or Custom.

When analyzing data in a dashboard, dashboards use the default sort order configured in the dataset.

New

  • New calculated field

    If the data you need for analysis is not in your data tables, create a calculated field to derive it from existing data. For more information, see Create a calculated field.

  • New group dimension

    Use group dimensions to group dimension values. For example, you can group an 'age' field into categories like 'underage', 'youth', 'middle-aged', and 'senior' to analyze vaccination rates for each age group. For more information, see Group Dimensions.

  • New hierarchy

    You can only create a hierarchy from a dimension field.

    A hierarchy defines a parent-child relationship between fields, such as Province, City, and District. You can group these fields into a hierarchy to enable automatic drill down in a dashboard. For more information, see Drill Down.

Copy

Creates a copy of a field. The name of the new field is automatically appended with "copy".

Move to

Moves a dimension into an existing hierarchy or folder.

Convert to aggregated/non-aggregated

A newly created calculated field of the measure type can be converted to aggregated or non-aggregated.

  • After you convert it to non-aggregated, the report automatically wraps it with a default aggregation function (such as SUM) and calculates it based on the specified dimensions.

  • After you convert it to aggregated, you cannot specify an aggregation method in reports. When you use the field in a report, it is used as-is without further aggregation.

Note

This option is available only for newly created measure-type calculated fields.

Delete

Deletes the field.

If you need to restore a deleted field, you can click the table on the canvas, then select and add the field back from the panel on the right.

Hide

In the field list or data preview area, hover over a field and click the image icon to hide it.

image

After a field is hidden, it does not appear in analysis tools like dashboards or spreadsheets that use this dataset. To show the field again, click the image icon in the field list area.

image

You can choose whether to display hidden fields on the dataset edit page:

  • By default, this option is selected, hiding fields from the data preview area.

  • If you clear the selection, hidden fields appear in the data preview area.

    image

Drag to reorder fields

You can drag one or more fields to reorder them or move them into a folder.

Untitled

Note
  • You cannot select a hierarchy, including a date hierarchy, when selecting multiple fields.

  • You cannot drag individual fields from a date hierarchy when selecting multiple fields.

Usage notes

If a field is referenced by a calculated field, a group dimension, or a filter condition, you cannot change its field type, convert it between a dimension and a measure, or delete it.

Configure fields in bulk

If you need to edit many fields, you can configure them in bulk.

  1. On the dataset edit page, click Field details.

  2. Select multiple fields, then modify their configurations at the bottom of the page.image

    Parameter

    Description

    Null value display style

    Set the display style for null values in bulk.

    Convert to measure/Convert to dimension

    If all selected fields are dimensions, you can convert them to measures in bulk.

    If all selected fields are measures, you can convert them to dimensions in bulk.

    Hide and show

    Hide or show fields in bulk.

    Delete

    Delete fields in bulk.

    Use description as field name

    Use field descriptions as field names in bulk.

New folder

You can create folders for dimensions and measures as shown in the following figure.

image