Element "Chart"

<< Click to Display Table of Contents >>

Navigation:  Konfigurierung Webinterface > Individuelles Maskenlayout > Elemente im individuellen Maskenlayout >

Element "Chart"

Mit rimacon-Charts können Daten grafisch dargestellt werden. Hierbei ist sowohl die Abbildung der Rohdaten als auch eine statistische Auswertung, wie z.B. Summe, Maximum, Minimum, Anzahl etc. möglich.

Die Datenquelle wird über fixes oder parametrisiertes SQL erzeugt. Um Datenreihen zu gruppieren bzw. zu

aggregieren, wird eine Spalte als Rubrikachse aus der Quelle ausgewählt.

 

 

Attribute

 

visible

Legt fest, ob das Element nach Initiierung der Maske angezeigt wird.

 

andere

„Bei Initiierung Chart generieren“: Wenn nicht angekreuzt, muss der Chart über refresh() generiert werden.

 

design

Siehe Maske Design.

 

 

Funktionen

 

getDOMObject()

Gibt das Javascript-DOM-Objekt zurück.

 

Beispiel:

RU.Chart1.getDOMObject().style.border = "3px solid red";

 

getHeight(),  getLeft(),  getPosition(),  getSize(), getTop(), getWidth(), setHeight(height), setLeft(left), setPosition(left,top), setSize(width,height), setTop(top), setWidth(width)

siehe auch Position und Größe

 

Parameters

Enthält die Parameter für SQL, siehe Maske Design Reiter SQL

 

refresh()

Chart wird neu generiert.

 

show(bShow)

Zeigt oder versteckt das Objekt.

 

 

Ereignisse

 

onDataClick

Bei Anklicken eines Daten-Items. Weitere Informationen stehen in folgenden Variablen zu Verfügung:

event: windows-Event Objekt

ctx.ChartElementType: z.B. “DataPoint”, “DataPointLabel”, …

ctx.PointIndex: 0-basierter Index

ctx.SeriesIndex: 0-basierter Index der Datenreihe

ctx.CategoryText: Text aus der Rubrikenachse

 

 

Server-Ereignisse

 

RetrieveData

Wenn definiert, werden die Daten in diesem Script (nicht über SQL) erzeugt.

Speichern Sie die Daten als System.Data.DataTable-Klasse und setzen das Ergebnis in ctx.DataTable

var dt = new System.Data.DataTable();

dt.Columns.Add("status");

dt.Columns.Add("cnt");

dt.Rows.Add("Ist", 20);

dt.Rows.Add("Soll", 30);

 

ctx.DataTable = dt;

 

Hinweis: Folgende zwei DLLs müssen referenziert werden:

System.Data.dll

System.xml.dll

 

BeforeRender

Wird immer vor der Renderierung aufgerufen. In „ctx.RenderedChart“ steht das Chart-Objekt (vom Typ System.Windows.Forms.DataVisualization.Charting.Chart) und ermöglicht spezifische Änderungen.

 

Hinweis: Folgende zwei DLLs müssen referenziert werden:

System.Windows.Forms.dll

System.Windows.Forms.DataVisualization.dll

 

Maske Chart Designen

Reiter „Allgemein“

Dieser Reiter wird in den individuellen Masken nicht genutzt und gilt für Charts, die ohne individuelle Masken genutzt werden können.

 

Name

Chartname

 

Zeichenfolge zur Identifikation

Diese Zeichenfolge kann in einer URL als Parameter für pChartID genutzt werden.

 

Berechtigungen nutzen

Wenn aktiv, wird geprüft, ob der aktueller Webbenutzer für den Chart berechtigt ist.

 

Reiter „SQL“

Über diesen Reiter wird die Datenbasis definiert. Hierbei ist die Verwendung von Parametern möglich.

 

Reiter „Chart Eigenschaften“

Hier werden die Basiseigenschaften definiert. Beachten Sie bitte den Diagrammtyp. Soll den einzelnen

Datenreihen jeweils ein Typ zugeordnet werden, wählen Sie „für einzelne Datenreihen“. Soll ein Typ für alle

Datenreihen übernommen werden, wählen Sie „gemeinsam für alle Datenreihen“.

Wenn die Option „SQL“ aktiv ist, wird der eingegebene Text als SQL betrachtet und ausgeführt. Das Ergebnis wird in der Überschrift angezeigt. Die unter Reiter definierten Parameter können hier genutzt werden.

 

Reiter „Achsen“

Rubrikenachse (X)

Die Eigenschaft "Spalte" gruppiert bzw. aggregiert die Datenquelle. Jeder Wert aus dieser Spalte wird auf der Rubrikachse einmal angezeigt.

 

Größenachse (Y)

Über die Größenachse Y wird die optische Darstellung definiert. In Datenreihe werden die Werte für die

Datenreihe definiert.

 

Reiter „Datenreihen“

Über Datenreihen wird definiert, welche Daten über welche Funktion angezeigt werden.

Datenreihen werden über die vier Buttons „Hinzufügen“, “Löschen“, „Nach oben“ und „Nach unten“ verwaltet.

Per Rechtsklick oder Doppelklick der linken Maustaste können die Datenreihen konfiguriert werden.

 

Maske „Eigenschaften Datenreihe“

Reiter „Datenreihentyp“

Hier werden die Datenreihentypen angezeigt und können ausgewählt werden.

 

Reiter „Allgemein“

Daten können hier identifiziert und über bestimmte Funktionen gruppiert bzw. aggregiert werden. Die

Identifizierung erfolgt hier über den Titel der Spalte, die die Rubrikachse darstellt.

Optional kann dieser Titel in der Legende angezeigt werden. Für eine Gruppierung wird der Inhalt einer Spalte ausgewählt und eine entsprechende ausgewählte Funktion mit diesen Daten ausgeführt.

 

Hinweis: Bei der Funktion „Anzahl“ wird nur die Häufigkeit eines bestimmten Wertes aus der Rubrikachse

gezählt. Andere Spalten werden ignoriert.

 

Reiter "Datenbeschriftungen"

Hier wird die Kennzeichnung der Datenpunkte (z.B. in Säulen oder Kreisstücke) angegeben. Dies ist vom

jeweiligen Typ der Datenreihe abhängig.

Bei einer Darstellung als Säulen oder Balken ist es z.B. sinnvoll, nur die Werte anzuzeigen oder bei Kreisen z.B. den dazugehörigen Namen der Kategorie anzuzeigen.

 

Reiter "Legende"

In diesem Reiter wird der Text der Legende definiert. Dieser ist vom jeweiligen Typ der Datenreihe abhängig. Bei Säulen und Balken ist es z.B. sinnvoll, nur den Namen der Datenreihe anzuzeigen oder bei Kreisen z.B. die jeweiligen Werte.

 

Reiter "Datenpunkte formatieren"

Hier kann die Gesamtheit oder eine Auswahl der konkreten Datenpunkte individuell formatiert werden. Die optischen Eigenschaften der Datenpunkte werden normalerweise von der Datenreihe übernommen. Wenn die Datenpunkte fix und bekannt sind, kann es sinnvoll sein, die optischen Eigenschaften für jeden Datenpunkt zu definieren.

Beispiel: Hat man als Ergebnis die drei immer wiederkehrenden Datenpunkte „unterlizensiert“, “überlizensiert“ und „ok“, dient es der Übersichtlichkeit, jeden Datenpunkt farbig entsprechend kenntlich zu machen.