|
<< 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)
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.