BO-Wizard

In einem Businessobjekt werden alle Dinge eines Unternehmens eingeordnet. Typische Beispiele sind z.B. "Kunde", "Artikel" oder "Auftrag". Businessobjekte können, müssen aber nicht, ein Statusmodell haben.

Im Folgenden wird ausführlich und Schritt für Schritt erklärt wie sich ein Businessobjekt anlegen lässt und Erklärungen zu verschiedenen Einstellungen.

1. Businessobjekt erstellen / ändern

Erstellen:

Beim Anlegen eines Businessobjekts muss zunächst ein interner Name (im Bsp.: "Kunde") vergeben werden. Anhand dieses Namens wird später auch der Tabellenname der Datenbank erzeugt.
Der Interne Name darf aus max. 25 Zeichen bestehen.

Ist ein Name bereits vegeben, so wird der Anwender über einen roten Hinweis informiert.

Ändern:

Soll ein Businessobjekt geändert werden, trifft man die entsprechende Auswahl aus der Combobox. Mit dem Button "Businessobjekt entfernen", kann das BO gelöscht werden.

Ein BO kann erst gelöscht werden, wenn kein anderes BO darauf referenziert.

2. Allgemeine Eigenschaften

Hier werden alle allgemeinen Eigenschaften für das Businessobjekt festgelegt.

Beschriftung und Fenstertitel	Beschriftung des Fensters (für die BO-Maske) anpassen
Pfad im Menü	Unter welchem Menüpunkt soll das BO aufrufbar sein. Unterordner werden durch einen " \ " getrennt.
Benutzerdefiniertes Icon	Anstelle der vorgegebenen Icons können auch eigene genutzt werden (müssen als Ressource angelegt werden)
Tastenkürzel	Es können Tastenkombinationen zum Öffnen der BO-Maske angegeben werden
Suchmaske erforderlich?	Falls für das BO eine Suchmaske (Suche nach Attributen) benötigt wird
Suchmaske direkt öffnen?	Soll beim Öffnen des BO direkt eine Suchmaske geöffnet werden, ansonsten wird initial die Listenansicht geöffnet.
Ist das BO änderbar?	Sollen Daten des BO änderbar sein oder schreibgeschützt. Im schreibgeschützten Modus sind alle Buttons deaktiviert.
geplittete Anzeige	Es wird innerhalb eines Fensters die Suchmaske und Suchergebnisse angezeigt
Historie	Daten eines BO können historisiert werden.
Statusmodell	Das BO enthält ein Statusmodell. Die Definition eines Statusmodells ist dann Pflicht.
Kürzel für Identifizierer	Kürzel für Datensatzidentifizierer. Dieser setzt sich zusammen aus <Kürzel><MM><YY>-<fortlaufende Nummer>. Beispiel: KU0716-00001. Der Identifizierer kann nur im Zusammenhang mit einem Statusmodell aktiviert werden.
Zeige Relationen im Baum	Relationen werden im Explorerbaum angezeigt. Nur möglich bei BOs mit Statusmodell. Diese Funktion ist veraltet und wurde abgelöst durch die Konfiguration der Baumdarstellung (siehe unten).
Zeige Gruppen im Baum	Gruppen werden im Explorerbaum angezeigt. Nur möglich bei BOs mit Statusmodell. Diese Funktion ist veraltet und wurde abgelöst durch die Mandantenfähigkeit.
Mandantenabhängigkeit
Mandanten Erstbefüllung mit
Kommentar	Kommentar für das BO
Virtuelles BO	Auswahl eines vorher definierten virtuellen Businessobjektes. Die entsprechenden Spalten werden im nächsten Schritt als Attribute aufgelistet.
Id Factory für VE	Auswahl einer vorher definierten Datenbankfunktion für die erzeugung einer ID, falls neue Daten eines virtuellen BOs erzeugt werden sollen.
BO cachen	Empfiehlt sich bei großen Datenmengen, dadurch werden Daten direkt in den Arbeitsspeicher geladen und sind dadurch schneller abrufbar
Proxy BO	Dadurch wird das Businessobjekt als Interface angelegt, z.B. um in einer Regel verwendet zu werden
Proxy Interface
Tabellenname	Der Tabellenname eines Businessobjekts kann verändert/angepasst werden.
Interner BO Name	Der interne Businessobjekt-Name kann ebenso angepasst werden. Er ist die Grundlage für die Methodenbenennungen in der BusinessRule API.
Objektgenerator für Klonen	Objektgenerator der ausgeführt wird, wenn der Klonen-Button betätigt wird.

4. Attribute bearbeiten

Falls man Attribute manuell erfasst kann man einzelne Attribute hinzufügen, entfernen oder bearbeiten.

Eigenschaften

Folgende Felder können ausgefüllt werden:

Anzeigename
Beschreibung (wird dem Anzeigenamen gleichgesetzt)
Datentyp
Mindestwert
Maximalwert
Kommentar

Mindest- und Maximalwerte können für manche Datentypen (Zahlen- und Datumstypen) ausgefüllt werden.

Die restlichen (ausgegrauten) Felder werden durch Auswahl des Datentyps ausgefüllt.

Referenzfeld

Bei dem Datentyp Referenzfeld wird auf ein Businessobjekt verwiesen.
Es kann eingestellt werden ob kaskadierend gelöscht werden soll und ob ein Suchfeld verwendet werden soll,
die Alternative dazu ist eine Dropdownliste, falls das Feld nicht ausgewählt wird.

Für das Referenzfeld können die Werte aus dem referenzierten BO ausgewählt werden mit denen das Feld gefüllt werden soll.

Beispiel: "${kundennummer} - ${name}"

Allgemeine Eigenschaften

Der Feldname wird für die Identifizierung des Attributs innerhalb von Regeln verwendet.
Das Attribut kann ebenfalls mit einem Standardwert belegt oder ein Berechnungsaudruck hinterlegt werden.

Wenn das Attribut als Eindeutig oder Pflichtfeld markiert wird, so findet beim Speichern eines Datensatzes eine Validierung statt.
Sind mehrere Attribute eines BOs als Eindeutig markiert sind diese Felder immer in Kombination eindeutig.

Attribute können ebenfalls einer Attributgruppe zugeordnet werden. Bei einer Berechnungsvorschrift kann eine Datenbankprozedur ausgewählt werden.

Unter den erweiterten Einstellungen kann der verwendete Spaltenname für die Datenbank angepasst werden
und ausgewählt werden ob das Attribut indiziert werden soll (es wird dann ein Datenbank-Index angelegt).

Datentypen

Es gibt verschiedene vordefinierte Datentypen (Tabelle) die standardmäßig zur Verfügung stehen, es können allerdings auch neue definiert werden.

Datentyp	Javatyp	Datenbanktyp	Länge	Bemerkung
Text	java.lang.String	varchar	255
Datum	java.util.Date	date
Dokumentenanhang		blob	255	Näheres unter Spezielle Datentypen
Ganzzahl	java.lang.Integer	number	9
Kommazahl (9,4)	java.lang.Double	number	9
Kommazahl (9,2)	java.lang.Double	number	9
Ja/Nein	java.langBoolean	number	1
Verschlüsselter Text		varchar	255	Näheres unter Spezielle Datentypen
Bild		blob	255	Näheres unter Spezielle Datentypen
Autonummer	java.lang.Integer	number	9
Referenzfeld	java.lang.String	varchar	255	Referenz zu anderen Businessobjekten
Nachschlagefeld	java.lang.String	varchar	255
Email	java.lang.String	varchar	255
PhoneNumber	java.lang.String	varchar	255
Hyperlink	java.lang.String	varchar	1000
Memo	java.lang.String	varchar	4000
Text (Large Object)	java.lang.String	clob
Binär (Large Object)		blob

5. Aktionen definieren

6. Menü konfigurieren

In dieser Maske können ähnlich wie bereits in den Allgemeinen Eigenschaften der Menüpfad ausgewählt werden in dem der Eintrag für das Businessobjekt abgelegt werden soll.
Über die Checkbox "Neu?" kann bestimmt werden ob bei Auswahl sofort die Maske für eine Neuanlage geöffnet wird.

7. Baumdarstellung definieren

Wenn bei den allgemeinen Eigenschaften die beiden Einstellungen "Zeige Relationen im Baum" oder "Zeige Gruppen im Baum" werden diese hier im Explorerbaum angezeigt.
In Anzeige Knotendarstellung und Bezeichnung Knoten-Tooltip können wieder die Daten eines BO ausgewählt werden.

Die Exploreransicht kann ebenfalls konfiguriert werden. Über das Kontextmenü jedes Eintrags hat man die Möglichkeit:

Unterknoten hinzuzufügen
Unterknoten zu entfernen
Unterknoten zu bearbeiten

8. Rechte verwalten

In diesem Menü können Rechte für das BO vergeben werden (Lesen/Schreiben/Löschen). Dafür müssen zuerst Benutzergruppen angelegt werden.
Alternativ können die Rechte für jedes BO aber auch in der Benutzergruppenverwaltung eingerichtet werden.

9. Übersetzen

Für das Businessobjekt und den Menüpfad können Übersetzungen eingefügt werden,
ebenso die Knotendarstellung und der Tooltip können angepasst werden.

10. Darstellung konfigurieren

Für jedes Businessobjekt kann man ein Layout automatisch generieren lassen, bzw. auch ein vorhandenes Layout aktualisieren.

ACHTUNG: Bereits bestehendes Layout wird dabei komplett überschrieben.

Es lassen sich auch gleich Unterformulare ins Layout aufnehmen oder Editierungsfelder (Erstellt von, Erstellt am, Geändert von...) erstellen.

Seitenhierarchie