Beispiel

Man will den Umsatz eines Kunden als Chart bzw. Diagramm darstellen. Die Werte zu einem Diagramm werden mit einem Diagramm-Businessobjekt erzeugt.

Diagramm-Businessobjekt erzeugen

Die Erzeugung eines Diagramm Businessobjekt  geschieht im Grunde über eine Datenquelle. Diese Datenquelle benötigt zwei Pflichtspalten:

• INTID (Id des Objektes, in dem die Referenz gespeichert ist)
• INTID_T_UD_GENERICOBJECT (Id des Objektes, in dem die referenzierten Daten als Diagramm eingebettet werden sollen)

Diese Spalten dürfen nicht verändert werden und müssen in der Abfrage einbezogen sein.

Ebenso muss ein Parameter "genericObject" (default vorhanden) angegeben sein, der auf ein Object verweist, in dem die referenzierten Daten als Diagramm eingebettet werden sollen.

Weitere Parameter (zb. auch mit einem ValueList-Provider versehen) können definiert werden. Diese werden dann neben dem Chart eingeblendet und man kann diese dort bestimmen/eintragen. (siehe Darstellung in der Detail-Maske)

Alle weiteren Spalten, die jetzt hinzugefügt werden, können im Diagramm dargestellt werden. Dabei wird der eingetragene Aliasname als Spaltenüberschrift verwendet.

Unterformular im Layout einbetten

Das zuvor erstellte Diagramm-Businessobjekt  bezieht sich auf einen übergeordneten Datensatz (hier Kunde). Es ist immer der Datensatz an dem der Parameter $genericObject übergeben wird. Zum übergeordneten Businessobjekt verhält sich das  Diagramm-Businessobjekt wie ein Unterformular und wird im Layout als solchen eingebunden. Dazu gehört das Festlegen der Berechtigung für den Zugriff auf die Daten des übergeordneten Businessobjektes. Die Berechtigung eines Unterformulars wird unter Konfiguration -> Statusmodell ->Tab: Berechtigungen vorgenommen.

Die Berechtigung muss für jeden Staus vorgenommen werden.

Allgemeine Hinweise

Ein Diagramm Businessobjekt dient nur zur Information. Daten bearbeiten ist hier nicht möglich.

Einbindung als Chart im Layout-Editor

Die Visualisierung des  Diagramm-Businessobjekt erfolgt über die Konfiguration->Layout  mit der Layout-Komponente "Chart".

m ersten Schritt legen wir einen neuen Reiter zu den bestehenden Unterformulare an. Mit einem Rechts-Klick neben den bestehenden Tabs kann aus dem erscheinenden Kontextmenü "Reiter hinzufügen" ausgewählt werden. Wie in der Abb. zu sehen wird im folgenden Dialog ein Namen vergeben. (Hier Diagramm)

Der Layouteditor bietet rechts unter dem Tab Palette die Layout-Komponente "Chart", welche via Drag&Drop in an seinen Platz gezogen wird.

Anschließend wird die Diagramm-Komponente über ihre Eigenschaften eingerichtet. Hier wird festgelegt welches Businessobjekt  dem Diagramm zugrunde liegt und unter der Eigenschaft "Fremdschlüssel" wird der Parameter angegeben. Das Einrichten, welche Art Diagramm ausgeführt werden soll, erfolgt über die Eigenschaft " Erweiterte Eigenschaften". In den folgenden Dialogen wird festgelegt welches Diagramm und welche Werte dargestellt werden sollen. Ein Beispiel soll anhand des Pie-Charts gegeben werden.

Ist der Chart-Type gewählt kommt man mit dem Betätigen der Schaltfläche "Next" zum nächsten Dialog der "Domain-Daten". An dieser Stelle werden die Attribute aus dem Diagramm-Businessobjekt eingetragen. (Hier: dblvknettogesamt und strname -> prozentualer Anteil pro Artikel)

Ein abschließender Dialog "Eigenschaften" bietet die Möglichkeit, am Look&Feel des Diagramms, Einfluss zu nehmen. Damit wäre die Einrichtung eines Diagramm-Businessobjekt und Chart abgeschlossen.