Scripting-Dokumentation der graphomate legends für SAP Lumira DesignerVersion 2.0 – Stand August 2017September 2018
EinführungDie graphomate legends unterstützt die Skriptsprache von Designer. Somit ist es möglich, die Extension zur Laufzeit interaktiv zu verwenden. Beispielsweise können neue Daten gesetzt, Titel bearbeitet und Skalierungen verändert werden. Eine Auflistung der gegenwärtigen Funktionen und Beispiele zur Verwendung liefert dieses Dokument. Wir sind bemüht, den Funktionsumfang ständig zu erweitern. Sollten Ihnen bestimmte Funktionen fehlen, teilen Sie uns dies gerne über unser Kontaktformular mit.
FunktionenFolgende Funktionen stehen zur Verfügung. Diese können innerhalb des Skript-Editors von Designer angesprochen werden.
| Getter Name | Beispiel | Rückgabetyp | Beispiel Rückgabewert | Beschreibung |
|---|
| getBoldText() | GRAPHOMATELEGENDS_1.getBoldText(); | boolean | false | Gibt true zurück, wenn die Legendeneinträge fett formatiert sind, ansonsten false. | | getColoredText() | GRAPHOMATELEGENDS_1.getColoredText(); | boolean | true | Gibt true zurück, wenn die Beschriftung der Legendeneinträge in der Farbe des dazugehörigen Icons eingefärbt sind, ansonsten false. | | getDataSet(int dataSetIndex) | GRAPHOMATELEGENDS_1.getDataSet(1); | String | '{"0D_NWI_RCOD":"80503"}' | Gibt den Selektionsstring der übergebenen Daten-Property zurück. | | getShowIcons() | GRAPHOMATELEGENDS_1.getShowIcons(); | boolean | true | Gibt true zurück, wenn zusätzlich zur Beschriftung ein Icon angezeigt werden soll, ansonsten false. | | getFollowingIcons() | GRAPHOMATELEGENDS_1.getFollowingIcons(); | boolean | false | Gibt true zurück, wenn die Icons rechts von der Beschriftung angezeigt werden sollen, ansonsten false. | | getSelectedMember() | GRAPHOMATELEGENDS_1.getSelectedMember("0D_NWI_RCOD"); | Member |
| Gibt den Member der übergebenen Dimension zum zuletzt angeklickten Legendeneintrag zurück. | | getVerticalAlignment() | GRAPHOMATELEGENDS_1.getVerticalAlignment(); | boolean | false | Gibt true zurück, wenn die Legendeneinträge vertikal ausgerichtet sind, ansonsten false. |
| Setter Name | Beispiel | Beschreibung |
|---|
| setBoldText(boolean) | GRAPHOMATELEGENDS_1.setBoldText(true); | Bestimmt, ob die Legendeneinträge fett formatiert sein sollen. | | setColoredText(boolean) | GRAPHOMATELEGENDS_1.setColoredText(true); | Bestimmt, ob die Beschriftung der Legendeneinträge in der Farbe der dazugehörigen Icons eingefärbt sein sollen. | | setDataSet(int dataSetIndex, String dataSet) | GRAPHOMATELEGENDS_1.setDataSet(1, ‘{“0CALMONTH”:”22009”}’); | Setzt die Daten-Property mit dem übergebenen Index auf den übergebenen Selektionsstring. | | setEntryOption(int index, String targetProperty, String newValue) | GRAPHOMATELEGENDS_1.setEntryOption(1, “shape”, “circle”); | Mit dieser Skript-Funktion lässt sich eine einzelne Eigenschaft eines Legendeneintrags verändern. Folgende Parameter müssen übergeben werden: - index: Index des zu ändernden Legendeneintrags. Wenn der Index nicht vorhanden ist, wird stattdessen ein neuer Legendeneintrag generiert. - targetProperty: Name der zu ändernden Property („shape“, „filltype“, „color“ oder „text“) - newValue: Neuer Wert der Property Folgende Werte werden akzeptiert: - Für die Property „shape“: „rect“, „circle“ und „rhomb“ - Für die Property „filltype“: „filled“, „hatchedUp“, „hatchedDown“, „dotted“, „empty“ - Für die Property „color“ kann eine beliebige Farbe im Hex-Format angegeben werden (z. B. „#000000“ für Schwarz oder „#ff0000“ für Rot. - Als Text kann eine beliebige Zeichenkette angegeben werden. Im Fall von ungültigen Parameterangaben fällt der Legendeneintrag auf den Standardwert zurück; dies ist ein vollständig gefülltes, schwarzes Viereck. | | setShowIcons(boolean showIcons) | GRAPHOMATELEGENDS_1.setShowIcons(false); | Bestimmt, ob zusätzlich zur Beschriftung der Legendeneinträge ein Icon angezeigt werden soll. Mit Übergabe von false werden die Icons ausgeblendet. | | setFollowingIcons(boolean followingIcons) | GRAPHOMATELEGENDS_1.setFollowingIcons(true); | Bestimmt, ob die Icons links oder rechts der Beschriftung angezeigt werden (true = rechts, false = links) | | setColoredText(boolean) | GRAPHOMATELEGENDS_1.setColoredText(true); | Bestimmt, ob die Beschriftung der Legendeneinträge in der Farbe der dazugehörigen Icons eingefärbt sein sollen. |
|