Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Div
classpdfExportLandscape

Skript-Dokumentation der graphomate charts für SAP BusinessObjects Design Studio

Introduction

The graphomate charts extension supports the scripting language of Design Studio. Therefore, it is possible to determine properties of the extension at run-time. New data can be set, titles can be adapted and scales be changed. Furthermore, it is possible to use drilldown functionalities of the extension and thus create interactive dashboards.
This document provides a list of available functions, events and examples. We are steadily working on expanding the range of functions. If you miss certain functions, please give us a note. Therefore you can use our online form under http://www.graphomate.com/en/feedback.

Events

The following events are available. User-made scripts can be deposited on the Property Sheet under the point Events.


Event namedescription
On Element Clicked

Is triggered if the user clicks on an element on the chart at run-time. 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:

  • getSelectedMemberKey(), getSelectedMemberText(), getClickedElementIndex(), getClickedSeriesIndex()

On new data arrival

Is triggered when the chart receives updated data. This is happening, for example, when the dimension of a Data Source or if a filter has been changed.
This would be the appropriate point to change Data Types or the Waterfall Calculation Path.


Functions

The following functions are available in the graphomate charts extension. They can be addressed in the scripting editor of Design Studio.

Guideline to umlauts, special characters and blank spaces

In general umlauts, special characters and blank spaces Umlauts are percent encoded for technical reasons in the Advanced Property Sheet (see: http://en.wikipedia.org/wiki/Percent-encoding).

Example:
Nestlé - Development of sales in % compared to the previous year
becomes:
Nestl%C3%A9%20 %20Development%20of%20sales%20in%20%25%20compared%20to%20the%20previous%20year

This makes it necessary to percent encode string values even while transferring them from the scripting language or Standard PropertySheet. (On the Internet there are many free tools for en-/decoding, for example: http://www.url-encode-decode.com/.)



Getter Nameexamplereturn typeexample return valuedescription

 getAxisLabels()

GRAPHOMATECHART_1.getAxisLabels();

String

Budget, Actual

Returns axis labels as a comma-separated string value.

getAxisThickness()

GRAPHOMATECHART_1.getAxisThickness();

Integer

3.0

Returns the axis thickness as an integer value.

getBarWidth()

GRAPHOMATECHART_1.getBarWidth();

Float

5.0

Returns the width of the bars as a float value.

getBaseChartVisible()

GRAPHOMATECHART_1.getBaseChartVisible();

Boolean

true

Returns whether the base chart is visible.

getCalculationPath()

GRAPHOMATECHART_1.getCalculationPath();

String

+,+,+,-,-,=, ,s+,+,=,-,-

Returns the waterfall calculation path as a comma-separated string value.

getCalculateDeviationsFromNull()

GRAPHOMATECHART_1.getCalculateDeviationsFromNull();

Boolean

true

Returns whether NULL values are used to calculate deviations.

getCategoryAxisVisible()

GRAPHOMATECHART_1.getCategoryAxisVisible();

Boolean

true

Returns whether the category axis is visible.

getCategoryCount()

GRAPHOMATECHART_1.getCategoryCount();

Integer

12

Returns whether the number of to be displayed categories is limited. Returns an integer value. A value of 0 means that there is no limitation.

getCategoryLabelRotation()

GRAPHOMATECHART_1.getCategoryLabelRotation();

Integer

45

Returns the rotation angle of the category labels.

getCategoryWidth()

GRAPHOMATECHART_1.getCategoryWidth();

Integer

20

Returns the width of the categories as an integer value if the Category Width is fixed.

getChartType()

GRAPHOMATECHART_1.getChartType();

String

line

Returns the chart type as a string-value.

getClickedElementIndex()

GRAPHOMATECHART_1.getClickedElementIndex();

Integer

3

Returns the index of the last clicked element/category.

getClickedPositionValue()

GRAPHOMATECHART_1.getClickedPositionValue();

Float

234234.432

Returns the relative value of the clicked position in the chart.
This can be utilized to create a zoom function, when the clicked value is passed back to the chart as the manual scale minimum.

getClickedSeriesIndex()

GRAPHOMATECHART_1.getClickedSeriesIndex();

Integer

1

Returns the index of the last clicked Data Series.

getComparisonGroup()

GRAPHOMATECHART_1.getComparisionGroup();

String

A

Returns the Comparison Group as a string value.

getDatatypes(Integer seriesIndex)

GRAPHOMATECHART_1.getDatatypes(1);

String

PY,PY,PY,PY,AC,AC,AC,AC,PL,PL,PL,PL

This function returns the Data Types of the selected Data Series seriesIndex as a comma-separated string.

getDeviationBadColor()

GRAPHOMATECHART_1.getDeviationBadColor();

String

#ff3300

This function returns the color used for "bad" deviations.

getDeviationGoodColor()

GRAPHOMATECHART_1.getDeviationGoodColor();

String

#2e2e2e

This function returns the color used for "good" deviations.

getDeviationVisibility()

GRAPHOMATECHART_1.getDeviationVisibility();

String

0,1,4

Returns a list of indexes of visible deviation charts as a comma-separated string.

getElementsOffset()

GRAPHOMATECHART_1.getElementsOffset();

Float

2.0

This function returns the offset between the elements of a category as a float value.

getEndingLineOverlap()

GRAPHOMATECHART_1.getEndingLineOverlap();

Integer

3

Returns how far the Ending Lines protrude over the bars.

 getEndingLineThickness()

GRAPHOMATECHART_1.getEndingLineThickness();

Integer

2

Returns the thickness of the Ending Lines.

getEndingLineVisible()

GRAPHOMATECHART_1.getEndingLineVisible();

Boolean

false

Returns whether to display Ending Lines above the bars.

getExtendedNumberFormat()

GRAPHOMATECHART_1.getExtendedNumberFormat();

String

-||.|,|1|1|%25

Returns the number format for the Extended Mode. The format string can be found in the manual.

getExtendedNumberFormatPercentage()GRAPHOMATECHART_1.getExtendedNumberFormatPercentage();String

-||.|,|1|1|%25

Returns the number format for the percentage values in the Extended Mode. The format string can be found in the manual.

getFixedCategoryWidth()

GRAPHOMATECHART_1.getFixedCategoryWidth();

Boolean

true

This function returns a boolean value whether the Category Width is fixed.

getHighlightMode()

GRAPHOMATECHART_1.getHighlightMode();

String

single

This function returns the current setting for the highlight mode.

getLabelFormatMode()

GRAPHOMATECHART_1.getLabelFormatMode();

String

extended

Returns which mode is used for the label format.

getLabelPositioningMode()

GRAPHOMATECHART_1.getLabelPositioningMode();

String

auto

Returns the current label positioning mode.

getLockData()

GRAPHOMATECHART_1.getLockData();

Boolean

true

Returns whether this component ignores data updates.

getManualScalePercentMax()

GRAPHOMATECHART_1.getManualScalePercentMax();

Float

80.5

Returns the manual percentage scaling maximum as a float value.

getManualScalePercentMin()

GRAPHOMATECHART_1.getManualScalePercentMin();

Float

-80.5

Returns the manual percentage scaling maximum as a float value.

getMulitHighlights()GRAPHOMATECHART_1.getMultiHighlights();String

[{"startElement":1,"endElement":2,"startSeries":1,"endSeries":1}, {"startElement":3,"endElement":4,"startSeries":1,"endSeries":1}, {"startElement":5,"endElement":6,"startSeries":1,"endSeries":1}]

Returns a list of the current mulit highlights (highlighted values above the chart). Returns a JSON-string, which contains an array consisting of an object for each multi highlight. The following elements are part of an object (the order of these elements must be maintained): {"startElement":1,"endElement":2,"startSeries":1,"endSeries":1}.

getNegativeDeviationIsGood()

GRAPHOMATECHART_1.getNegativeDeviationIsGood();

Boolean

true

Returns whether the negative deviations are interpreted as positive or negative.

getNegativeOutlierThreshold()

GRAPHOMATECHART_1.getNegativeOutlierThreshold();

Float

-80.0

Returns the negative outlier threshold as a float value.

getNumberFormat()

GRAPHOMATECHART_1.getNumberFormat();

String

0,0.0

Returns the number format for the Basic Mode. The format string corresponds to the format numeral.js (see http://www.numeraljs.com).

getNumberFormatPercentage()

GRAPHOMATECHART_1.getNumberFormatPercentage();

String

0%

Returns the number format for the percentage values in the Basic Mode. The format string corresponds to the format numeral.js (see http://www.numeraljs.com).

getPositiveOutlierThreshold()

GRAPHOMATECHART_1.getPositiveOutlierThreshold();

Float

80.0

Returns the positive outlier threshold as a float value.

getSelectedMember(Dimension dimensionKey)

GRAPHOMATECHART_1.getSelectedMember();

Member

0D_NWI_RCOD

After the user clicked on an element/a category in the chart, this function returns the member of the specified dimension dimensionKey. The member provides different properties such as text, internalKey and externalKey.

getSelectedMemberKey(String dimensionKey)

GRAPHOMATECHART_1.getSelectedMemberKey("0D_NWI_RCOD");

String

10273

After the user clicked on an element/a category in the chart, this function returns the Key of the member of the selected dimension dimensionKey. 


getSelectedMemberText(String dimensionKey)

GRAPHOMATECHART_1.getSelectedMemberText("0D_NWI_RCOD");

String

North West

After the user clicked on an element/a category in the chart, this function returns the text of the member of the selected dimension dimensionKey. The return value is similar to the function getSelectedMemberKey().

getSeparatorLength()

GRAPHOMATECHART_1.getSeparatorLength();

Integer

5

Returns the length of the Seperators in pixels.

getSeparatorMode()

GRAPHOMATECHART_1.getSeparatorMode();

String

datatypes

Returns the Separator Mode.

getSeparatorPositions()

GRAPHOMATECHART_1.getSeparatorPositions();

String

2,4,6

Returns a list of (manual) set positions of Separators as comma-separated string value. 

getSeparatorSourceRowIndex()

GRAPHOMATECHART_1.getSeparatorSourceRowIndex();

Integer

3

Returns the index of the row/series, from which the Separators can be derived. This function is dependent on the Separator Mode (setSeperatorMode ()).

getSeparatorThickness()

GRAPHOMATECHART_1.getSeparatorThickness();

Integer

2

Returns the thickness of the Serators in pixels.

getSeries(Integer seriesIndex)

GRAPHOMATECHART_1.getSeries(1);

String

{"Keyfigures":"0D_NWI_NSAL"}

Returns the data description of the selected Data Series seriesIndex as JSON string.

getSeriesLabels()

GRAPHOMATECHART_1.getSeriesLabels();

String

Budget,Actual,Target 

Returns the series label of the chart as comma-separated string.

getShowAxisLabelsLeft()

GRAPHOMATECHART_1.getShowAxisLabelsLeft();

Boolean

true

Returns whether the Axis Labels are displayed on the left.

getShowAxisLabelsRight()

GRAPHOMATECHART_1.getShowAxisLabelsRight();

Boolean

true

Returns whether the Axis Labels are displayed on the right.

getShowCategoryLabels()

GRAPHOMATECHART_1.getShowCategoryLabels();

Boolean

false

Returns whether the Category Labels are displayed.

getShowDatatypesInAxis()

GRAPHOMATECHART_1.getShowDatatypesInAxis();

Boolean

true

Returns whether the Data Types are displayed in the axis or in the elements.

getShowTitle()

GRAPHOMATECHART_1.getShowTitle();

Boolean

true

Returns whether the title is displayed.

getSpaceFactorBaseChart()

GRAPHOMATECHART_1.getSpaceFactorBaseChart();

Float

0.8

Returns the proportional Space Factor of the Base Chart (relative to the other Space Factors).

getSpaceFactorDeviationChart()

GRAPHOMATECHART_1.getSpaceFactorDeviationChart();

Float

0.2

Returns the proportional Space Factor of the deviation chart (relative to the other Space Factors).

getStackedBarLabelPosition()

GRAPHOMATECHART_1.getStackedBarLabelPosition();

String

middle

Returns the position of the labels in the stacked bar chart.

getStackedBarNegativeValues()

GRAPHOMATECHART_1.getStackedBarNegativeValues();

Boolean

true

This function returns whether negative values are allowed in stacked bar charts.

getStackedBarSumsVisible()

GRAPHOMATECHART_1.getStackedBarSumsVisible();

Boolean

true

This function returns wehter sums are displayed in the stacked bars.

getStructureMode()

GRAPHOMATECHART_1.setStructureMode();

Boolean

true

This function returns whether a chart is currently in structure mode (identical to showStructureMode()).

getSuppressRepeatingCategoryLabels()

GRAPHOMATECHART_1.getSuppressRepeatingCategoryLabels();

String

true,true,false,false,true 

Returns the configuration of the property Suppress Repeating Category Labels. Returns a comma separated string value.

getSuppressZeroLabels()

GRAPHOMATECHART_1.getSuppressZeroLabels();

Boolean

true

Returns whether Zero Labels are displayed.

getSynchronizeAxesPosition()

GRAPHOMATECHART_1.getSynchronizeAxesPosition();

Boolean

true

This function returns a boolean value whether the axes positions are synchronized with the Comparison Group.

getSynchronizePadding()

GRAPHOMATECHART_1.getSynchronizePadding();

Boolean

false

This function returns a boolean value whether the padding of the chart is synchronized with the Comparison Group.

getSynchronizeScaling()

GRAPHOMATECHART_1.getSynchronizeScaling();

Boolean

true

The function returns a boolean value whether the scaling of the chart is synchronized with the Comparison Group.

getTitle()

GRAPHOMATECHART_1.getTitle();

String

Sales in Mio. EUR|

2013 ACT and BUD|

North West

Returns the title of the chart as a string value. A line break is represented with a pipe (|).

getUseOutlierThreshold()

GRAPHOMATECHART_1.getUseOutlierThreshold();

Boolean

true

Returns whether the Outlier Threshold is used.

Returns whether the Outlier Threshold is used.Returns whether the Outlier Threshold is used.getUserHighlightColor()

GRAPHOMATECHART_1.getUserHighlightColor();

String

#ff0000,#00ff00,#0000ffGibt eine

Liste der hinterlegten User Highlight Farben als kommaseparierten String zurück. Die Farben werden in der angegebenen Reihenfolge bei den User Highlights (zur Laufzeit hervorgehobene Werte) durchgeschaltet, bis die Wunschfarbe eingestellt istReturns a list of deposited colors for the User Hightlights as comma separated string-value. The colors are switched at each click (during runtime) until the desired color is set.

getUserHighlightList()

GRAPHOMATECHART_1.getUserHighlightList();

String

[[1,3],[2,3][1,5]]

Gibt eine Liste der aktuellen User Highlights (zur Laufzeit hervorgehobene Werte) als JSON-String zurück, der die Positionen der Highlights jeweils mit zwei Zahlen übergibt. Dabei gibt die erste Zahl die Datenreihe an, während die zweite Zahl die Position des Wertes in der Datenreihe darstelltReturns a list of the current user highlights (highlighted values at runtime). Returns a JSON-string, which passes the positions of each highlight with two numbers; the first number indicates the data series, while the second number represents the position of the value in the data series.

getValueAxisVisible()

GRAPHOMATECHART_1.getValueAxisVisible();

Boolean

trueGibt zurück, ob die Value Axis dargestellt wird oder nicht

Returns whether the value axis is visible or not.

getVisibleSeries()

GRAPHOMATECHART_1.getVisibleSeries();

String

0,1,4

Gibt eine Auflistung der Indices sichtbarer Serien als kommaseparierten String wiederReturns a list of indexes of visible series as comma-separated string

refresh(Stringstring value)
Zeichnet das Chart neu. Dies ist ein Workaround für den Fall, dass das Chart nicht neu gezeichnet wurde, nachdem sich die Daten zur Laufzeit durch Einwirkung der Skriptsprache auf die Data Source geändert haben. Dies kann passieren, nachdem zum Beispiel Filter geändert oder Dimensionen hinzugefügt oder entfernt wurden. Sollte sich das Chart unerwartet nicht neu zeichnen, dann sollte dieser Aufruf helfenRedraws the chart. This is a workaround in case the chart has not been refreshed after data has changed at run-time by the impact of the scripting language on the Data Source. This could happen, for example, when filters have been changed, dimensions have been added or removed.

If the chart should unexpectedly not refresh, this command should help:
GRAPHOMATECHART_1.refresh(GRAPHOMATECHART_1.refreshValue());Hierbei ist es unbedingt erforderlich, als Parameter

val den Wert von .It is absolutely necessary to pass the value of refreshValue() zu übergebenas parameter val!

refreshValue() ist eine Hilfsfunktion für
Help function for refresh(). Sie hat keinen anderweitigen NutzenIt has no further use.

scalingHelperMode(Stringstring value)
Setzt den Skalierungshelfer. Erlaubte Werte sind Sets the Scaling Helper. Valid values are none, line, area.
Beispiel: den Skalierungshelfer aktivierenExample: activate the Scaling Helper
GRAPHOMATECHART_1.scalingHelperMode("line");


setBaseChartVisible(Boolean)
Setter NameBeispielBeschreibung
scalingHelperMode(string value)activate the Scaling HelperSets the Scaling Helper. Valid values are none, line, area.
setAxisLabels(String)GRAPHOMATECHART_1.setAxisLabels("Net Sales,Returns");Setzt die Achsenlabels des Charts. Erwartet value als kommaseparierten String.  Das erste Element wird als linkes, das zweite Element als rechtes Achsenlabel interpretiert.
setAxisThickness(Integer) GRAPHOMATECHART_1.setAxisThickness(3);Setzt die Achsendicke.
setBarWidth(Float)GRAPHOMATECHART_1.setBarWidth(3);Setzt die Breite der Balken als Float. Werte kleiner oder gleich 1 werden als Prozent interpretiert.
Sets the axes labels of the chart. Expects value as comma-separated string. The first value is interpreted as left axis label, the second as right axis label.
setAxisThickness(Integer) GRAPHOMATECHART_1.setBaseChartVisiblesetAxisThickness(true3);Setzt, ob das Base-Chart sichtbar istSets the axes thickness.
setCalculationPathsetBarWidth(StringFloat)GRAPHOMATECHART_1.setCalculationPath("+,+,+,-,-,=, ,s+,+,=,-,-");Setzt den Wasserfall-Berechnungspfad (Waterfall Calculation Path). Erwartet value als kommaseparierten String.
setCalculateDeviationsFromNull (Booleanl)GRAPHOMATECHART_1.setCalculateDeviationsFromNull(true);Diese Funktion setzt, ob NULL-Werte zur Berechnung von Abweichungen herangezogen werden sollen.
setCategoryAxisVisiblesetBarWidth(3);Sets the width of the bars as a float value. Values less than or equal to 1 are interpreted as percentages.
setBaseChartVisible(Boolean)GRAPHOMATECHART_1.setCategoryAxisVisiblesetBaseChartVisible(true);Setzt, ob das Base-Chart sichtbar istSets whether the base chart is visible.
setCalculationPath(String)GRAPHOMATECHART_1.setCalculationPath("+,+,+,-,-,=, ,s+,+,=,-,-");Setzt den Wasserfall-Berechnungspfad (Sets the Waterfall Calculation Path). Erwartet value als kommaseparierten StringExpects value as comma-separated string.
setCalculateDeviationsFromNull (Booleanl)GRAPHOMATECHART_1.setCalculateDeviationsFromNull(true);Diese Funktion setzt, ob NULL-Werte zur Berechnung von Abweichungen herangezogen werden sollenThis function sets whether NULL values are used to calculate deviations.

setCategoryAxisVisible(Boolean)

GRAPHOMATECHART_1.setCategoryAxisVisible(true);Diese Funktion setzt die Sichtbarkeit der KategorieachseSets whether the base chart is visible.
setCategoryCount(Integer)GRAPHOMATECHART_1.setCategoryCount(12);Setzt eine Begrenzung der darzustellenden Kategorieanzahl. Der Wert 0 hebt die Beschränkung aufSets a limit on the number of displayed category. A value of 0 removes the restriction.
setCategoryLabelRotation(int rotation)GRAPHOMATECHART_1.setCategoryLabelRotation(45);Dreht die Category Label um den übergebenen Winkel. Die Drehung findet gegen den Uhrzeigersinn stattRotates the category labels according to the passed angle. Rotation takes place counter-clockwise.

setCategoryWidth(Integer)

GRAPHOMATECHART_1.setCategoryWidth(3);

Diese Funktion setzt die Breite der Kategorien. Sie wird jedoch nur interpretiert, wenn fixedCategoryWidth gesetzt istThis function sets the width of the categories. But it is only interpreted when fixedCategoryWidth is set.
setChartType(String)GRAPHOMATECHART_1.setChartType("line");Setzt den Diagramm-Typen. Mögliche String-Werte sindSets the chart type. The following string values are allowed: bar, line, offsetbar, waterfall, pin, stackedbar.

setComparisonGroup(String id)

GRAPHOMATECHART_1.setComparisonGroup("A");

Setzt die Sets the Comparison Group des Charts als String. Charts mit der gleichen Comparison Group werden gleich skaliert und ausgerichtet. Weitere Feinheiten können über die folgenden Parameter eingestellt werdenof the chart as a string. Charts with the same Comparison Group are equal scaled and aligned. More details can be set using the following parameters:
getSynchronizePadding(), setSynchronizePadding(), getSynchronizeScaling(), setSynchronizeScaling(), getSynchronizeAxesPosition(), setSynchronizeAxesPosition()

setDatatypeAt(Integer series, Integer index, String datatype)

GRAPHOMATECHART_1.setDatatypeAt(1, 1, "AC");

Diese Funktion setzt die übergebene Datenart für ein einzelnes Element einer DatenserieThis function sets the passed datatype for a single element of the passed data series.

setDatatypeForSeries(Integer series, Integer count, String datatype)

GRAPHOMATECHART_1.setDatatypeForSeries(1, 5, "AC");Diese

Funktion setzt die übergebenen Datenarten für die übergebene Datenserie. Die Anzahl der generierten Datenarten-Einträge entspricht dem Übergabeparameter count.
Der AufrufThis function sets the passed datatype for the data series with the passed index. The number of datatype entries generated is governed by the parameter count.
The function call
GRAPHOMATECHART_1.setDatatypeForSeries(1, 5, "AC");
ist äquivalent mitis equivalent to
GRAPHOMATECHART_1.setDatatypeForSeries(1, "AC,AC,AC,AC,AC");

setDatatypes (Integer seriesIndex, String)

Beispiel: Datenarten der ersten fünf Elemente der ersten Datenserie auf „PP“ setzen

GRAPHOMATECHART_1.setDatatypes(1, "PP,PP,PP,PP,PP");

Mit dieser Funktion werden die Datenarten (Data Types) der angegebenen Datenserie seriesIndex gesetzt. Erwartet value als kommaseparierten String.
Beispiel: Datenarten der ersten fünf Elemente der ersten Datenserie auf „PP“ setzenThis function sets the Data Types of the selected Data Series seriesIndex. Expects value as comma-separated string.

setDeviationBadColor(String)

GRAPHOMATECHART_1.setDeviationBadColor("#ff3300");Diese Funktion

setzt die Farbe, welche für “schlechte” Abweichungen benutzt wird. Es wird ein String im Format #ff3300 erwartetThis function sets the color used for „bad“ deviations. Expects a string value in the format #ff3300.

setDeviationGoodColor(String)

GRAPHOMATECHART_1.setDeviationGoodColor("#2e2e2e");

Diese Funktion setzt die Farbe, welche für “gute” Abweichungen benutzt wird. Es wird ein String im Format #2e2e2e erwartet.

setDeviationLabels(String labels, Boolean visibleOnly)

GRAPHOMATECHART_1.setDeviationLabels("Abs. Dev. FC,Perc. Dev. BUD", true);

Diese Funktion setzt die Beschriftungen aller Abweichungsserien. Wenn der zweite Wert auf true gesetzt wird, werden nur die sichtbaren/eingeblendeten Abweichungsserien berücksichtigt.

setDeviationVisibility (String)

GRAPHOMATECHART_1.setDeviationVisibility("0,1");

Setzt die Auflistung der Indices sichtbarer Abweichungscharts. Erwartet value als kommaseparierten String.

setElementsOffset(Float)

GRAPHOMATECHART_1.setElementsOffset(5);

Diese Funktion setzt das Offset zwischen den Elementen einer Kategorie. Werte kleiner oder gleich 1 werden als Prozent interpretiert.

setEndingLineOverlap(Integer)

GRAPHOMATECHART_1.setEndingLineOverlap(5)

Setzt, wie weit die Ending Lines über die Balken überstehen.

setEndingLineThickness(Integer)

GRAPHOMATECHART_1.setEndingLineThickness(3);

Setzt, wie dick die Ending Lines sind.


setEndingLineVisible(Boolean)


GRAPHOMATECHART_1.setEndingLineVisible(true);


Setzt, ob über den Balken Ending Lines angezeigt werden sollen.


setExtendedNumberFormat(String)


GRAPHOMATECHART_1.setExtendedNumberFormat("-||.|,|1|1|");


Setzt das Nummernformat für den Extended -Modus. Der Formatstring kann im Handbuch nachgelesen werden.

setExtendedNumberFormatPercentage(String)

GRAPHOMATECHART_1.setExtendedNumberFormatPercentage("-||.|,|1|1|%25");

Setzt das Nummernformat für die Prozentwerte im Extended -Modus. Der Formatstring kann im Handbuch nachgelesen werden.

setFixedCategoryWidth(Boolean)

GRAPHOMATECHART_1.setFixedCategoryWidth(true);

Diese Funktion setzt, ob die Kategoriebreite fix sein soll. Ist dieser Wert nicht gesetzt, wird die Breite automatisch ermittelt.

setHighlightEndIndex(Integer) 

GRAPHOMATECHART_1.setHighlightEndIndex(4);

Setzt den Kategorienindex value des Endwertes der Hervorhebung. Analog zu setHightlightStartIndex().

setHighlightEndSeries(Integer) GRAPHOMATECHART_1.setHighlightEndSeries(3);Setzt den Serienindex value der Endserie der Hervorhebung. Analog zu setHightlightStartSeries().
setHighlightMode(String)GRAPHOMATECHART_1.setHighlightMode("single");Mit dieser Funktion kann der Highlight Mode geändert werden. Gültige Übergabewerte sind none, single und multi.
setHighlightStartIndex(Integer)GRAPHOMATECHART_1.setHighlightStartIndex(0);Setzt den Kategorienindex value des Startwertes der Hervorhebung. Analog zu setHightlightEndIndex().
setHighlightStartSeries(Integer) GRAPHOMATECHART_1.setHighlightStartSeries(1);Setzt den Serienindex value der Startserie der Hervorhebung. Analog zu setHightlightEndSeries().
setLabelFormatMode(String)GRAPHOMATECHART_1.setLabelFormatMode("extended");Setzt als String, welcher Modus für die Label-Formatierung verwendet wird. Hierbei stehen basic und extended zur Verfügung.
setLabelPositioningMode(String)GRAPHOMATECHART_1.setLabelPositioningMode("auto");Diese Funktion setzt den Label Positioning Mode. Gültige Übergabewerte sind none (Labels werden ausgeblendet), fix (Labels werden direkt am dazugehörigen Element positioniert, können sich aber ggf. überschneiden) und auto (Labels überschneiden sich nicht, werden aber ggf. verschoben bzw. ausgeblendet).
setLockData(Boolean)GRAPHOMATECHART_1.setLockData(true);Setzt, ob die Komponente Daten-Updates ignorieren soll.
setManualScaleMaximum(Integer max)

die manuelle Skalierung auf 1.000.000 begrenzen
GRAPHOMATECHART_1.setManualScaleMaximum(1000000);

Setzt das Maximum der Skalierung des Base Charts auf den Integer-Wert max. Damit der Wert zum Tragen kommt, ist es erforderlich, dass der Skalierungsmodus auf Manual gesetzt ist
(siehe auch setScaleModeManual() und unter Scaling der Eigenschaftenbeschreibung).

setManualScaleMaximumFloat(Float max)GRAPHOMATECHART_1.setManualScaleMaximumFloat(1000000);Setzt das Maximum der Skalierung des Base Charts auf den Float-Wert max. Damit der Wert zum Tragen kommt, ist es erforderlich, dass der Skalierungsmodus auf Manual gesetzt ist (siehe auch setScaleModeManual() und den Punkt Scaling der Eigenschaftenbeschreibung). Diese Funktion ist eine Alternative zu setManualScaleMaximum(), falls nur Float-Werte zur Verfügung stehen.
setManualScaleMinimum(Integer min)

die manuelle Skalierung bei 1.000.000 beginnen
GRAPHOMATECHART_1.setManualScaleMinimum(1000000);

Setzt das Minimum der Skalierung des Base Charts auf den Integer-Wert min. Damit der Wert zum Tragen kommt, ist es erforderlich, dass der Skalierungsmodus auf Manual gesetzt ist (siehe auch setScaleModeManual() und den Punkt Scaling der Eigenschaftenbeschreibung).
setManualScaleMinimumFloat(Float minGRAPHOMATECHART_1.setManualScaleMinimumFloat(1000000);Setzt das Minimum der Skalierung des Base Charts auf den Float-Wert min. Damit der Wert zum Tragen kommt, ist es erforderlich, dass der Skalierungsmodus auf Manual gesetzt ist (siehe auch setScaleModeManual() und den Punkt Scaling der Eigenschaftsbeschreibung). Diese Funktion ist eine Alternative zu setManualScaleMinimum(), falls nur Float-Werte zur Verfügung stehen.
setManualScalePercentMax(Float)GRAPHOMATECHART_1.setManualScalePercentageMax(80);Setzt das manuelle prozentuale Skalierungsmaximum als Float-Wert.
setManualScalePercentMin(Float)GRAPHOMATECHART_1.setManualScalePercentageMin(-80);Setzt das manuelle prozentuale Skalierungsminimum als Float-Wert.
setMulitHighlights(String)GRAPHOMATECHART_1.setMultiHighlights("[{"startElement":1,"endElement":2,"startSeries":1,"endSeries":1}, {"startElement":3,"endElement":4,"startSeries":1,"endSeries":1}, {"startElement":5,"endElement":6,"startSeries":1,"endSeries":1}] ");

Die MultiHighlights werden als JSON-String gesetzt, welcher ein Array enthält, in welchem für jedes Multihighlight ein Objekt enthalten ist. Das Objekt ist nach dem Schema
{"startElement":1,"endElement":2,"startSeries":1,"endSeries":1} aufgebaut.
Ein fertiger JSON-String kann dann beliebig viele Multi-Highlights enthalten.

setNegativeDeviationIsGood(Boolean)GRAPHOMATECHART_1.setNegativeDeviationIsGood(true);Setzt, ob die negativen Abweichungen als positiv, oder als negativ interpretiert werden sollen.
setNegativeOutlierThreshold(Float)GRAPHOMATECHART_1.setNegativeOutlierThreshold(-80);Setzt die negative Ausreißergrenze.
setNumberFormat(String)GRAPHOMATECHART_1.setNumberFormat("0,0.0");Setzt das Nummernformat für den Basic-Modus. Der Formatstring entspricht dem Format von numeral.js, einzusehen unter http://www.numeraljs.com.
setNumberFormatPercentage(String)GRAPHOMATECHART_1.setNumberFormatPercentage("0 %");Setzt das Nummernformat für die Prozentwerte im Basic-Modus. Der Formatstring entspricht dem Format von numeral.js, einzusehen unter http://www.numeraljs.com.
setPositiveOutlierThreshold(Float)GRAPHOMATECHART_1.setPositiveOutlierThreshold(80);Setzt die positive Ausreißergrenze.

setScaleModeAutomatic()

GRAPHOMATECHART_1.setScaleModeAutomatic();Setzt den Skalierungsmodus des Base Charts auf Automatic.
setScaleModeManual()GRAPHOMATECHART_1.setScaleModeManual();Setzt den Skalierungsmodus des Base Charts auf Manual.
setScalingHelperValue(Integer)GRAPHOMATECHART_1.setScalingHelperValue(500);Setzt die Position des Skalierungshelfers. Erwartet die Position value als Integer-Wert.
setScalingHelperValueFloat(Float) GRAPHOMATECHART_1.setScalingHelperValueFloat(500);Setzt die Position des Skalierungshelfers. Erwartet die Position value als Float-Wert.
setSeparatorLength(Integer)GRAPHOMATECHART_1.setSeparatorLength(5);Setzt die Länge der Trennzeichen (Separators) in Pixeln.
setSeparatorMode(String)GRAPHOMATECHART_1.setSeparatorMode("datatypes");Setzt den Separator Mode. Gültige Werte sind: none, categorylabels, datatypes, manually.
setSeparatorPositions(String)GRAPHOMATECHART_1.setSeparatorPositions("100,200,300");Setzt die Trennzeichenpositionen des Charts. Erwartet value als kommaseparierten String.
setSeparatorSourceRowIndex(Integer)GRAPHOMATECHART_1.setSeparatorSourceRowIndex(3);Setzt den Index der Zeile/Serie, aus der sich die Trennzeichen (Separators) ableiten. Abhängig vom Separator-Mode (setSeperatorMode()).
setSeparatorThickness(Integer)GRAPHOMATECHART_1.setSeparatorThickness(3);Setzt die Dicke der Trennzeichen (Separators) in Pixeln.
setSeries(Integer seriesIndex, String)

die Datenbeschreibung der ersten Datenserie auf den übergebenen Wert setzen
GRAPHOMATECHART_1.setSeries(1, '{"Keyfigures":"0D_NWI_NSAL"}');

Setzt die Datenbeschreibung der spezifizierten Datenserie seriesIndex. Erwartet value als JSON- String. Dieser String beschreibt entweder eine Zeile oder eine Spalte in der Initial View.
Der String kann ausgelesen werden, nachdem man mit der graphomate charts Extension im Property Sheet Daten für eine Datenserie selektiert hat.

setSeriesLabels(String)GRAPHOMATECHART_1.setSeriesLabels("Series1,Series2");Setzt die Serienlabels des Charts. Erwartet value als kommaseparierten String.
setShowAxisLabelsLeft(Boolean)

GRAPHOMATECHART_1.setShowAxisLabelsLeft(true);

Setzt, ob die Achsenbeschriftungen auf der linken Seite angezeigt werden sollen.
setShowAxisLabelsRight(Boolean)GRAPHOMATECHART_1.setShowAxisLabelsRight(true);Setzt, ob die Achsenbeschriftungen auf der rechten Seite angezeigt werden sollen.
setShowCategoryLabels(Boolean)GRAPHOMATECHART_1.setShowCategoryLabels(true);Setzt, ob die Kategoriebeschriftungen (Category Labels) angezeigt werden sollen.
setShowDatatypesInAxis(Boolean)GRAPHOMATECHART_1.setShowDatatypesInAxis(true);Setzt, ob die Datenarten (Data Types) in der Achse angezeigt werden sollen.
setShowTitle(Boolean)GRAPHOMATECHART_1.setShowTitle(true);Setzt, ob der Titel angezeigt werden soll.
setSpaceFactorBaseChart(Float)GRAPHOMATECHART_1.setSpaceFactorBaseChart(0.8);Setzt den Platz-Faktor, welchen das Base Chart anteilig (im Verhältnis zu den anderen Platz-Faktoren) einnimmt.
setSpaceFactorDeviationChart(Float)GRAPHOMATECHART_1.setSpaceFactorDeviationChart(0.2);Setzt den Platz-Faktor, welchen ein Abweichungschart anteilig (im Verhältnis zu den anderen Platz-Faktoren) einnimmt.
setStackedBarLabelPosition(String)GRAPHOMATECHART_1.setStackedBarLabelPosition("middle");Setzt die Position der Labels im Stapel. Gültige Werte sind middle und right.
setStackedBarNegativeValues(Boolean)GRAPHOMATECHART_1.setStackedBarNegativeValues(true);Setzt, ob negative Stapel erlaubt sein sollen.
setStackedBarSumsVisible(Boolean)GRAPHOMATECHART_1.setStackedBarSumsVisible(true);Setzt, ob die Summen auf den Stapelbalken angezeigt werden sollen.
setStructureMode(Boolean)GRAPHOMATECHART_1.setStructureMode(true);Mit dieser Funktion kann ein Diagramm in den Structure Mode (true) bzw. den Time Mode (false) gesetzt werden.
setSuppressRepeatingCategoryLabels(String)GRAPHOMATECHART_1.setSuppressZeroLabels("true,false,false,true");Diese Funktion setzt die Einstellung für die Eigenschaft Suppress Repeating Category Labels. Es wird pro benötigter Zeile eine Angabe benötigt, die besagt, ob wiederholende Kategoriebeschriftungen ausgeblendet werden sollen.
setSuppressZeroLabels(Boolean)GRAPHOMATECHART_1.setSuppressZeroLabels(true);Diese Funktion setzt, ob Null-Labels angezeigt werden sollen.
setSynchronizeAxesPosition(Boolean)GRAPHOMATECHART_1.setSynchronizeAxesPosition(true);Diese Funktion setzt, ob die Achsenpositionen des Charts mit der Comparison Group abgeglichen werden sollen.
setSynchronizePadding(Boolean)GRAPHOMATECHART_1.setSynchronizePadding(true);Diese Funktion setzt, ob die Ränder des Charts mit der Comparison Group abgeglichen werden sollen.
setSynchronizeScaling(Boolean)GRAPHOMATECHART_1.setSynchronizeScaling(true);Diese Funktion setzt, ob die Skalierung des Charts mit der Comparison Group abgeglichen werden soll.
setTitle(String)

den Titel auf den übergebenen String setzen
GRAPHOMATECHART_1.setTitle("Sales in Mio. EUR|2013 ACT and BUD|North West");

Setzt den Titel des Charts. Erwartet value als String. Zeilenumbrüche (\n) werden auch als solche interpretiert.
setUseOutlierThreshold(Boolean)GRAPHOMATECHART_1.setUseOUtlierThreshold(true);Diese Funktion setzt, ob die Ausreißergrenze verwendet werden soll.
setUserHighlightColor(String)GRAPHOMATECHART_1.setUserHighlightColor("#ff0000,#00ff00,#0000ff");Setzt eine Liste der hinterlegten User Highlight-Farben. Erwartet einen kommaseparierten String. Die gesetzten Farben werden dabei in der angegebenen Reihenfolge bei den User Highlights (zur Laufzeit hervorgehobene Werte) durchgeschaltet, bis die Wunschfarbe eingestellt ist.
setUserHighlightList(String)GRAPHOMATECHART_1.setUserHighlightList("[[1,3],[2,3][1,5]]");Setzt ein oder mehrere User Highlights (zur Laufzeit hervorgehobene Werte). Erwartet einen JSON-String bestehend aus einem oder mehreren Arrays mit jeweils zwei Zahlen. Dabei gibt die erste Zahl die Datenreihe an, während die zweite Zahl die Position des Wertes in der Datenreihe darstellt.
setValueAxisVisible(Boolean)GRAPHOMATECHART_1.setValueAxisVisible(true);Diese Funktion schaltet die Anzeige der Value Axis an bzw. aus.
setVisibleSeries(String)

nur die Datenserien mit den Indices 1 und 2 anzeigen
GRAPHOMATECHART_1.setVisibleSeries("1,2");

Setzt die Auflistung der Indices sichtbarer Serien des Charts. Erwartet value als kommaseparierten String.
showStructureMode (Boolean)GRAPHOMATECHART_1.showStructureMode(true);Setzt die Ausrichtung des Charts. Wenn der Wert value TRUE ist, wird das Chart im Strukturmodus angezeigt, sonst im Zeitmodus.

Beispiele

Mit Hilfe einer Dropdown-Box eine Datasource dynamisch Filtern
Um auf einer Dimension einer Data Source dynamisch zu filtern, muss zuerst eine Dropdown-Box mit allen zulässigen Werten befüllt werden, damit der User aus dieser später dann seine Wahl treffen kann.
Dafür wird auf dem Canvas-Event On Startup von der gewünschten Data Source mit getMemberList eine Liste aller Member der Dimension 0D_NWI_ACOD geholt. Die Parameter von getMemberList werden dabei vom Autocomplete vorgeschlagen.
Die so erlangte Liste kann dann per setItem auf die Dropdown-Box gesetzt werden.
DROPDOWN_1.setItems (DS_1.getMemberList("0D_NWI_ACOD",
MemberPresentation.EXTERNAL_KEY, MemberDisplay.TEXT, 20);
Nun wird die Dropdown-Box beim Applikations-Start mit den Membern der Dimension 0D_NWI_ACOD befüllt.
Selektiert nun ein User ein Element aus der Liste, kann mit folgendem Skript, welches auf das Ereignis On Element Clicked der Dropdown-Box gelegt wird, der Filter der Data Source angepasst werden:
DS_1.setFilterExt("0D_NWI_ACOD", DROPDOWN_1.getSelectedValue());

Die Filter einer Data Source entfernen

Sollen die Filter einer Data Source wieder entfernt werden, kann dies mit folgendem Aufruf getan werden:
DS_1.clearAllFilters();

Per Drilldown auf einem graphomate Chart eine Data Source filtern

Soll ein Drilldown mit den graphomate charts realisiert werden, muss vorher eine Bedingung erfüllt sein:
Es muss die Property categoryLabels befüllt sein! Die Kategorienbeschriftungen müssen dabei nicht sichtbar sein, können dies aber natürlich. Das ist notwendig, weil das Chart nur über diese Property Informationen über Dimensionen und Members erhalten kann.
Wenn diese Vorbedingung erfüllt ist, kann auf dem Event On Element Clicked des graphomate Charts mit folgendem Skript der Schlüssel (Key) des selektierten Dimensionsmember erhalten werden:
var key = GRAPHOMATECHART_1.getSelectedMemberKey("0D_NWI_RCOD");
Als Parameter muss der Schlüssel (Key) der gewünschten Dimension übergeben werden.

Dieser so erlangte Memberkey kann nun - analog wie bei dem Beispiel der Dropdown-Box - als Filter auf eine Data Source gesetzt werden:
DS_1.setFilter("0D_NWI_RCOD", key);
bzw. zusammengezogen:
DS_1.setFilter("0D_NWI_RCOD", GRAPHOMATECHART_1.getSelectedMemberKey("0D_NWI_RCOD"));

Titel nach Drilldown setzen

Um auch den Titel des Charts an den Drilldown anzupassen – zum Beispiel um die selektierte Region anzuzeigen - kann parallel zum Memberkey auch der Membertext ausgelesen werden.
var region = GRAPHOMATECHART_1.getSelectedMemberText("0D_NWI_RCOD");
Dieser Text kann dann natürlich beliebig weiter verwendet werden oder wie hier in den Titel hinein geschrieben werden:
GRAPHOMATECHART_1.setTitle("Selected region: " + region);

Zooming-Funktion

Um eine Zoom-Funktionalität für ein Chart umzusetzen, muss der Skalierungsmodus des Charts auf Manual stehen. Dies kann entweder voreingestellt oder über die Skriptfunktion realisiert werden:
GRAPHOMATECHART_1.setScaleModeManual();
Danach wird das onElementClicked-Event des entsprechenden Charts mit folgendem Skript versehen:
var value = GRAPHOMATECHART_1.getClickedPositionValue();
GRAPHOMATECHART_1.setManualScaleMinimumFloat(value);
Zunächst wird dabei der relative Wert der Klickposition ermittelt. In der zweiten Zeile wird dieser Wert dann als Minimum für die manuelle Skalierung eingesetzt und somit ein Zoom erreicht.

...