Creatio base
This documentation is valid for Creatio version 7.16.0. We recommend using the newest version of Creatio documentation.

Setting up the “Chart” dashboard tile

A chart setup page (Fig. 1) will open when you add or edit a chart on a dashboard panel. Here you can set up the primary chart parameters: – data, title, filters and display conditions.

Fig. 1 Chart setup page.

chapter_analytics_add_analytics_to_page_chart_setup_example.png 

[Title] – the chart name that will be displayed on the dashboard tile.

[X-axis label] and [Y-axis label] – the labels of X and Y-axes that will be displayed on the chart. These fields are only displayed for the charts that contain axes (“spline”, “line”, “area chart” and “scatter chart”).

What to display

[Object] – Creatio object (section, detail or lookup) whose records you want to use for building the chart. For example, to calculate the average call duration (calls are activities of the “Call” category), select the “Activity” object.

[Function] – the type of value that should be displayed on the chart. The following chart functions are available:

  • “count” – the value is used to build a chart by the number of records in the selected Creatio object. For example, you can calculate the number of activities of each type.

  • “maximum”, “minimum”, and “average” – the values calculated by numeric column (or a date column with the exception of the “average” function) in the specified object. For example, you can calculate the average duration of employee activities.

  • “sum” – the sum of values of the specified numeric column of the selected object. For example, you can calculate the employee's total activity duration for a week.

[Column] – the column to be used in the calculation. The list includes numeric columns and date columns. For example, specify the “Duration (minutes)” value to calculate the average call duration by managers (Fig. 2). This field is not displayed if the “count” value is selected in the [Function] field.

[Chart type] – the type of the chart: “Bar chart”, “Pie chart”, etc.

[With stacked] – select the checkbox to display the chart with total sums of certain “stacked” values. A “with stacked” chart displays the result of calculations as a total sum of separate data types represented by the chart columns. The size of each column depends on the value of a corresponding data element. This chart type may be useful if you need to compare both, the total sums and separate values of data. For example, the chart can simultaneously display the opportunity amount at each stage by different employees or the contribution of each stage in the total sum.

The [With stacked] checkboх displays for the “Column” and “Bar” chart types. If you set up a chart with several series, the “With stacked” checkbox will apply to all the series. If you select this checkbox for one series of the chart, it will automatically be selected for all the series of the chart with the “Column” and “Bar” types. Similarly, if you deselect it in one of the series, it will be automatically deselected for all the chart series.

[Show legend] – select the checkbox to display the legend for the chart. The legend displays the chart color and the text entered in the [Index number caption] field at the top of the configured dashboard. If the [Index number caption] field is not populated, the legend displays the name of the object that was used to configure the dashboard.

The [Show legend] checkbox displays for the following chart types: “Spline,” “Line,” “Area,” “Scatter,” “Column,” or “Bar.”

Fig. 2 Setting up the [What to display] field group for a chart

chapter_dashboards_what_to_show_graph.png 

How to group

[Column] – the column to group the chart values by (each value in this column will be represented as a separate chart element – bar, sector, etc.). For example, to calculate the number of new activities within a specific time period, specify the “Created on” value. You can group data by any column of the selected object.

[Format] – the format of dates that will be displayed on the chart, for example, “Week” or “Month & Year”. This field is displayed if the date value is selected in the [Column] field in the [How to group] block. For example, to see the number of new activities by months, specify “Month and year” in the [Format] field and “Created on” in the [Column] field.

Fig. 3 Setting up the [How to group] field group for a chart

chapter_dashboards_how_to_group_graph.png 

[Use empty value] – if the checkbox is selected, the chart will include the records, whose grouping column is not populated (Fig. 4).

Fig. 4 “Opportunities by category” chart including empty values

chapter_dashboards_show_empty_values.png 

How to sort

[Sort by] – the value to sort chart areas by. For example, the values in the “Activities by owner” chart are grouped by the [Owner] field, with each chart block representing a certain number of activities. Select “By grouping field” to sort chart areas alphabetically (in this case by the [Owner] field) or select “By selection result” to sort chart areas by number of activities.

[Sorting order] – the sorting order for the chart areas (by the values selected in the [Sort by] field) in ascending or descending order (Fig. 5).

Fig. 5 Setting up the [How to sort] field group for a chart

chapter_dashboards_how_to_sort_graph.png 

How to filter

Use the standard filter area to filter the chart data. For example, to create a chart that displays how contacts were added within the specified time period, specify the needed period in the filter conditions, for example, “Created on = Current month” (Fig. 6).

Fig. 6 Setting up the [How to filter] field group for a chart

chapter_dashboards_how_to_filter_graph.png 

The filter becomes available when the [Object] field is populated.

Note

You can find more information about the advanced filter in a separate article.

How to associate with section data

[Connect ... object with ... section by field] – select a chart object column in this field if you want to display the data according to the section filters. If you leave this field unpopulated, the applied section filters will not affect the chart data. The field will be populated automatically if you configure dashboards for the object of the current section. The field is displayed if the [Object] field is populated and is not available at all if you configure charts in the [Dashboards] section.

You can connect a chart to section records in a number of ways.

1.The chart is built based on the records of the current section (the chart object corresponds to the section object). For example, when creating a chart in the [Activities] section, you select “Activity” in the [Object] field. In this case, the connection field is populated automatically with the [Id] column.

a.If you select the [Id] column in the field (Fig. 7), the chart will be built based on the records that correspond to the filter conditions specified in the section. For example, if you apply a filter to the [Activities] section list so that only completed activities are shown, the “Activities by owner” chart will display only the information related to the completed activities.

Fig. 7 Connecting a chart to a section by the “Id” field

chapter_dashboards_how_to_associate_same_section.png 

b.If you clear the connection field, the chart will display the information for all section records, regardless of the set filter conditions.

2.The chart is based on the records from another section (the chart object is different from the section object). For example, there is an “Activities by owner“ chart added to the [Contacts] section to display number of activities by owner. The chart object columns available for selection in the [Connect…] field are filtered according to the current section object (in this case, the available columns will be [Contact], [Owner], [Created by], etc.).

a.If you populate the [Connect…] field (Fig. 8), the chart will use only records that are connected to the section records via the specified column. Then, if you set a filter in the [Contacts] section, the chart will only display the information related to the activities whose owners are displayed in the section. Or you can select the “Author“ column – in this case, the chart will only display the information related to the activities added by the specified contacts.

Fig. 8 Connecting a chart to a section by the “Owner“ field

chapter_dashboards_how_to_associate_other_section.png 

b.If you leave the connection field unpopulated, the chart will display the information for all records of the chart object, regardless of the section filter conditions.

c.The chart data may not be related to the section data at all (in this case, the [Connect…] field should also be left empty). For example, you can add the “Activities by owner” chart to the [Knowledge base] section.

How to display

[Format]] – the display format for the metric. The display format is set up in a separate window. To open the window, click btn_com_lookup.png. Specify the accuracy of the fractional part of the numeric indicator, i.e. the number of digits after decimal point. For example, set the “1” value to display the metric number with one digit after decimal point. To display the digit without the fractional part, set the number of digits to “0”.

If the chart has more than one  series, you can specify the rounding parameters for each chart series separately.

[Style] – select the color of the dashboard tile title and chart elements.

[Х-Axis label], [У-Axis label] – you can specify labels for X- and Y-Axes for each chart series. These fields (Fig. 9) are only displayed for the charts that contain axes (“spline,” “line,” “area chart,” and “scatter chart”).

[Index number caption] – you can specify the text that will display at the top of the dashboard for each chart series.

The field displays for the following chart types: “Column,” “Bar,” “Pie,” and “Pipeline.”

Fig. 9 Example of setting up the [How to display] group of fields for the “Spline,” “Line,” “Area,” and “Scatter” chart types

chapter_dashboards_how_to_show_graph.png 

Note

If you populate both the [X-axis label], [Y-axis label] as well as [Х-Axis label of series] and [У-Axis label of series] fields, a single-series diagram will display the values of the [X-axis label] and [Y-axis label] fields.

Displaying several series on a chart

You can display several sets of data called “series” on your chart. For example, you can display meetings and calls of employees on separate series (Fig. 10).

Fig. 10 Example of a chart with two series

chapter_dashboards_multi_series.png 

To add a series to a chart:

1.In the btn_com_menu_gear00008.png button menu of the chart setup page, select the [Add series] command (Fig. 11).

Fig. 11 Adding a new series to a chart

chapter_dashboards_add_series.png 

2.On the new series tab, populate the required fields and save the page.

3.Save the chart setup page and the dashboard setup page that contains the chart.

As a result, the chart will display the new data series.

If one of the series contains a chart that is not compatible with other series, Creatio will use the first selected chart type for all series. For example, if you select a “Line” chart for the first series and a “Bar” chart for the second series,  both charts will be displayed as a “Line” chart (Fig. 12).

If you select the [With stacked] checkbox in one of the series of the “Column” or “Bar” chart type, it will be automatically selected for all the series of the corresponding “Column” or “Bar” chart. In this case, the chart will display as a column chart with stacked or a bar chart with stacked.

Fig. 12 Chart compatibility

chapter_dashboards_compatibility_chartJS.png 

To copy the series and create a derivative series with the same settings:

1.Select the series tab you want to copy.

2.In the btn_com_menu_gear00009.png button menu of the chart setup page, select the [Copy series] command (Fig. 13).

Fig. 13 Copying the series

chapter_dashboards_copy_series.png 

As a result, the chart setup page will display the added copy of the series. Change the settings of the series, for example, the column to be used in the calculation, the display period, etc.

To delete the series:

1.Select the series tab you want to delete.

2.In the btn_com_menu_gear00010.png button menu of the chart setup page, select the [Delete series] command (Fig. 14).

Fig. 14 Deleting a series from chart

chapter_dashboards_delete_series.png 

Save the chart setup page and the dashboard setup page that contains the chart.

See also

Diagram mode

List mode

Viewing chart element details

Dashboard tabs

Dashboard setup

Did you find this information useful?

How can we improve it?