Inhalt:

• • Daten- / Objektstruktur
  • Füllen von Daten
  • Chartkonfiguration
    • Größe und Positionierung
    • Allgemeines: 3D, Donut, Drehung
    • Konfiguration Farben
    • Konfiguration Texte
    • Konfiguration Grenzwerte
    • Konfiguration Tooltips
    • Konfiguration Slices

• • Optimale Datenstruktur
  • Beispiel: Füllen der Daten

Anchor
Data Data

Optimale Datenstruktur (Datenbank)

Optimale Objektstruktur (Java)

public class PieChartObject {
	private String category;
	private Integer value;

	public String getCategory() {
		return this.category;
	}

	public void setCategory(final String category) {
		this.category = category;
	}

	public Integer getValue() {
		return this.value;
	}

	public void setValue(final Integer value) {
		this.value = value;
	}
}

Anchor
Fill Fill

Beispiel: Füllen der Daten

XdevPieChartModelfinal ChartModel model = new XdevPieChartModel( ChartModel.New()
	.addColumn(Column.New(Type.STRING))
	.addColumn(Column.New(Type.NUMBER));

model.addItemaddRow("BeveragesKatze", 393, null50);
model.addItemaddRow("CondimantsHund", 507, null25);
model.addItemaddRow("ConfectionsSchlange", 386, null25);

chartthis.pieChart.setModel(model);

oder per Schleife aus Query-Methode:

final XdevPieChartModelChartModel model = new XdevPieChartModel( ChartModel.New()
	.addColumn(Column.New(Type.STRING))
	.addColumn(Column.New(Type.NUMBER));

new ProductDAO().getProductsByCategoryForChart().forEach(p -> {
       model.addItemaddRow(p.getCategory().getCategoryname(), (int) p.getAmount(), null);
});

chart.setModel(model);

API und Methoden:

...

...

AnchorSizingSizingPositionierung und Größe des Pie innerhalb des Chartbereichs

...

...

model.addItem("Beverages", 393, null);

//Parameter 1 ("Beverages"): Wert als Kategoriebenennung für die "Kuchenstücke" 
//Parameter 2 (393): Wert für die Größe der Stücke. Zulässige Datentypen: Integer, Double
//Parameter 3 (Slice): Konfigurationsobjekt für dieses "Kuchenstück". Ist keine besondere Konfiguration notwendig wird einfach NULL übergeben.

...

XdevPieChartConfig config = new XdevPieChartConfig();

final ChartArea area = new ChartArea();

area.setHeigth("100"); //Höhe des Pie
area.setWidth("100"); //Breite des Pie
area.setLeft("100"); //Abstand des Pie von Links in Pixel
area.setRight("100"); //Abstand des Pie von Links in Pixel
area.setTop("100"); //Abstand des Pie von Links in Pixel

config.setChartArea(area);

...

pieChart.setPieHole(0.5);

...

XdevPieChartConfig config = new XdevPieChartConfig();

config.setIs3D(false); //3D Darstellung ein- oder ausschalten
config.setPieHole(0.4); //Darstellung als Donut-Chart ein- oder ausschalten. Wert zwischen 0 und 1 in Abhängigkeit des Pie Radius
config.setPieStartAngle(3); //Drehung des PieCharts in Grad

...

XdevPieChartConfig config = new XdevPieChartConfig();

config.setLegend(...); //Siehe API Allgemein "LegendOptions"
config.setTitleTextStyle(...); //Siehe API Allgemein "TextStyle"
config.setFontName(""); //Wahl der Schriftart (Schriftart muss vom Browser unterstützt werden)
config.setFontSize(15); //Setzen allgemeine Schriftgröße im Chart
config.setTitle("Sales Overview"); //Setzen ChartTitel

//Konfigurieren welcher Wert im Slice als Beschriftung angezeigt werden soll. 
//Mögliche Werte
// - XdevPieChartConfig.PIESLICETEXT_PERCENTAGE --> Prozentsatz des Slice in Abhängigkeit zu allen anderen
// - XdevPieChartConfig.PIESLICETEXT_VALUE --> Wert des Slices
// - XdevPieChartConfig.PIESLICETEXT_LABEL --> Name des Slices / Name der Kategorie
// - XdevPieChartConfig.PIESLICETEXT_NONE --> Kein Text wird im Slice angezeigt
config.setPieSliceText(PIESLICETEXT_VALUE);

...

pieChart.setPieStartAngle(60);

...

XdevPieChartConfig config = new XdevPieChartConfig();

config.setBackgroundColor(...); //Siehe API Allgemein "BackgroundStyle"
config.setPieSliceBorderColor("Red"); //Setzen der Farben für die einzelnen Slices
config.setPieResidueSliceColor("red"); //Setzen allgemeine Schriftfarbe des Titles, SubTitles

pieChart.setPieSliceBorderColor("red");

...

XdevPieChartConfig config = new XdevPieChartConfig();

//Grenze für die Zusammenfassung mehrerer Slices. Kategorien welche einen bestimmte prozentuellen Wert nicht Überschreiten
//werden zu einem Slice zusammengefasst und als "Other" aufgeführt. Mögliche Werte 0 und 1 bezogen auf den prozentuellen Anteil.
config.setSliceVisibilityThreshold(0.15);
config.setPieResidueSliceLabel("Sonstige"); //Setzen des Titels für die zusammengefassten Kategorien Default: "Others"

...

pieChart.setPieSliceText(PieSliceText.PERCENTAGE);

...

XdevPieSlice slice = new XdevPieSlice();

slice.setColor("red"); //Farbe des XdevPieSlice wahlweise in Kurzschreibweise ("Red") oder Farbcodes ("#FFFFFF")
slice.setOffset(0.3); //Ausrückung des XdevPieSlice. Wert zwischen 0 und 1 in Abhängigkeit des Pie Radius
slice.setTextStyle(null); //TextStyle Objekt siehe dazu API Allgemein

model.addItem("Beverages", 393, slice);

...

pieChart.setSliceVisibilityThreshold(25);

...

pieChart.setIs3D(true);