X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Kreis-/Donutdiagramm

Mit einem Kreisdiagramm kann der Anteil einzelner Daten an der Gesamtheit veranschaulicht werden.

Hinweise zur Verwendung

Ein Kreis-/Donutdiagramm wird mit dem Element <Pie> innerhalb des Elements <Chart> erzeugt. Das Element kann nur im Layout einer Detail Component verwendet werden.

XML
<Chart>
    <Pie/>
</Chart>

Das Element <Pie> kann folgendes Element enthalten:

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

Attribute

Folgende Attribute können Sie für alle Elemente eines Kreis-/Donutdiagramms definieren:

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.

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.

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

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)

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

foreground

Definiert die Schriftfarbe.

Diese Einstellung überschreibt die Standardfarbe des Farbschemas!

Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

Hinweis:

  • Verwenden Sie keine Raute vor dem Farbwert.

  • Verwenden Sie keine verkürzte Schreibweise des Farbwerts.

  • Farbcode aus der Farbpalette der Web App, z. B. A200
    Weitere Informationen finden Sie unter Theming.

Element <Pie>

Gibt an, wie das Diagramm angezeigt werden soll.

Zusätzlich zu den allgemeinen Attributen können Sie folgende Attribute für das Element <Pie> definieren:

Attribut

Beschreibung

data 

Erforderlich

Gibt an, welche Daten im Diagramm dargestellt werden. Die angegebene Zeichenkette bezieht sich auf eine definierte Property innerhalb der Datenquelle, die im Element <Chart> angegeben wird.

Mögliche Werte:

Data Binding

name 

Erforderlich

Gibt den Namen an, der dem jeweiligen Wert zugeordnet ist (Datenbeschriftung). Die angegebene Zeichenkette bezieht sich auf eine definierte Property innerhalb der Daten, die für data angegeben werden.

Mögliche Werte:

Data Binding

value 

Erforderlich

Gibt an, welcher Wert des Datenobjekts visualisiert wird. Die angegebene Zeichenkette bezieht sich auf eine definierte Property innerhalb der Daten, die für data angegeben werden.

Mögliche Werte: 

Data Binding

avoidLabelOverlap

Legt fest, ob das Überlappen von Beschriftungen verhindert werden soll.

Mögliche Werte:

  • true (Standard): Das Überlappen von Beschriftungen wird verhindert.

  • false: Das Überlappen von Beschriftungen wird nicht verhindert.

center1

Legt die horizontale Position des Diagramms fest.

Mögliche Werte:

  • Beliebige Ganzzahl (Standard: 50)

center2

Legt die vertikale Position des Diagramms fest.

Mögliche Werte:

  • Beliebige Ganzzahl (Standard: 50)

color

Farbe des einzelnen Diagrammausschnitts

Mögliche Werte: 

Hexadezimaler Farbwert oder Ausdruck für Data Binding (Color)

Wird das Attribut color nicht definiert, werden die im Theming Editor definierten Farben verwendet.  

donut 

​Gibt an, ob das Diagramm als Donutdiagramm dargestellt werden soll.

Mögliche Werte: true / false (Standard)

labelColor

Legt die Schriftfarbe der Beschriftung fest.

Überschreibt die Farbe aller Beschriftungen des Charts.

Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

Hinweis:

  • Verwenden Sie keine Raute vor dem Farbwert.

  • Verwenden Sie keine verkürzte Schreibweise des Farbwerts.

  • Farbcode aus der Farbpalette der Web App, z. B. A200
    Weitere Informationen finden Sie unter Theming.

labelOverflow

Gibt an, was passieren soll, wenn die Beschriftung länger als die festgelegte Breite der Beschriftung ist.

Mögliche Werte:

  • none: Verhindert einen Textumbruch (Standard)

  • truncate: Mit ... zeigen, dass der Text nicht zu Ende ist

  • break: Text zwischen den Wörtern umbrechen

  • breakAll: Innerhalb des Wortes abbrechen

labelWidth

Legt die Breite der Beschriftung in Pixeln fest.

Mögliche Werte:

  • Beliebige Ganzzahl

legend 

​Gibt an, ob eine Legende angezeigt werden soll.

Mögliche Werte: 

  • true (Standard)

  • false 

normals 

Gibt an, ob die Werte direkt im Diagramm beschriftet werden sollen.

Mögliche Werte: 

  • true 

  • false (Standard)

radius1

Legt den Radius in Pixeln fest.

Mögliche Werte:

  • Beliebige Ganzzahl (Standard: 50)

radius2

Legt den äußeren Radius in Pixeln fest.

Nur relevant, wenn das Attribut donut="true" gesetzt ist.

Mögliche Werte:

  • Beliebige Ganzzahl (Standard: 80)

tooltipPercentage

Legt fest, ob zusätzlich zum Wert eine Prozentangabe in der Beschriftung und im Tooltip angezeigt wird.

Mögliche Werte:

  • true (Standard): Prozentangabe wird angezeigt.

  • false: Prozentangabe wird nicht angezeigt.

Element <Tooltip>

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

Für das Element <Tooltip> können Sie die allgemeinen Attribute (siehe oben) definieren.

Beispiel

XML
<Properties>
	<Property name="DataSource" type="Complex">
		<Property name="ABC-Analysis" type="List">
			<Property name="ItemGroup" type="String"/>
			<Property name="Profit" type="Integer"/>
		</Property>
	</Property>
</Properties>
<FlowLayout>
	<Chart fontFamily="Font03" title="ABC-Analysis / Profit from different item groups">
		<Pie data="#DataSource.ABC-Analysis" fontFamily="Font03" name="#ItemGroup" normals="false" value="#Profit">
           <Tooltip fontFamily="Font03"/>
        </Pie>
	</Chart>
	<Chart fontFamily="Font02" title="ABC-Analysis / Profit from different item groups">
		<Pie data="#DataSource.ABC-Analysis" donut="true" fontFamily="Font03" name="#ItemGroup"  normals="true" value="#Profit">
			<Tooltip fontFamily="Font03"/>
		</Pie>
	</Chart>
</FlowLayout>


Output

Die Daten, die vom Technical Process geliefert werden, haben folgendes Format:

XML
<Ok>
	<DataSource>
		<ABC-Analysis>
			<ItemGroup>A</ItemGroup>
			<Profit>1200000</Profit>
			<ItemGroup>B</ItemGroup>
			<Profit>500000</Profit>
			<ItemGroup>C</ItemGroup>
			<Profit>90000</Profit>
			</ABC-Analysis>
	</DataSource>
</Ok>


image-20251125-080732.png