Tag Cloud Widget
This widget belongs to the Dashboards category in the widget library. For a given measure, it provides a graphic display of the text values of dimension elements in a tag cloud. The importance of a keyword in the tag cloud is determined by its frequency, i.e. the number of occurrences in the data source. This is highlighted accordingly by its font size and color.
You can define the visual aspect of the tag cloud using different properties, e.g. text color, rotation, font, etc.
Examples
Data in the CSV file
- Dimension = Location
- Measure = Number of equipment
- Elements displayed: Words corresponding to locations, graphically formatted based on the importance of the number of equipment
Download
Different graphic displays for the Number of incidents by location tag cloud
Spiral display, text rotated and tooltip | Rectangular display, letters in the uppercase, selected value = 230 |
---|---|
![]() |
![]() |
Notes
- The Tag Cloud widget requires a data source that will retrieve a report, view or CSV file with two columns (grouping levels), i.e. Label and Value.
Note: If the data source contains several columns, you should use the Data Transformer to select the two columns you want.- Column 1: Dimension
- Column 2: Values of the measure elements to be displayed
- The font size of each keyword is proportionate to the value of the dimension element in the data source.
- Each keyword is displayed in the color associated with its value in the legend axis.
- In execute mode:
- Tooltips appear when you move the cursor over each keyword.
- When you click a value in the legend axis, all keywords corresponding to this value will appear in black.
Caution
- The tag cloud displays text data. If the keywords to be displayed contain numbers, they will be interpreted as text data and not as Integer or Float data.
List of properties
Content
DataSource
Data Source: External data source associated with the widget.
- The drop-down list displays all of the data sources available in the app.
- To modify the data source or to view its contents, you should click
. The
button below the Preview property shows the number of rows (max. 15) and columns extracted.
- To define a new data source, click
Add Data Source in the Objects pane.
DataTransformer
Data Transformer: Used to define the structure and scope of the data source, apply statistical aggregate functions and modify the order of the measures displayed.
- Click Setup / Preview Data below the Data Transformer property to open the dedicated window.
See the description.
EnableDrilldown
Enable Drilldown (Note: Only for an EasyVista data source data source using a view with grouping levels): Used to indicate if data is aggregated (box is checked - the drill-down functionality is enabled) or not (box is not checked).
example Breadcrumbs widget: Breakdown of equipment by location.
- If you want the widget to display the breakdown in a grouping level, you should not check this box.
- Add a Breadcrumb widget to facilitate navigation within grouping levels.
Data
SortByValueDescending
Sort By Value Descending: Used to sort dimension elements in descending order (if the box is checked, from highest to lowest value) or in the order in which they are read in the data source (box is not checked). Note: The order applied is determined by the dimension elements of the first measure in the data source.
example You want to display the chart for incidents and requests per employee
The data source contains the Department dimension with three elements.
Box is checked | Box is not checked |
---|---|
The dimension elements of each measure are sorted in descending order. |
The dimension elements of each measure are displayed according to the sort order of the data source. |
FirstRowContainsDimensionElements
First Row Contains Dimension Elements: Used to specify the structure of the data source by indicating if dimension elements are found in the first column (box is not checked: standard data source structure) or in the first row (box is checked). Note: This property does not affect the behavior of the Data Transformer.
MaximumNumberOfData
Maximum Number Of Data: Used to indicate the maximum number of dimension elements to be loaded from the data source for each measure selected in the data source.
You should use this property to prevent loss of performance when data volume is large.
- The count is always performed from the first dimension element.
- When the number of dimension elements to be loaded is greater than the number of dimension elements in the data source, all of the data is loaded.
- To view the data source, click
next to the Data source property, then click
button below the Preview property which shows the number of measures and the number of dimension elements for each measure.
example You want to display the chart for incidents and requests per employee
The data source contains the Department dimension with three elements.
|
|
|
---|---|---|
All dimension elements are loaded and displayed for each measure, i.e. the three departments. |
Only the first two dimension elements are loaded and displayed for each measure, i.e. the first two departments. |
All dimension elements are loaded but only the first element is displayed. This corresponds to the Sales department. The Others dimension element groups values from the Marketing and Administration departments. |
MaximumNumberOfDisplayedData
Maximum Number Of Displayed Data: Used to indicate the maximum number of dimension elements to be displayed for each measure selected in the data source. This improves chart readability.
example You want to display the chart for incidents and requests per employee. See the Maximum Number Of Data field.
- The count is always performed from the first dimension element.
- When the number of dimension elements to be displayed is less than the number of dimension elements to be loaded, the Others dimension element will automatically be added to the chart. It will aggregate all of the values from non-displayed dimension elements.
Charts
Position: Keyword display type.
- Spiral: Keywords are displayed in a spiral.
- Rectangle: Keywords are displayed in a rectangle.
Spiral | Rectangle |
---|---|
![]() |
![]() |
Color Range: Used to indicate if the legend axis should be displayed below the chart (box is checked) or not (box is not checked).
- The color of each segment in the axis is determined by the theme.
Series Angle: Series of values indicating the rotation angle of keywords.
- You can specify a value between -180 to 180.
- If you enter 0, this means that keywords will be displayed horizontally with no rotation.
- If you enter -180 or 180, this means that keywords will be displayed horizontally upside down, i.e. with a rotation of 180°.
- You can enter several values. They will be assigned randomly to the keywords.
Text Spacing: Space, in pixels, between keywords.
Space: 0 | Space: 10 |
---|---|
![]() |
![]() |
Text Appearance: Upper or lowercase for keywords.
- Normal: Display in standard case.
- Uppercase: Display in the uppercase.
Normal | Uppercase |
---|---|
![]() |
![]() |
Font Family (Inherit) | (1) | Text font selected using Select Font | ![]() |
Size | (2) | Font size | |
Style (Inherit) | (3) | Font style, i.e. bold, italic, underlined | |
Text Color (Inherit) | (4) | Text color. |
Common
Measure Data Type: Used to define the display format of values in the tag cloud.
- Integer: Used to display whole numbers rounded up or down to the nearest unit.
152200.10 ==> 152200
- Float: Used to display values with two decimal places by default.
- To modify the default number of decimal places, uncheck the Default Float Precision box and select the value you want in the Float Precision property.
152200 ==> 152200.00
- To modify the default number of decimal places, uncheck the Default Float Precision box and select the value you want in the Float Precision property.
AdvancedDashboards_Common_DisplayPrintExportButton
Display Print and Export Button: Used to indicate if users can save and print the chart (box is checked) or not (box is not checked). If users can save and print it, the and
icons will appear. Note: The icons are always displayed to the right of the chart.
: Used to save the chart in a JPG file.
: Used to print or save the chart in a PDF file.
AdvancedDashboards_Common_DisplayAreaColor
Display Area Color: Used to indicate if a specific color should be applied to the background (box is checked) or not (box is not checked). If you want a background color, you should select it in Chart Area Color.
- The area of the background is delimited by the dimension axis and the measure axis.
- To apply a background color to the entire chart, use the Theme > Background Color property. The background color defined in the Display Area Color property will have priority.
Background color defined (box is checked) | White background (box is not checked) | Background color for the entire chart (Theme property) |
---|---|---|
![]() |
![]() |
![]() |
Title
AdvancedDashboards_Common_DisplayChartTitle
Display Chart Title: Used to indicate if a title should be added to the chart (box is checked) or not (box is not checked). If you want to add a title, you should enter it in Chart Title and define its format.
Display format of the chart title: e.g. font, background color, text color, etc.
PageGeneralFormat
Font Family (Inherit) | Font of the text, selected via Select Font | ![]() |
|
Size | Font size, selected via the slide or specified directly in the field | ||
Alignment (Inherit) | Alignment of the text (Left/Center/Right/Justified) | ||
Style (Inherit) | Font style of the text Bold/Italic/Underline) | ||
Background Color (Inherit) | Background color of the widget | ||
Text Color (Inherit) | Color of the text displayed by the widget
Note: Priority is given to the font and color defined using the text editor |
Color Palette
AdvancedDashboards_Common_ColorPalette
Chart Color: Color palette applied to the chart. This is used to define the color of chart data and the color of legend buttons.
- The list is provided by
.
- The number of colors in the palette is indicated next to its name, e.g. Brown (6), Default (12), EasyVista (7).
- The color of other chart elements, e.g. axis title and labels, chart title and tickmarks, are defined using specific properties.
Tooltip
AdvancedDashboards_CommonTooltip
Display Tooltip: Used to indicate if data labels should be displayed in a tooltip when the cursor hovers over the chart (box is checked) or not (box is not checked). If you want to display tooltips, select the information to be displayed from the Label list.
- Information displayed by default when the cursor hovers over each data point: Value of the dimension axis / Value of the measure axis
- Define the display format using the properties below.
Tooltip Display Mode (Note: Only if the Display Tooltip box is checked): Used to define the information displayed when the cursor hovers each data point.
- Single: Value of the dimension axis / Value of the measure axis
- Union: Value of the dimension axis / All values of the measure axis
Current value of the measure axis (Single option) | All values of the measure axis (Union option) |
---|---|
![]() |
![]() |
Position (Note: Only if the Display Tooltip box is checked): Position of the data point's tooltip based on the movement of the cursor.
- Float: The tooltip will move along with the cursor.
- Point: The tooltip always appears above the data point regardless of the position of the cursor.
Theme
See the description of properties.