Formatting a Flex Grid
  • 21 Oct 2024
  • 8 Minutes to read
  • Contributors
  • Dark
    Light

Formatting a Flex Grid

  • Dark
    Light

Article summary

Formatting a Flex Grid

After creating a Flex Grid and configuring the Layout, the formatting can be done directly from the Flex Grid on a Screen while in Design mode. Formatting options, like grouping, sorting, and filtering, can be exactly the same for an end user in Play mode if the configuration allows for it, the difference being that the Developer in Design mode can save a default view for Play mode.

The topics covered on formatting a Flex Grid are as follows:

Object Data properties & display options for pivot capabilities

While selecting a Flex Grid Object, access the Object Properties panel from the sliding panel on the right side of the Screen. Access the "Data" tab (which is the default panel displayed) to access data formatting options specific to a Flex Grid.

Main options

The Object Data properties specific to a Flex Grid are display options for both flat mode and Pivot mode which allow or restrict end users to use all, none, or certain pivot capabilities. The check boxes, Expansion level, Group display type, Sorting modification, and Filtering modification are explained below:
contents/assets/images/flex.grid.data.properties1.png

  • Show Fields panel. Enables or disables the display of the "Fields" panel in Play mode

  • Show Pivot mode. Enables or disables the possibility for end users to use Pivot Mode in Play mode

  • Allow changing column visibility. Allows or disallows end users to change the visibility of columns shown in flat mode from the Column menu in the Quick pivoting tab contents/assets/images/flex.grid.quick.pivot.icon.png. In the image below, the checkboxes are disabled and cannot be unselected to hide a column
    contents/assets/images/Flex.grid.disable.column.visibility.PNG

  • Allow grouping by row. Allows or disallows end users to group fields By Row in Play mode

  • Allow grouping by column. Allows or disallows end users to group fields By Row in Play mode

  • Allow aggregation of totals. Allows or removes the "Values" area of the Fields panel in both flat view and Pivot Mode. The image below shows the the Fields panel without the "Values" section because this setting disabled
    contents/assets/images/flex.grid.allow.agg.totals.update.png

  • Show status bar. Enables or disables the status bar at the bottom of the Flex Grid

  • Suppress group count. When enabled, removes the number that is displayed in parenthesis next to each row group. Disabled by default. This number counts the dataset rows which have been grouped by row, both in flat and pivot mode

  • Enable clicking URL.

Expansion level

The Expansion level customizes the view of the expanded/collapsed Row groups for the end user.

For example, if a Flex Grid was dimensioned by 3 Row groups, the default view shows all the rows collapsed under the most-aggregated group. If this setting is set to 1, the default view would expand the most-aggregated Row group to show the next Row group within the tree. If this setting is set to 2, the default view would show the most-aggregated Row group and the next Row group expanded so that the third Row group would be exposed. Set to 3 in order to expand all 3 Row groups.

This setting is only for the default view, and the end user can still use the expand/collapse options manually.

Group display type

The Group display type section displays the row groups either in a single column (default), multiple columns (for 2 or more), or only as row groups without any headers or columns. Choose one of the following 3 options from the dropdown menu:

  • Single column (default). A single group column is added to the grid which displays all row groups

  • Multiple. Separate group columns will be added to the grid for each column used to group the rows by
    contents/assets/images/flex.grid.group.display.multiple.png

  • Groups row. Removes Group headers and displays the grouping fields only in rows, similar to a Data View (only available in flat mode)
    contents/assets/images/flex.grid.group.display.group.png

Sorting modification

The Sorting modification section enables or disables the end user's ability to sort. If enabled, choose "Single" or "Multiple":

  • Single. Restricts the end user to only one field sort at a time. Sorting another field will automatically remove the last one

    contents/assets/images/flex.grid.single.sorts.cropped.png

  • Multiple. Allows the end user to sort multiple columns at a time. The numbers indicating which is the first (1), second (2), third (3), and so on

    contents/assets/images/flex.grid.multiple.sorts.cropped.png

Filtering modification

The Filtering modification section enables or disables the end user's ability to filter. If enabled, you can choose between "Single" or "Multiple", where “Single” offers 1 filter per column and “Multiple” offers multiple types of filters per column.

  • Single. Restricts the user's ability to apply only 1 filter per column

    • Text field or Time Entity. A single filter on a text field or Time Entity offers a text field search box (as shown below) from the filter menu
      contents/assets/images/flex.grid.text.filter.png

    • Numeric field. A single filter on a field with numeric data offers dropdown filter options combined with numeric fieldboxes with the possibility to use AND/OR conditions. The search box in the column header is also available for filtering directly from it

      contents/assets/images/flex.grid.data.filter.png

    • Date field. A single filter on a date field allows you to filter by dates with dropdown menus of filter options combined with a calendar with the possibility to use AND/OR conditions

      contents/assets/images/flex.grid.date.filter.update.png

  • Multiple. Allows the end user to apply multiple separate filters per column at a time. You can use multiple filters for each column, which unlocks a more advanced way to filter

    • Text field or Time Entity. When multiple filtering is configured, a text field or Time Entity column allows for an additional filter option to what is offered in a single filtering configuration: dropdown filter options combined with text fieldboxes with the possibility to use AND/OR conditions. The checkbox filters, which are the only option for a single filter on a text field, now will show results of the additional filter above them. In addition, the search box in the column header becomes available for direct filtering from it.      
      In the example below, the user can search for words that contain both the letters "b" and "e" resulting in BARCELONA, BERLIN, and BERN instead of only BERLIN and BERN like in the single filter example

      contents/assets/images/flex.grid.text.multiple.filter.png

    • Numeric field. When multiple filtering is allowed, a field that contains numeric data allows for an additional filtering option to what is offered in a single filtering configuration: checkbox fields that reflect the of the results from the above filter. In addition, you can also search through the results using the search box above the checkboxes

      contents/assets/images/flex.grid.data.multiple.filter.png

    • Date field. When multiple filtering is allowed, a Date field allows for an additional filtering option to what is offered in a single filtering configuration: checkbox fields that reflect the of the results from the above filter. In addition, you can also search through the results using the search box above the checkboxes

      contents/assets/images/flex.grid.date.mult.filter.update.png

Table Style

The Table Style section allows you to customize the table style with the ability to freeze rows, similar to Excel.

  • Frozen rows. Customize frozen rows. Type the number of rows you would like to freeze

Read more about common Object settings.

Customize color Formatting

Customizing the color format of a Flex Grid is similar to a Data View. Select the Object in Design mode and access the Object properties panel on the right.

Formatting in the Data panel

From the Data submenu of the Object properties panel, you can customize Templates and Block format similar to a Data View. Click on the button TEMPLATES or BLOCK FORMAT to open a popup window where you can configure the Row style template or Block format. Configuring a new template will bring you to the Templates page.

contents/assets/images/FG.formatting.data.PNG

To ignore any default formatting configured, check the “Disable default format template” checkbox.

When configuring a Block format for a Flex Grid, the Block format is applied across all of the block columns that may appear when using the pivot tool. For example, if a Gross Sales Block is formatted to have a green background, and the Flex Grid is configured to have an Entity grouped by column like Country, the Gross Sales block will appear under each country column group, and those columns will all display with the same formatting, which in the example is a green background.

Formatting in the Design panel

From the Design submenu of the Object properties panel, you can customize the colors, border, fonts, and transparency similar to a Data View.

Colors

The differences in customization for Flex Grid colors are as follows:

  • Grid. Customization of the whole Grid at once instead of every separate part so that value cells and headers are all uniform

    • Background. Customize every cell in the Flex Grid to one color. Headers, cells, and group background colors can be customized afterward

    • Foreground. Customize every value in every cell of the Flex Grid to one color, even Headers. If you want to customize headers to have a different color text, customize them under "Fonts"

    • Borders. Add a color to the all Flex Grid borders. This will add a border to every cell in the Grid, even headers. Headers and cells border colors can be customized afterward

  • Header. Customizes header background and border color

    • Header background. Customize the column header background color. If done after customizing Grid, the cells other than the column headers stay the same

    • Header border color. Customize the header border color. If done after customizing Grid, the borders other than the column headers stay the same

  • Cell. Customizes cell background and border colors, horizontally and vertically

    • Horizontal border color. Customizes only the cell horizontal border color

    • Vertical border color. Customizes only the cell vertical border color

  • Group. Customize the cell background for groups and totals

    • Group background. Customizes the color of cells for groups

    • Total background. Customizes the color of cells with total values
      contents/assets/images/FG.format.colors.PNG

Fonts

The differences in customization for Flex Grid fonts are as follows:

  • Header font. Customize the font size, style, and color of the header value or text

  • Cell font. Customize the font size, style, and color of the cell value or text

  • Group font. Customize the font size, style, and color of the group value or text

  • Total font. Customize the font size, style, and color of the total value or text
    contents/assets/images/fg.format.fonts.PNG

Design priority hierarchy

  1. The color customization from the Object properties panel is the lowest priority

    • The “Grid” section is the lowest priority of the color customization within the Object properties panel, and the formatting can be overridden by customizing "Header", "Cell", and/or "Group"

  2. The Block format is the next priority, which will override the color customizations made from the Object properties panel

  3. The Row style Template is the highest priority and will override any Object formatting.

    When a parent Entity is customized with the Row style template formatting, all its children will also have the same formatting. When there are two default formats, the highest hierarchical Entity will override the other format. For example, if year and quarter are formatted, the year format will override the quarter format

Learn more about:


Was this article helpful?