View source for Chart Request

== Chart Request  ==

The chart request basically consists of the input of four elements 

*In – line style sheet 
*External style sheet 
*Data table 
*Chart type

In-line style sheet is not required, whereas the other two are. Charts are in this document understood as both those charts that are generated by the external Nevron component as well as Tables. The table “chart/diagram” is created by Catglobe itself, but is also using both in-line and external style sheets.<br>As part of understanding how the creation of charts relate to the data table supplied, we will in this chapter go through the limitations of different chart types in regards to what kind of data tables they can be used with.<br>Let us first review how the chart request flow looks. 

<br>

[[Image:Hinh 5.jpg]]<br>

''Illustration 4: Chart Request Model<br>''Notice that The Chart Creator Object should send back an error to the chart requester if the supplied data table does not fit in format to the requested chart type. 

=== <br>''Chart Type / Data Table''  ===

There exists a large number of chart types. With version 5.6 we added a great deal more and most likely we will add even more in the future. It is therefore technically extremely important that we do not code differences between these chart types into the GUI, but rather ensure that the unique factors of each chart type is a part of the chart type object itself. Hence the graphical user interfaces using and offering chart type selections should be able to look into the settings of any new chart type object and handle it based on the charts internal settings rather than the need to have new charts coded into the GUI itself (this can sound a bit confusing but I will later return to this subject since I believe some places in the system suffer from this).<br>An important part of charts is that they receive Series and Items. A Series consists of one or more items. Both Items and Series must always have a label (name). Depending on the chart type as well as style sheet settings, some charts may exclude the series or item labels from the final chart – but the labels are nonetheless always required.<br>Series are in Catglobe the columns of a data table and rows are the items.<br>If we look at the spread sheet below we see a data table with 1 series and 6 items. 

[[Image:Hinh 6.jpg]] 

Since both series and items must have labels the total view area is 2 columns and 7 rows. Now let us send this data table to the Chart Creator object with Chart Type = “Pie”. Result could e.g. be: 

[[Image:Hinh 7.jpg]]<br>

In this example we see that the series label is not shown.<br>Just from this example we already learned a number of things about the pie chart object. 

#Number of series: It can only have one series (nowhere to place data from additional series!) 
#Number of items: It can have any number of items (although too many may look bad)

Based on needs from the cross diagram viewer we will add a few additional settings about a chart type that will help a GUI handle them without GUI coding.<sup>1</sup> 

#Allow Show Results as Table (True/False) 
#Allow Show Type Both (True/False) 
#Allow 'Median' Statistics Item (True/False) 
#Allow 'Average' Statistics Item (True/False) 
#Allow 'Variance' Statistics Item (True/False) 
#Allow 'StdDev' Statistics Item (True/False) 
#Allow 'Percentile' Statistics Items (True/False) 
#Allow 'Significance' Statistics Item (True/False) 
#Allow 'StdError' Statistics Item (True/False) 
#Allow empty cells on Show Type Both (True/False) 
#Allowed column header levels (Integer) 
#Allowed row header levels (Integer) 
#Use in cross diagram viewer (True/False) 
#Use in spread sheet validation (True/False)

Let us now continue with all the different chart types that exist and how the above settings should be for each of them. 

'''''Chart Type Object Settings''''' 

{| style="width: 625px; height: 397px" cellspacing="1" cellpadding="1" width="625" border="1"
|-
! scope="col" | Chart type 
! scope="col" | 1 
! scope="col" | 2 
! scope="col" | 3 
! scope="col" | 4 
! scope="col" | 5 
! scope="col" | 6 
! scope="col" | 7 
! scope="col" | 8 
! scope="col" | 9 
! scope="col" | 10 
! scope="col" | 11 
! scope="col" | 12 
! scope="col" | 13 
! scope="col" | 14 
! scope="col" | 15 
! scope="col" | 16
|-
| Pie chart 
| 1 
| ∞ 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 0 
| √ 
| √
|-
| Line chart<sup>2</sup> 
| ∞ 
| ∞ 
| √ 
| √ 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| √ 
| &nbsp;
|-
| Bar chart 
| ∞ 
| ∞ 
| √ 
| √ 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| √ 
| &nbsp;
|-
| Bar-Line chart 
| ∞ 
| ∞ 
| √ 
| √ 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| &nbsp; 
| √
|-
| Radar chart 
| ∞ 
| ∞ 
| √ 
| √ 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| √ 
| √
|-
| Point chart 
| ∞ 
| 2<sup>3</sup> 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| <span style="color: #ff0000">√<sup>4</sup></span> 
| √
|-
| Table chart 
| ∞ 
| ∞ 
| &nbsp; 
| √ 
| √ 
| √ 
| √ 
| √ 
| √ 
| √ 
| √ 
| √ 
| 2 
| 2 
| √ 
| √
|-
| Area chart 
| ∞ 
| ∞ 
| √ 
| √ 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| <span style="color: #ff0000">√</span> 
| √
|-
| Funnel chart 
| 1 
| ∞ 
| √ 
| &nbsp; 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 0 
| <span style="color: #ff0000">√</span> 
| √
|-
| Bubble chart 
| 3 
| ∞ 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 1 
| 1 
| <span style="color: #ff0000">√</span> 
| √
|-
| Radial gauge chart 
| ∞ 
| 1;2 
| √ 
| &nbsp; 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| 
| 
| 
| 0 
| 1 
| &nbsp; 
| √
|-
| Item radial gauge chart<sup>5</sup> 
| ∞ 
| 1 
| √ 
| &nbsp; 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| <span style="color: #ff0000">√</span> 
| &nbsp;
|-
| Range radial gauge chart 
| ∞&nbsp; 
| 2 
| √ 
| &nbsp; 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| <span style="color: #ff0000">√</span> 
| &nbsp;
|-
| Linear gauge chart 
| ∞ 
| 1;2 
| √ 
| &nbsp; 
| √ 
| √ 
| &nbsp; 
| &nbsp; 
| √ 
| &nbsp; 
| &nbsp; 
| &nbsp; 
| 0 
| 1 
| &nbsp; 
| √
|-
| Item linear gauge chart
| ∞
| 1
| √
| &nbsp;
| √
| √
| &nbsp;
| &nbsp;
| √
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| <span style="color: #ff0000">√</span>
| &nbsp;
|-
| Range linear gauge chart
| ∞
| 2
| √
| &nbsp;
| √
| √
| &nbsp;
| &nbsp;
| √
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| <span style="color: #ff0000">√</span>
| &nbsp;
|-
| Box and whiskers chart
| '6+
| ∞
| √
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| &nbsp;
| 1
| 1
| &nbsp;
| √
|}

<br>I will later refer to the above matrix when explaining the cross diagram and quick report viewers.<br>Long comments to the chart object: (Michael does not necessarily agree – need more consideration)<br>About the 1st and 2nd items, I have some ideas:<br>Definition:<br>Series: columns in the spreadsheet, a series can have more than 1 column. One series can have 1 to many items.<br>Item: Row in spreadsheet, an item use 1 row. One item can have 1 to many values.<br>Value: Cells in 1 row in spreadsheet. It means number of values in 1 item equals to number of columns in 1 series. <br>Current action<br>Chart name<br>Number of series in chart<br>Number of items in one series<br>Number of values in one item<br>√<br>Pie chart<br>1<br>∞<br>1<br>√<br>Line chart<br>∞<br>∞<br>1<br>√<br>Bar chart<br>∞<br>∞<br>1<br>√<br>Bar-Line chart<br>∞<br>∞<br>1<br>X<br>Float bat<br>∞<br>∞<br>2<br>√<br>Radar chart<br>∞<br>∞<br>1<br>X<br>Point chart<br>1<br>∞<br>2<br>√<br>Table chart<br>∞<br>∞<br>1<br>√<br>Area chart<br>∞<br>∞<br>1<br>√<br>Funnel chart<br>1<br>∞<br>1<br>√<br>Bubble chart<br>1<br>∞<br>3<br>X<br>Radial gauge chart<br>∞<br>1<br>1 or 2<br>X<br>Linear gauge chart<br>∞<br>1<br>1 or 2<br>X<br>Box and whiskers chart<br>1<br>∞<br>∞ 

Wrong action:<br>This can be a feature request. Logic for static mode of bar chart can be changed to:<br>- Bar can stack to bar/float bar<br>- Float bar ca not stack to any kind of bar.<br>So the rule that float bar just can be at the first series is not correct any more.<br>Float bat<br>1<br>∞<br>2<br>Feature request<br>Point chart<br>∞<br>1<br>2<br>Feature request<br>Radial gauge chart<br>∞<br>1 or 2<br>1<br>Feature request<br>Linear gauge chart<br>∞<br>1 or 2<br>1<br>Feature request<br>Box and whiskers chart<br>∞<br>∞<br>1 

We can use this logic to all the coming chart type (if we have).<br>External style sheet<br>There is a separate resource in Catglobe called a style sheet. It basically specifies how any of the chart types in Catglobe should look if the Style Sheet is applied. For all chart types (except Table charts) these settings equal settings that are available in the Nevron component. It is not the full list of Nevron options for each chart type, since Nevron have so many it would be more confusing for the user than actually beneficial. We are although constantly being asked if the user can influence certain things with the current style sheet; and when they cannot we find out if Nevron can do it, and when they can we add a feature request for the style sheet module for such an updated setting.<br>It is required that the Chart Creator Object receives a style sheet (it should of course only get the styles for the chart type that it is creating), so in case the user has not specified any external style sheet to be used, Catglobe itself has a default style sheet. We are constantly updating the settings of the default style sheet to make the maximum number of diagrams look good initially.<br>There are 3 levels in Catglobe at which external style sheets may be applied. Since style sheets can be applied to all 3 levels at the same time there is a preference system ensuring that any diagram knows which one to take.<br>So basically it starts at number 1 below; and if no external style sheet is found it continues down the list until it finds one or reaches level 3 (the default Catglobe System style sheet) which always exists. (users cannot themselves apply a style sheet to level 4 though – this one is fixed).<br>1.Diagram Style Sheet (please distinguish from the in-line style sheet which is also related to a diagram)<br>2.Report Style Sheet<br>3.System Style Sheet<br>Often a viewed diagram will not be associated to a report and/or report template and in this case these levels will be ignored and only the other levels checked.<br>Table charts also have many style sheet settings, but tables are not set up by Nevron; these are set up by Catglobe itself using HTML tables and HTML settings that can be applied to tables.<br>There are many settings which are series and item specific which cannot be set up in in the external style sheet. This could e.g. be the color of a cell in a table or cells to be merged in a table. Since we, for an external style sheet, will not know how many cells a table has, we must do this “in-line” (directly associated with the diagram). In-line styles also give us the option of overwriting styles from external style sheets that need to be different in specific diagrams.<br>In-line style sheet<br>In-line style sheet settings will always overwrite any external style sheet settings that may have been sent together with the chart. In-line styles exist in “minor style groupings” and are only applied if the grouping is “activated”. This is easier to explain with an image from the in-line style sheet editor. 

In order for the style sheet grouping called “Size” to be activated the “Inherit” setting must be unchecked. When unchecked the diagram will use “Width” and “Height” settings from the in-line style sheet.<br>Just to show where the in-line styles are applied as opposed to the diagram related external style sheet we will present the below screen dump from the Spread Sheet Editor.<br><br>This is currently the only place where you can actually open the in-line style sheet editor from, but there are a few other places from where in-line styles are actually supplied to the Chart Creator object, where the supplying feature itself specifies the in-line style sheet to be sent. <br>These places are:<br>The cross diagram generator - Bar and Line charts: Since there is no such thing as separate bar and line charts, but only one chart called “Bar-Line” where each series has an in-line setting that can make them either bars or lines, then when creating bar and line charts from the cross diagram viewer, we need to also supply bar/line settings for all series. This is done automatically by the viewer, so user does not need to know that bar and line charts are in reality the same object in Catglobe.<br>Tabulation module – style setting functions: Although not implemented yet, it is in the project list for version 5.7; so it is best that we explain it also now so that it can be ensured that it is implemented correctly. Basically what will happen is that the Tabulation module will add a number of Functions that can specify some In-line style settings requirements (all for table chart). These Functions will be asked of the CDG object to be applied in the process of creating the Expression sheet. Basically it is messy, that the CDG object must now apply in-line styles, but this is the only place where it can be done (please talk with Designer who is Long for further discussion – I would definitely prefer it outside CDG but cannot see how).6 If we do implement an ability by the CDG object to apply in-line styles then this definitely also ought to be the place where this is done when the cross diagram viewer creates bar and line charts (I.e. that it then requests the CDG to make all series in the bar-line chart into either bars or lines).