Script Documentation of graphomate bullet graphs for SAP BusinessObjects Design Studio
Author: Jens Beckmann
Rev 1.5 as of December 2016
Introduction
The graphomate bullet graphs extension supports the SAP Design Studio scripting language. This enables the user to dynamically interact with the add-on during runtime. Script commands include manipulation of the graphomate bullet graphs layout or setting of data. This document features a list of all currently available script commands. Please do not hesitate to contact us if any feature is missing. For this, you can use our online form.
Events
The following events are available. User-made scripts can be deposited on the Property Sheet under the group Events.
| Event Name | Description |
|---|---|
| On Element Clicked | Is triggered when the user clicks on an element of the chart at runtime. In order to allow a drilldown, it is necessary to react on the user input at this point. The return values of the following functions are updated at the moment of the event:
|
Functions
The following functions are available. They can be addressed in the scripting editor of Design Studio. We differentiate between getter and setter functions as they get information from the extension or set its properties.
| Getter Name | Example | Return type | Example Return Value | Description |
|---|---|---|---|---|
| getCalculateQualitativeRanges() | GRAPHOMATEBULLETGRAPHS_1 .getCalculateQualitativeRanges(); | boolean | true | Returns whether the Qualitative Ranges are calculated or not. |
| getChartTitle() | GRAPHOMATEBULLETGRAPHS_1.getChartTitle(); | String | "Title" | Returns the title of the Bullet Graphs component. |
| getChartSubtitle() | GRAPHOMATEBULLETGRAPHS_1.getChartSubtitle(); | String | "Subtitle" | Returns the subtitle of the Bullet Graphs component. |
| getComparison1() | GRAPHOMATEBULLETGRAPHS_1.getComparison1(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "4"}' | Returns the selection string of Comparative Measure 1. |
| getComparison2() | GRAPHOMATEBULLETGRAPHS_1.getComparison2(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "5"}' | Returns the selection string of Comparative Measure 2. |
| getComparisonGroup() | GRAPHOMATEBULLETGRAPHS_1 .getComparisonGroup(); | String | "A" | Returns the comparison group the bullet graph component is currently registered in. A return value of "" means that the component is currently not part of any comparison group. |
| getDatatypes(String seriesType) | GRAPHOMATEBULLETGRAPHS_1 .getDatatypes(“performance1”); | String | "AC,AC,AC,AC" | Returns the datatypes for the passed series type. Allowed values for seriestype are: performance1, performance2, comparative1, comparative2 ,quality1, quality2, quality3 |
| getDisplayCategoryLabels() | GRAPHOMATEBULLETGRAPHS_1 .getDisplayCategoryLabels(); | boolean | true | Returns whether category labels are shown. |
| getDisplayValueAxis() | GRAPHOMATEBULLETGRAPHS_1 .getDisplayValueAxis(); | String | "Once" | Returns whether the value axis is displayed. Possible return values are Always, Once or Never. |
| getDeviationFromComparison1() | GRAPHOMATEBULLETGRAPHS_1 .getDeviationFromComparison1(); | boolean | false | Returns whether deviations of Comparative Measure 1 from Performance Measure 1 are displayed or not. |
| getNormalizeToTarget() | GRAPHOMATEBULLETGRAPHS_1 .getNormalizeToTarget(); | String | "None" | Returns if the data in a bullet graph component are normalized to a target value. Return value are either None, Performance Measure 1, Performance Measure 2, Comparative Measure 1 or Comparative Measure 2. |
| getNumeraljsFormatString() | GRAPHOMATEBULLETGRAPHS_1 .getNumeraljsFormatString(); | String | "0.0a" | Returns the current numeral.js format string. |
| getPercentageQuality1() | GRAPHOMATEBULLETGRAPHS_1 .getPercentageQuality1(); | Float | 0.75 | Returns the current percentage which is used to calculate Qualitative Range 1. |
| getPercentageQuality3() | GRAPHOMATEBULLETGRAPHS_1 .getPercentageQuality3(); | Float | 1.25 | Returns the current percentage which is used to calculate Qualitative Range 3. |
| getPerformance1() | GRAPHOMATEBULLETGRAPHS_1.getPerformance1(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "6"}' | Returns the selection string of Performance Measure 1. |
| getPerformance2() | GRAPHOMATEBULLETGRAPHS_1.getPerformance2(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "1"}' | Returns the selection string of Performance Measure 2. |
| getPerformanceBarHeight() | GRAPHOMATEBULLETGRAPHS_1 .getPerformanceBarHeight(); | int | 25 | Returns the current height of the performance bars. |
| getQualitativeBarHeight() | GRAPHOMATEBULLETGRAPHS_1 .getQualitativeBarHeight(); | int | 35 | Returns the current height of the qualitative ranges. |
| getQuality1() | GRAPHOMATEBULLETGRAPHS_1.getQuality1(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "2"}' | Returns the selection string of Qualitative Range 1. |
| getQuality2() | GRAPHOMATEBULLETGRAPHS_1.getQuality2(); | String | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "3"}' | Returns the selection string of Qualitative Range 2. |
| String getQuality3() | GRAPHOMATEBULLETGRAPHS_1.getQuality3(); | '{"Keyfigures": "0D_NWI_IQTY", "0D_NWI_CHAN": "4"}' | Returns the selection string of Qualitative Range 3. | |
| getReverseQualitativeRanges() | GRAPHOMATEBULLETGRAPHS_1 .getReverseQualitativeRanges(); | Boolean | false | Returns the drawing direction of the Qualitative Ranges. |
| getReverseQuantity() | GRAPHOMATEBULLETGRAPHS_1 .setReverseQuantity(); | Boolean | false | Returns the current drawing direction of the value axis. |
| getUseIndividualScales() | GRAPHOMATEBULLETGRAPHS_1 .setUseIndividualScales(); | Boolean | false | Returns if every bullet graph is scaled individually, or if all are scaled identically. |
| getVerticalAlign() | GRAPHOMATEBULLETGRAPHS_1.getVerticalAlign(); | Boolean | false | Returns whether the bulletgraphs are aligned vertically (true) or horizontally (false) |
| getSelectedMember(String dimensionKey) | GRAPHOMATEBULLETGRAPHS_1 .getSelectedMember("0D_NWI_RCOD").text; | Member | "West" | After the user clicked on an element in the bullet graph, this function returns the member of the specified dimension dimensionKey. The member provides different properties such as text, internalKey and externalKey. |
| getSelectedMemberKey(String dimensionKey) | GRAPHOMATEBULLETGRAPHS_1 .getSelectedMemberKey("0D_NWI_RCOD"); | String | "10273" | After the user clicked on an element in the bullet graph, this function returns the key of the member of the dimension dimensionKey. |
| getSelectedMemberText(String dimensionKey) | GRAPHOMATEBULLETGRAPHS_1 .getSelectedMemberText("0D_NWI_RCOD"); | String | "West" | After the user clicked on an element in the bullet graph, this function returns the text of the member of the selected dimension dimensionKey. |
| Setter Name | Example | Description |
|---|---|---|
| setCalculateQualitativeRanges(boolean value) | GRAPHOMATEBULLETGRAPHS_1.setCalculateQualitativeRanges(true); | If this option is true, Qualitative Ranges 1 and 3 will be calculated from Qualitative Range 2. If set to false, Qualitative Ranges 1 and 3 will have to be assigned to a Data Series to be displayed. |