Tachodiagramm | X4Documentation

Mit einem Tachodiagramm können Zustände mit unterschiedlichen Bewertungen dargestellt werden. Es ist gut geeignet, um Soll-/Ist-Werte zu vergleichen, z. B. bei Kennzahlen, Kundenzufriedenheits- oder Qualitätsmessungen.

Ein Tachodiagramm kann folgende Elemente enthalten:

<Gauge>: Gibt an, wie das Diagramm angezeigt werden soll.
<Tooltip>: Kindelement von <Gauge>. Definiert, wie der Tooltip für die einzelnen Werte im Diagramm angezeigt werden soll.

Allgemeine Attribute

Folgende Attribute sind für alle Elemente eines Tachodiagramms verfügbar:

Attribut	Beschreibung
`fontFamily`	Legt die Schriftfamilie fest. Mit diesem Attribut wird die Standardschrift der Web App für dieses Control überschrieben. Wird das Attribut auf einem Element definiert, so wird die Schriftfamilie an die Kindelemente des Elementes vererbt, sofern die Kindelemente das Attribut `fontFamily` nicht explizit gesetzt haben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: `MainFont`: hinterlegte Hauptschrift Fontcode aus der Font-Palette, z. B. `Font04`
`fontSize`	Legt die Schriftgröße fest. Mit diesem Attribut wird die Standardschriftgröße der Web App für dieses Control überschrieben. Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`. Mögliche Werte: Beliebige ganze Zahl oder Dezimalzahl mit einem Punkt als Dezimaltrennzeichen, z. B. `20` ; `20.8` ; `.9` Schriftgröße in Pixel, z. B. `20px` Schriftgröße in Punkt, z. B. `18pt` Schriftgröße im Vergleich zur Schriftgröße des Elternelements, z. B. `.8em` oder `120%` Schlüsselwörter: `xx-Small` , `x-small` , `small` , `medium` , `large` , `x-large` , `xx-large` , `smaller` , `larger`
`fontStretch`	Legt die Breite der einzelnen Schriftzeichen fest. Mit diesem Attribut wird die Standardbreite der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Condensed` `Expanded` `ExtraCondensed` `ExtraExpanded` `Medium` `Normal` (Standard) `SemiCondensed` `SemiExpanded` `UltraCondensed` `UltraExpanded` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map`, `Chart` und `HtmlDocument`.
`fontStyle`	Legt die Neigung der Schrift fest. Mit diesem Attribut wird die Standardneigung der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `italic`: kursive Schrift `normal`: normale Schrift (Standard) `oblique`: schräg gestellter Schriftstil (berechnet) Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`fontWeight`	Legt die Schriftstärke fest. Mit diesem Attribut wird die Standardstärke der Schriftzeichen für dieses Control überschrieben. Mögliche Werte: `Black` `Bold` `DemiBold` `ExtraBlack` `ExtraBold` `ExtraLight` `Heavy` `Light` `Medium` `Normal` (Standard) `Regular` `SemiBold` `Thin` `UltraBlack` `UltraBold` `UltraLight` Dieses Attribut funktioniert nicht für die Elemente `Image`, `Map` und `HtmlDocument`.
`foreground`	Definiert die Schriftfarbe. Diese Einstellung überschreibt die Standardfarbe des Farbschemas! Mögliche Werte: Hexadezimaler Farbwert, z. B. `ff5a00` Verwenden Sie keine Raute vor dem Farbwert! Verwenden Sie keine verkürzte Schreibweise des Farbwerts! Farbcode aus der Farbpalette der Web App (vgl. (7.3.3-de) Theming), z. B. `A200`

Gauge

<Gauge>: Gibt an, wie das Diagramm angezeigt werden soll.

Zusätzlich zu den allgemeinen Attributen kann <Gauge> folgende Attribute haben:

Attribut	Beschreibung
`axisMax`	Gibt den Endbereich des Tachodiagramms in Prozent an. Die Farbe des Bereichs wird im Theming Editor über die Farbeigenschaft `GaugeAxisMax` definiert. Mögliche Werte: Ganzzahl zwischen `0` und `100` (Standard: `100`) Beispiel Die Standardwerte (`axisMin="20"`, `axisMiddle="80"`, `axisMax="100"`) definieren ein Tachodiagramm, bei dem die Bereiche von 0 bis 20 %, 20 bis 80 % und 80 bis 100 % farblich unterschiedlich dargestellt werden.
`axisMiddle`	Gibt den mittleren Bereich des Tachodiagramms in Prozent an. Die Farbe des Bereichs wird im Theming Editor über die Farbeigenschaft `GaugeAxisMiddle` definiert. Mögliche Werte: Ganzzahl zwischen `0` und `100` (Standard: `80`)
`axisMin`	Gibt den Anfangsbereich des Tachodiagramms in Prozent an. Die Farbe des Bereichs wird im Theming Editor über die Farbeigenschaft `GaugeAxisMin` definiert. Mögliche Werte: Ganzzahl zwischen `0` und `100` (Standard: `20`)
`endAngle`	Gibt den Endpunkt des Tachodiagramms an. Mögliche Werte: Ganzzahl zwischen `-360` und `360` (Standard: `-45`) `endAngle` muss immer kleiner sein als `startAngle`.
`legend`	Gibt an, ob eine Legende angezeigt werden soll. Mögliche Werte: `true` (Standard) / `false`
`max`	Gibt den Maximalwert des Tachodiagramms an. Mögliche Werte: Ganzzahl (Standard: `100`)
`min`	Gibt den Minimalwert des Tachodiagramms an. Mögliche Werte: Ganzzahl (Standard: `0`) Die Verbindung von `min` zu `max` erfolgt immer im Uhrzeigersinn.
`startAngle`	Gibt den Startpunkt des Tachodiagramms an. Mögliche Werte: Ganzzahl zwischen `-360` und `360` (Standard: `255`) Bei dieser Angabe entsprechen folgende Ganzzahlen folgenden Positionen auf einer Uhr: `0`: 3 Uhr `90`: 12 Uhr `180`: 9 Uhr `270`: 6 Uhr
`value`	Gibt an, welcher Wert des Datenobjekts visualisiert wird. Mögliche Werte: Beliebige Zeichenkette oder Data Binding

<Tooltip>: Kindelement von <Gauge>. Definiert, wie der Tooltip für die einzelnen Werte im Diagramm angezeigt werden soll.

Für <Tooltip> lassen sich die allgemeinen Attribute (s.o.) definieren.

Beispiele

XML

<Properties>
	<Property name="DataSource" type="Complex">
		<Property name="Satisfaction" type="Integer"/>
	</Property>
</Properties>
<FlowLayout>
	<Chart fontFamily="Font03" title="Employee Satisfaction">
		<Gauge  max="0" min="100" value="#DataSource.Satisfaction">
			<Tooltip fontFamily="Font02" fontSize="12"/>
		</Gauge>
	</Chart>
</FlowLayout>

Das obige Beispiel führt zu folgendem Diagramm:

XML

<Property name="Datasource" type="Complex">
    <Property name="gauge" type="Integer"/>
 
...
...
...
</Property>
 
<Chart title="Gauge">
    <Gauge value="#Datasource.gauge" min="0" max="250" startAngle="-60" endAngle="-270" axisMin="0" axisMiddle="50" />
</Chart>
 
<Chart title="Gauge">
    <Gauge value="#Datasource.gauge" min="0" max="15" startAngle="75" axisMin="80" axisMiddle="90" />
</Chart>
 
<Chart title="Gauge">
    <Gauge value="#Datasource.gauge" min="-1" max="250" startAngle="120" />
</Chart>

Das obige Beispiel führt zu folgenden Diagrammen

Funktionsweise und weitere Beispiele für Tachodiagramme

Bei Tachodiagrammen muss folgendes beachtet werden:

endAngle muss kleiner sein als startAngle.
Die Verbindung vom Startwinkel zum Endwinkel erfolgt immer im Uhrzeigersinn.
Die Verbindung von min zu max (Skala) erfolgt immer im Uhrzeigersinn.

Im Folgenden sind weitere Beispiele für Tachodiagramme mit Erläuterung aufgezeigt, um die Funktionsweise des Start- und Endwinkels zu verdeutlichen.

Definition	Ergebnis	Erläuterung
`<Gauge startAngle="0" endAngle="-180" min="0" max="100" ...>`
`<Gauge startAngle="90" endAngle="-90" min="0" max="100" ...>`
`<Gauge startAngle="180" endAngle="0" min="0" max="100" ...>`
`<Gauge startAngle="-90" endAngle="-270" min="0" max="100" ...>`
`<Gauge startAngle="240" endAngle="-60" min="0" max="100" ...>`