Please enable JS

Build Donut Charts

July 10, 2019

Prolaborate provides a powerful yet intuitive tool to build Donut charts based on Enterprise Architecture data in minutes.

Note we will be looking only at the capabilities of chart widgets in this guide-; please refer to Dashboard Designer to learn about the general functionalities of the dashboard.

Build using Chart Designer

To create a Chart, click on Menu > Dashboards. Click on Add New to create a new dashboard or edit icon to edit a dashboard.

Click on Add Widget or Add icon on the bottom right to see the list of widgets. Click on EA Chart and then on Add New Widget.

Select Donut and click on Designer.

Follow these steps to create the chart:

  1. Choose the packages that contain the data for your chart i.e., the packages that has the EA objects which should be considered for the chart.
  2. Specify the Type or Stereotype to further filter the selection. Enable Fully Qualified Name to see full qualified names
  3. Choose the property which you are planning to represent using the chart under Build Chart based on. It can be any basic property or tagged value.
  4. Disable Subreport if you don’t want the charts to show in-depth information when your users click on the chart

Sample Configuration and Result



Build using SQL Queries

When you are building advanced charts using SQL queries, Chart query is used to build the charts and Result query is used to show in-depth information on click.

Donut chart will be created based on the property you define as “Series”.

For example, select object_type as series from t_object

To enable users to see in-depth information on click of a section of the chart, Aliases in Chart query need to be used in Result Query.

For example, if chart query is

select object_type as series from t_object

the respective result query will be

select name, object_type, stereotype where object_type = ‘<series>’

Additionally, you can use the following aliases in Result query:

a. Add alias “classguid” to the GUID - to see details of an item on click, For example: select name,ea_guid as classguid from t_object where object_type = ‘<series>’

b. Add aliases - Base Type and Stereotype to Type and Stereotype respectively to see appropriate EA icons, For example: select name, object_type as basetype, stereotype as stereotype from t_object where object_type = ‘<series>’ and stereotype= ‘<groupname>’

c. Prefix an alias with “hide_” to not see a column even when used in the query. For example, the following query will give the same result as above, but Base Type and Stereotype columns will not be shown in the result:

select name, object_type as hide_basetype, stereotype as hide_stereotype from t_object where object_type = ‘<series>’ and stereotype= ‘<groupname>’

Sample Query and Result

Chart Query

select o.ea_guid as Classguid, o.Object_type as BaseType, o.Stereotype as Stereotype, o.Name As GroupName, tv1.Value as Series from (t_object o left join t_objectproperties tv1 on tv1.Object_ID = o.Object_ID) where tv1.Property='Lifecycle'

Chart Shown on Dashboard

Result Query

select o.Stereotype as Stereotype, o.Name As Name, tv1.Value as Lifecycle, o.ea_guid as Classguid, o.Object_type as BaseType from (t_object o left join t_objectproperties tv1 on tv1.Object_ID = o.Object_ID) where tv1.Property='Lifecycle' and tv1.Value = '<series>'

Report shown when clicked on chart

Customization Options

The following settings are available:

  1. Legends position – You can position legend to place it on the Right or at the Bottom. You can change the options and check how they work by clicking on SeeChart Preview.
  2. Legend– Disable to hide the legend.
  3. Color Range – Pick the color range that needs to be used while displaying the chart
  4. Chart Data Color – Use this setting if you want to specify a particular color based on the data that will be showed in the dashboard.

For example, as per the configuration in the screenshot, the piece of Donut which has “High” as the data will show up in red color in dashboard.

Any questions? Contact us