Configure chart fields

更新时间:
复制 MD 格式

Learn how to configure the field, style, and Advanced settings for a chart in a dashboard.

The Field tab on the dashboard edit page lets you add dimension and measure fields to a chart and configure its chart style and advanced settings:

Note

The available field types, chart styles, and advanced settings depend on the data source and chart type. The options you see in the UI may differ from those described in this topic.

Configure measure fields

This section shows you how to configure a measure field, using the order quantity field as an example.

  1. Hover over the measure field and click the image.png icon on the right.

    image.png

  2. Configure the following parameters based on your business requirements:

    image

    • Data display format

      • automatic

      • None (displays the original value)

      • Integer

      • 1 decimal place

      • 2 decimal places

      • Percentage

      • Percentage (1 decimal place)

      • Percentage (2 decimal places)

      • Custom

        If the predefined options do not meet your needs, select Custom for advanced formatting. In the Data Display Format Settings dialog box, choose a format type and configure its settings. You can select auto-fit, Number, Percentage, or Manual input. The following table describes the settings.

        Format type

        Parameter

        Description

        Auto-fit

        image

        Adaptation method

        Supports automatic formatting for multiple locales. You can set the number format to Simplified Chinese, Traditional Chinese, or English. You can also select Follow system language. The system automatically applies the common numbering system for the selected language and adjusts the number of decimal places to ensure alignment.

        Number

        image

        Data magnitude

        Sets the unit for the data magnitude. The default is None, which means no unit is added. You can switch to Automatic, Thousand, Ten thousand, Million, Ten million, Hundred million, K, k, M, mn, or bn.

        Note
        • K and k represent thousands; M and mn represent millions; bn represents billions.

        • When you select Automatic, the system selects the most appropriate data magnitude unit based on the actual value. The unit automatically changes based on the system language. For example, an English system displays units such as K and M, while a Chinese system displays units such as wan and yi.

        Hide data magnitude unit

        Specifies whether to hide the data magnitude unit. This option is unavailable when Data magnitude is set to None or Automatic.

        Decimal places

        Sets the number of decimal places to display. You can enter an integer from 0 to 10.

        Negative numbers

        Sets the display style for negative numbers.

        • -1234: Display with a minus sign (default).

        • (1234): Display in parentheses.

        Prefix/Suffix

        This setting allows you to add text before and after the data. For example, if you set the prefix to "¥" and the suffix to "Yuan", the final data is displayed as "¥xxx Yuan".

        Currency symbol mode

        Controls the position of the prefix for negative numbers. This option is available only when the negative number format is "-1234".

        When enabled, the prefix appears between the minus sign and the number (for example, -¥5).

        Use thousands separator

        Specifies whether to insert a thousands separator in the number.

        If selected, a separator is inserted every three digits.

        Percentage

        image

        Decimal places

        Sets the number of decimal places to display. You can enter an integer from 0 to 10.

        Negative numbers

        Sets the display style for negative numbers.

        • -1234: Display with a minus sign (default).

        • (1234): Display in parentheses.

        Prefix/Suffix

        Adds text before or after the data.

        Use thousands separator

        Specifies whether to insert a thousands separator in the number.

        If selected, a separator is inserted every three digits.

        Manual input

        image

        Adaptation method

        Manually enter a format string composed of special characters such as 0, #, ,, ., E, %, , ;, and '. For example: #,##0.00. The length cannot exceed 50 characters.

        For more information about the rules for manual input, see Manual input syntax and capabilities.

    • Alignment

      Horizontal alignment: Automatic, Left, Center, Right.

      Vertical alignment: Automatic, Top, Middle, Bottom.

    • Sort

      Unsort, Ascend, Descend, Ascend within group, Descend within group, Advanced sort.

    • Aggregation method

      The following aggregation methods are supported: SUM, AVG, COUNT, COUNT DISTINCT, MAX, MIN, median, percentile, population standard deviation, sample standard deviation, population variance, sample variance, First time point, and Last time point.

      The special aggregation methods First time point and Last time point have the following use cases:

      • First time point/Last time point:

        • To view the amount at the beginning of a period and the ending inventory for that period, set the aggregation method to First time point and Last time point. For example, when analyzing monthly product order data:

          image.png

        • Similarly, to view the starting and ending amounts for a time period selected in a query control, use the First time point and Last time point aggregation methods.

          image..png

        • To find the final inventory quantity for different product types across various regions, set the aggregation method to Last time point. This shows the quantity at the final order time point for the selected data.

          image.png

        The following table describes the aggregation methods supported by different types of data sources.

        Data source

        Aggregation method

        All types of data sources that can connect to Quick BI

        SUM, AVG, COUNT, COUNT DISTINCT, MAX, MIN, First time point, and Last time point.

        MySQL, Vertica, SAP IQ (Sybase IQ), SQL Server, Presto, PolarDB for Oracle, PostgreSQL, Oracle, MaxCompute, Hive, SAP HANA, AnalyticDB for PostgreSQL, Gbase, IBM DB2 LUW, Clivia, ClickHouse, and AnalyticDB for MySQL V2.0

        Population Standard Deviation, Sample Standard Deviation, Population Variance, and Sample Variance

        SAP IQ (Sybase IQ), Oracle, MaxCompute, SAP HANA, and IBM DB2 LUW

        Median

        SAP IQ (Sybase IQ), Oracle, MaxCompute, SAP HANA, and IBM DB2 LUW

        Percentile

    • Advanced calculation

      • Date accumulation: Calculates a cumulative total over a date/time dimension. For configuration details, see Date accumulation.

      • Cumulative calculation: Calculates a running total of the measure based on the order of the data, letting you observe its incremental increase. For configuration details, see Cumulative calculation.

        Note
        • This feature cannot be used if comparison is configured for the measure field.

        • Only measure fields aggregated by SUM (image.png) support cumulative calculation.

        • Cumulative calculation is supported only when the dimension contains one date field and the time granularity of the date field is year, quarter, month, week, or day.

      • Percentage

        • % of Grand Total

        • % of Column Grand Total

        • % of Row Grand Total

        • % of Parent Column Grand Total

        • % of Parent Row Grand Total

        Percentage is supported only in cross tables. For more information, see Cross table (new version).

      • Ranking

        • Ascend

        • Descend

        • Ascend within group

        • Descend within group

        • None

        For more information, see Data ranking.

      • TopN

        TopN (quick filter) filters database results by value, letting you quickly select the top or bottom N records.

        For more information, see TopN.

      • Percentile

        The Percentile calculation determines the percentile rank for each value in the dataset, showing where a value falls within the entire dataset.

        For more information, see Percentile.

      • Comparison

        Available comparison options depend on the dimension field. For configuration details, see Comparison.

      • None

    • Null value display

      Sets the display style for null values.

    • Field display

      Configure the field's display name and field description.

      • Display name: The field name displayed on the chart.

      • Field description: A description of the field, which can be plain Text or a Link.

        • Text: You can configure descriptive text.

          image

          Once configured, click the icon next to the field to view its description.

          image

        • Link: You can configure link text and a link URL.

          imageClick the image icon on the right to visit the link.imageOnce configured, click the icon next to the field to open the link.image

    • Hide field

      A hidden field no longer appears in the report but can be unhidden.

      image

      Delete field

      Hover over the measure field and click the image.png icon on the right.

Configure dimension fields

Text fields

This example shows how to configure the product_type field as a dimension field.

  1. Hover over the dimension field and click the image.png icon on the right.

    image

  2. Configure the Sort parameter based on your business requirements. Valid values:

    image

    • Alignment

      Horizontal alignment: Automatic, Left, Center, Right.

      Vertical alignment: Automatic, Top, Middle, Bottom.

    • Sort

      Unsort, Ascend, Descend, Ascend within Group, Descend within Group, Custom, Sort by Field, Advanced Sort.

      If you select Custom, you can drag the target field to a specific area.

      Untitled.gif

    • Advanced calculation

      None, TopN.

      For more information, see TopN.

    • Null value display style

      Set the display style for null values or empty strings.

      • null value:

        • Display as '-'

      • string:

        • Display as '-'

    • Field display content

      Set the display name and field description for the field.

      • display name: The name of the field displayed on the chart.

      • field description: A description of the field. It supports both text and link formats.

        • For text, enter a description.

          image

          Click the icon to the right of the field to view the description.

          image

        • For a link, enter the link text and link URL.

          imageClick the image icon on the right to open the link.imageOnce configured, click the icon to the right of the field to open the link.image

    • Hide field

      If you hide a field, it will not appear in the report. You can also unhide it.

  3. Drill down the dimension field.

    Hover over the dimension field and click the image.png icon on the right.

  4. Delete the dimension field.

    Hover over the dimension field and click the image.png icon on the right.

Date fields

For date fields, you can also configure the date display format. The following example uses the Order Date (day) field:

  1. Move the pointer over the field and configure the date display format for the field by following instructions shown in the following figure.

    image.png

    Configuration effect

Manual input syntax

To configure the display format, you can enter a format pattern manually. The following table describes the available special symbols.

Symbol

Parameter

Description

0

Digit placeholder (pads with zeros)

Displays a 0 if a digit is absent in a given position. For example, the pattern 000

formats a number to a minimum of three digits, adding leading zeros as needed.

#

Digit placeholder (optional digit)

Displays a digit only if one is present in the position, suppressing leading or trailing zeros.

.

Decimal point

Separates the integer and decimal parts. The . symbol always acts as the decimal point, regardless of locale.

,

Thousands separator

Inserts a separator every three digits (e.g., 1,000,000). Note: This is a grouping separator, not a decimal point.

E

Scientific notation

Indicates exponential format (E means "times ten to the power of"). Must be followed by at least one 0 or #.

%

Percentage

Multiplies the value by 100 and appends a % symbol. Multiple consecutive % symbols (e.g., %%) are not supported.

Permille

Multiplies the value by 1,000 and appends a ‰ symbol. Multiple consecutive ‰ symbols (e.g., ‰‰) are not supported.

;

Section separator

Defines separate format sections. The first section applies to positive numbers and zero, and the second section applies to negative numbers.

'

Quote

Encloses characters to render them as literal text.

Note

Characters not listed in the table (such as letters, Chinese characters, or parentheses) are rendered as literal text. To treat a special symbol as a literal, enclose it in single quotes.

Symbols and examples

Digit placeholders: 0 and #

The difference lies in their padding behavior:

  • 0 forces a digit to display, padding with a zero if the position is empty. This is useful for fixed-width displays (e.g., IDs) where zero-padding is required.

  • # displays only significant digits and suppresses non-significant zeros. This is useful for displaying values dynamically without unnecessary zeros.

Note
  • Placing symbols other than ., ,, or E between # and 0 treats them as literal text appended to the number.

  • When # and 0 are used together, for the integer part, 0 must be to the right of #, and for the decimal part, 0 must be to the left of #.

Pattern

Input

Output

Description

000

5

005

Pads with leading zeros to meet the three-digit width.

###

5

5

Does not pad with leading zeros.

0.00

1234.501

1234.50

Displays at least one integer digit and rounds the decimal part to two places, padding with a zero if necessary.

#.##

1234.501

1234.50

Rounds the decimal part to a maximum of two places and suppresses trailing zeros.

#.00

5

5.00

Pads the decimal part to two places.

0000.000

12.3

0012.300

Pads the integer part to four digits and the decimal part to three.

Thousands separator: ,

Pattern

Input

Output

Description

,##0

1234567

1,234,567

Adds a thousands separator.

#,##0.00

1234.567

1,234.57

Commonly used for currency values.

#,##0

12345.67

12,346

Groups by thousands and rounds to the nearest integer.

Decimal point: .

Pattern

Input

Output

Description

0.00

123.4

123.40

Formats the number to two decimal places.

0.####

123.456

123.456

Displays up to four decimal places and suppresses trailing zeros.

Scientific notation: E

Pattern

Input

Output

Description

0.00E0

12345.67

1.23E4

Scientific notation with an integer exponent.

0.00E00

12345.67

1.23E04

Pads the exponent to at least two digits.

0.######E0

0.000123

1.23E-4

Formats a small decimal value into scientific notation.

Percentage: %

Pattern

Input

Output

Description

0%

0.123

12%

Formats the number as a percentage, rounded to an integer.

0.00%

0.123

12.30%

Formats the number as a percentage with two decimal places.

Note

Multiple consecutive % symbols (e.g., %%) are not supported.

Permille:

Pattern

Input

Output

Description

0‰

0.1234

123‰

Formats the number as permille, rounded to an integer.

0.00‰

0.1234

123.40‰

Formats the number as permille with two decimal places.

Note

Multiple consecutive symbols (e.g., ‰‰) are not supported.

Section separator: ;

Pattern

Input

Output

Description

0.00;▼0.00

123.45

123.45

Positive numbers are displayed normally.

-123.45

▼123.45

Replaces the minus sign with ▼ for negative numbers.

Profit:+0.00;Loss:-0.00

123.45

Profit:+123.45

Customizes prefixes for positive and negative numbers.

-123.45

Loss:-123.45

Note

A format pattern cannot have an empty section before or after the ;. For example, ;0.00m is invalid.

Quote: '

Pattern

Input

Output

Description

'Result:'0.00

123.45

Result:123.45

Inserts a literal text prefix.

'#'000

5

#005

Escapes a special symbol to render it as a literal character.

Note

To display special format characters (such as #, 0, ., or ,) as literal text, enclose them in single quotes.

Quick reference for common formats

Use case

Recommended pattern

Keep two decimal places

0.00

Thousands separator with two decimal places

#,##0.00

Percentage (two decimal places)

0.00%

Scientific notation

0.00E0

Enclose negative numbers in parentheses

0.00;(0.00)

Display unit (for example: Yuan, meter)

¥#,##0.00

0.00m

Pad with zeros to a fixed width (e.g., 5 digits)

00000

Optional decimal places (up to 4)

#.####