Visualizations → Tag Cloud
About a Tag Cloud visualization
A tag cloud visualization is a chart that helps visualize text data and is mainly used to conduct the word-frequency analysis across tags, keywords, and so on. Tags are usually single words, and the font size of each tag indicates its measure.
The distinction between a visualization and an insight is that an insight is an instance of the visualization. As an instance, an insight has unique configurations that a dashboard developer determines for displaying a chart on a dashboard tab. Insight configurations affect the available user interactions for a dashboard consumer such as the ability to drill down into a grouping dimension.
With three possible dimensions, a tag cloud visualization offers a dashboard developer the ability to create an insight that groups one or more aggregated or calculated values by one or more attributes. The result is a tag cloud chart on a dashboard tab that shows:
- a grouping dimension as the text
- a measure as the size of the text
- a coloring dimension as text color
The Color By (coloring dimension) tray is available starting with the Incorta Cloud 2022.9.0 release.
Configurations for a tag cloud insight
A dashboard developer first selects a tag cloud visualization for an insight in the Analyzer. Using the Analyzer, a dashboard developer configures pill properties, filter properties, and insight settings. Insight settings and pill properties determine not only how the tag cloud chart appears as an insight in a dashboard tab, but also how a dashboard consumer can interact with the tag cloud chart.
The visualization selection in the Insight panel of the Analyzer determines the available trays. From the Data panel, a dashboard developer adds a column or a formula to a tray. A column or a formula in a tray is a Pill.
Each pill has configurable properties. The parent tray determines the available properties of a pill.
The available trays for a tag cloud insight are:
- Grouping Dimension
- Measure
- Color By
- Individual Filter
Grouping Dimension
From the Data panel, you can add several columns or formulas to the Grouping Dimension tray. The tag cloud insight plots the first pill in the Grouping Dimension tray.
Each pill in the Grouping Dimension tray is a filterable column for the insight. The pill ordering in the grouping dimension tray defines the following:
- the first pill plots the tags
- the other pills define an order of user interactions that allow a dashboard consumer to drill down into the next grouping dimension and in doing so, also create one or more dashboard runtime filters
Measure
To create an aggregation or calculation, you can add a column or a formula from the Data panel to the Measure tray.
You can select the measure pill to open the Properties panel. In the Properties panel, you can configure various properties such as the Aggregation and Format properties.
Color By
From the Data panel, you can add a column or a formula to the Color By tray. The text in the chart is grouped by the column added to the Color by tray into colored groups.
The Color by pill is a filterable column for the insight. A defined coloring dimension introduces a Filter by menu as a user interaction for the tag cloud chart.
Individual Filter
To filter data for the tag cloud insight, define an individual filter for the insight. You can add a column or a formula to the Individual Filter tray from the Data panel.
You can select the individual filter pill to open the Filter panel. Using the Filter panel, you can specify the filter operator, one or more filter values, or the filter expression itself with the Formula Builder. You can also disable the individual filter.
To learn more about filter expressions for an individual filter, review Concepts → Individual Filter.
Pill properties
The parent tray determines the available properties of a pill. There are various possible configurations for each pill type:
- Grouping dimension pill properties
- Measure pill properties
- Color By pill properties
- Individual filter properties for a filter expression
You can edit the properties of a grouping dimension or a measure pill with the Properties panel for a tag cloud insight.
To create a filter expression, you can edit the properties of an individual filter pill with the Filter panel.
In the case of the Filter property of a measure pill, you can open the Filter panel from the Properties panel to create the filter expression.
To open the Properties panel or Filter panel, select the pill arrow.
Grouping dimension pill properties
Here are the properties for a pill in the Grouping Dimension tray in a tag cloud insight:
| Property | Control | Description |
|---|---|---|
| Column fully qualified name | label | The fully qualified name of the selected column. This property is available only when you edit the properties of a column in the tray. Select the information icon (the letter i in a circle) to preview the column function (dimension, key, or measure) and sample data. You can also use the Copy Column Name option (two paper sheets icon) to copy the column’s fully qualified name. |
| Formula | text box | Select this property to invoke the Formula Builder and create the formula expression you want. This property is available only when you edit the properties of a formula added to the tray. |
| Data → Column Label | text box | Enter the label for the grouping dimension column or formula |
| Data → Date Part | drop down list | When the selected column is a date or timestamp, select the part of the date used. The options are: ● Full (default) ● Year ● Quarter ● Month ● Day |
| Data → Hierarchy | toggle | This option is available only for columns from objects with data hierarchy (physical schema objects with a self-join relationship). Enable this property to specify the level of data in the hierarchy that you want to include in the insight for the respective column. |
| Hierarchy → Level | text box | Enable Hierarchy to configure this property. Enter a numeric value that represents the level of data you want to include in the insight. Leave blank or enter "-1" to include all levels. |
| Data → Sort By | drag and drop | Drag the column or formula to sort the columns by |
| Format → Date Format | select | Select the format of the formula or date column. This option is available only when you edit the pill properties for a date column or a formula |
| Format → Date Mask | text box | Enter a customized date format or select a predefined one to appear in this text box |
| Format → Quarter/Month Format | drop down list | Select the format of the date column. The options are: ● No Format ● Prefix ● Short ● Long. This property is available only when you set Date Part to Quarter or Month. |
| Drill Down → Dashboards Drill Down | link | Select + Add Dashboard to select a dashboard tab to drill down to when the user selects a grouping dimension value in the insight |
| Add Dashboard → Include Runtime Filters | toggle | Enable this property to pass the applied filter, if any, from one dashboard to another |
| Add Dashboard → Search Dashboard | text box | Enter a search string to filter the dashboard tree. From the results, select a dashboard tab to drill down to. |
Measure pill properties
The parent tray determines the available properties of a pill. Select the arrow to the right of the pill name to open the Properties panel and configure the related properties.
Here are the properties for the pills in the Measure tray in a tag cloud insight:
| Property | Control | Description |
|---|---|---|
| Column fully qualified name | label | The fully qualified name of the selected column. This property is available only when you edit the properties of a column in the tray. Select the information icon (the letter i in a circle) to preview the column function (dimension, key, or measure) and sample data. You can also use the Copy Column Name option (two paper sheets icon) to copy the column’s fully qualified name. |
| Formula | text box | Select this property to invoke the Formula Builder and create the formula expression you want. This property is available only when you edit the properties of a formula added to the Measure tray. |
| Data → Column Label | text box | Enter the label of the measure |
| Data → Date Part | drop down list | When the selected column is a date or timestamp, select the part of the date used. The options are: ● Full (default) ● Year ● Quarter ● Month ● Day |
| Data → Aggregation | drop down list | Select the aggregation option for the measure values. There are different available options. The options are: ● Average ● Count ● Distinct ● Median ● Min ● Max ● Sum ● Formula ● None |
| Data → Scale | drop down list | Select the chart scale. The options are: ● None ● Percent (%) ● Thousands (K) ● Millions (M) The default is None. |
| Data → Running Total | toggle | Enable this property to display the measure values as a running total |
| Data → Filter | drag and drop | Drag a column or formula to filter the measure |
| Format → Number Format | select | Select the format of the measure (e.g. Dollar Rounded) |
| Format → Decimal Places | text box | This property appears when you select Decimal, Dollar, Euro, Yen, or Percent as the Format. Enter the number of decimal places to display for the measure value. |
| Format → Thousands Separator | toggle | This property appears for all Format options, except No Format. Enable this property to include a comma separator for values of 1000 or greater. |
| Format → Percentage | toggle | Enable this property to view the percentage value of the columns |
| Format → Prefix | text box | Enter value to add a prefix and create a custom format. The value of the prefix field cannot contain single quotes. |
| Format → Suffix | text box | Enter value to add a suffix and create a custom format. The value of the suffix field cannot contain single quotes. |
| Format → Abbreviate on Hover | toggle | Enable this property to abbreviate the measure value upon hover |
| Format → Color | icon | Select to change the text color of the tag cloud visualization |
| Drill Down → Dashboards Drill down | link | Select + Add Dashboard to select a dashboard tab to drill down to when the user selects the measure value in the insight |
| Add Dashboard → Include Runtime Filters | toggle | Enable this property to pass a filter from one dashboard to another |
| Add Dashboard → Search Dashboard | text box | Enter a search string to filter the dashboard tree. From the results, select a dashboard tab to drill down to. |
| Advanced → Base Field | drag and drop | Drag the column to join two tables that are not directly joined. |
| Advanced → Query Plan | button | Select this property to reveal the direct data map path that the Incorta Analytics Service uses to retrieve or calculate the measure |
Color by pill properties
Here are the properties for a pill in the Color by tray in a tag cloud insight:
| Property | Control | Description |
|---|---|---|
| Column fully qualified name | label | The fully qualified name of the selected column. Select the information icon (the letter i in a circle) to preview the column function (dimension, key, or measure) and samples of the column data. You can also use the Copy Column Name option (two paper sheets icon) to copy the column’s fully qualified name. |
| Formula | label | Select this property to invoke the Formula Builder and create the formula expression you want. This property is available only when you edit the properties of a formula added to the tray. |
| Data → Column Label | text box | Enter the label for the Color by pill |
| Data → Date Part | drop down list | When the filter column is a date or timestamp, select the part of the date used. The options are: ● Full (default) ● Year ● Quarter ● Month ● Day |
| Data → Sort by | drag and drop | Drag the column or formula to sort the columns by |
| Format → Color Palette | toggle | Enable this property to display the color palette, which allows you to change the color of the category |
| Format → Date Format | drop down list | Select the format of the formula or date column. This option is available only when you edit the pill properties for a date column or a formula |
| Format → Date Mask | text box | Enter a customized date format or select a predefined one to appear in this text box |
| Advanced → Base Field | drag and drop | Drag the column to join two tables that are not directly joined. |
Individual filter properties for a filter expression
To filter individual rows for the tag cloud insight, define an individual filter. You can add a column or a formula to the Individual Filter tray from the Data panel.
Individual filter properties for a filter expression with a column as a pill
Here are the properties for a filter expression with a column as a pill in the Individual Filter tray for a tag cloud insight:
| Property | Control | Description |
|---|---|---|
| Column fully qualified name | label | The fully qualified name of the selected column. This property is available only when you edit the properties of a column in the tray. Select the information icon (the letter i in a circle) to preview the column function (dimension, key, or measure) and sample data. You can also use the Copy Column Name option (two paper sheets icon) to copy the column’s fully qualified name. |
| Data → Column Label | text box | Enter the label for the individual filter |
| Date Part | drop down list | When the filter column is a date or timestamp, select the part of the date used. The options are: ● Full (default) ● Year ● Quarter ● Month ● Day |
| Operator | drop down list | Select the operator to use in the filter criteria |
| Values | multi-select | Select the value(s) to evaluate the column value against. Some operators do not require a value to evaluate against, such as Null and True. If applicable, enter a string in the search bar to filter the list of values. To add a value to the list, enter it in the text box below the list and select +. |
| Advanced → Disable Filter | toggle | Enable this property to disable the filter. Disabled filters are deleted when you save the insight. |
Individual filter properties for a filter expression with a formula as a pill
Here are the properties for a filter expression with a formula as a pill in the Individual Filter tray for a tag cloud insight:
| Property | Control | Description |
|---|---|---|
| Formula label | label | The formula label text |
| Data → Column Label | text box | Enter the label for the measure formula |
| Formula → Dynamic | toggle | Enable this property to select a filter expression session variable as a value |
| Formula | text box | Disable Dynamic to configure this property. Enter the formula in the Formula Builder to create the filter expression. |
| Operator | drop down list | Select the operator to use in the filter criteria |
| Values | multi-select | Select the value(s) to evaluate the column value against, if required. Some operators do not require a value to evaluate against, such as Null and True. In the case that you enable Dynamic, select a filter expression session variable. If applicable, enter a string in the search bar to filter the list of values. To add a value to the list, enter it in the text box below the list and select +. |
| Advanced → Disable Filter | toggle | Enable this property to disable the filter. Disabled filters are deleted when you save the insight. |
Settings panel
With the Settings panel, you can configure additional properties for the tag cloud insight. To open the Setting panel, in the Analyzer, select Settings (gear icon) in the Action bar.
| Property | Control | Description |
|---|---|---|
| General → Max Rows Limit | text box | Enter the maximum number of categories to show in the chart. A value lower than the number of the insight query rows returned will restrict results. A value of 0 will include all rows. |
| Logarithmic | toggle | Enable this property to display the text on a logarithmic scale |
| General → Auto Refresh | toggle | Enable this property to automatically update the insight when the underlying data is updated |
| General → Data Sampling | toggle | Enable this property to use and analyze a representative subset of data in the insight |
| Advanced → Max Groups | text box | Set the maximum number of groups that cannot be exceeded in the insight |
| Advanced → Join Measures | drop down | Select Yes to calculate the group-by function across joined tables |
User interactions for a tag cloud insight
As a dashboard consumer, you can interact with a tag cloud insight on a dashboard tab. Some interactions will affect only the tag cloud chart. Other interactions will affect both the tag cloud chart and the dashboard. The creation of one or more dashboard runtime filters is an example of a user interaction that affects all applicable insights on all tabs of a dashboard.
Some user interactions require specific configurations by a dashboard developer and therefore may not be available.
Here are the possible types of user interactions for a tag cloud insight:
- Select a text to drill down into a grouping dimension and in doing so, create a dashboard runtime filter
- Select a tag to open the Filter By menu and select an option to drill down into a grouping dimension and in doing so, create a dashboard runtime filter
- Select a dashboard tab to navigate to in the Go To menu
A dashboard runtime filter affects all applicable insights on all tabs of a dashboard. A dashboard runtime filter appears as a filter bar pill and displays the filter expression.
More Options menu for a tag cloud insight
Role-Based Access Control (RBAC) enforces access to certain features and functionality. With Discretionary Access Control (DAC), a user who owns the dashboard can control the access to the dashboard. Access rights include the ability to view, share, and edit the dashboard. Together, RBAC and DAC affect the available selections in both the Action bar and the More Options menu for an insight.
For more information about RBAC and DAC, refer to the Security Manager documentation.
In addition, certain tenant configurations by a Cluster Management Console (CMC) Administrator affect the available selections in the More Options menu for an insight.
Download
- For the tag cloud insight, select More Options (⋮ vertical ellipsis icon).
- Select Download.
- Select the download file format:
- PNG
- JPEG
- SVG
View as Table
The View as Table is an Incorta Labs feature and a tenant configuration. A CMC Administrator must enable the feature.
To view a tag cloud insight as a Listing Table or Aggregated Table, follow these steps:
- For the tag cloud insight, select More Options (⋮ vertical ellipsis icon).
- Select one of the following options:
- View as Regular Table
- View as Aggregated Table
For a Listing Table or Aggregated Table, you can:
- Download as CSV, xlsx, or PDF
- Send to a Data Destination
Set Alert
You can set an alert that identifies specific changes to a tag cloud insight by defining a filter expression for a measure filter and/or individual filter.
- For the tag cloud insight, select More Options (⋮ vertical ellipsis icon).
- Select Set Alert. Refer to the Scheduler document for additional information on Data Alerts.
Open Lineage
Starting with 2023.7.0, you can view the data lineage of each insight on the dashboard. The Data Lineage Viewer v2 displays the entities (tables, views, variables, and columns) that the insight references.
- For the tag cloud insight, select More Options (⋮ vertical ellipsis icon).
- Select Open Lineage. The Data Lineage Viewer v2 opens displaying the data lineage diagram of the insight.
Steps to create a tag cloud insight
For an existing dashboard, to create a Tag Cloud Insight for a given dashboard tab, follow these steps:
- If not already open, open a dashboard.
- To add a new insight to the dashboard, in the Action bar, select +.
- If needed, in the Analyzer, in the Data panel, select Manage Dataset.
- In the Manage Data Sets panel, select one or more business schema views and/or one or more physical schema tables.
- To close the Manage Data Sets panel, select X or any other area of the Analyzer.
- In the Insight panel, select V.
- In Charts, select the Tag Cloud visualization.
- From the Data panel, drag various columns to various trays in the Insight panel:
- Grouping Dimension
- Measure
- Individual Filter
- Configure the pill properties using the Property panel or Filter panel.
- Configure various insight properties using the Settings panel.
After introducing the dashboard free-form layout in 2023.4.0:
- The steps to add an insight to a dashboard are as follows:
- In the Action bar, select Edit (pen icon).
- From the Insight panel, drag the visualization that you want to the canvas, and then hover over the new insight and select Edit (pen icon) to launch the Analyzer.
- To open an insight in the Analyzer, hover over the insight, and then select Edit (pen icon).
- The steps to edit the insight in the Analyzer are still the same.
Example of a tag cloud insight
In this example, you will create a tag cloud insight that compares revenue by product category, subcategory, and product per region. The example uses the SALES schema that comes with the Sample Data.
In the CMC, you can create a tenant that includes Sample Data. The Sample Data includes the SALES schema.
Add an insight starting 2023.4.0
- In the Action bar, select Edit (pen icon).
- From the Insight panel, from Charts, drag Tag Cloud to the canvas, and then hover over the new insight and select Edit (pen icon) to launch the Analyzer.
- In the Data panel, select Manage Dataset.
- In the Manage Data Sets panel, in Tables, select the SALES schema.
- Close the Manage Data Sets panel.
- From the Data panel, drag the following columns to the respective tray:
- From the Product table, drag Prod. Subcategory to the Grouping Dimension tray.
- From the Sales table, drag Revenue to the Measure tray.
- Edit the insight title to be Revenue by Product Subcategory.
- Select Save.
