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 |
| 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. |
3. Definition von Attributen
Es gibt 3 Arten um Attribute für ein BO zu erfassen: manuell, aus einem anderen BO oder einer Datenbanktabelle übernehmen.
Vorgehensweise wenn man Attribute aus anderer Quelle übernehmen will:
- Auswahl eines BO/Tabelle aus einer Dropdownliste
- Liste aller darin enthaltenen Attribute
- Auswahl welche dieser Attribute man übernehmen will
4. Attribute bearbeiten
Hier werden die Attribute des BOs gepflegt.
Die weiß hinterlegten Spalten, können direkt in dieser Liste verändert werden, ansonsten über "Attribut bearbeiten".
Mit den Pfeilbuttons wird die Reihenfolge der Attribute festgelegt. Diese wird in der Listenansicht als Default herangezogen.
Mit dieser Schaltfläche werden die nuclosinternen Felder eingeblendet, so dass man auch für diese bestimmte Eigenschaften anpassen kann, z.B. Anzeigename, Attributgruppe, Versteckt usw. Interne Bezeichnungen oder Feldbreiten sind hier nicht änderbar !
Neues Attribut hinzufügen, markiertes Attribut löschen oder markiertes Attribut bearbeiten (auch Doppelklick möglich).
Eigenschaften der Attribute
Eigenschaften
Folgende Felder können ausgefüllt werden:
- Anzeigename (wird als Label im Layout und bei sonstigen Beschriftungen angezeigt)
- Beschreibung (wird als Tooltip auf dem Feld angezeigt)
- Datentyp (Datentyp für das Feld. Erläuterungen s.u.). Die restlichen (ausgegrauten) Felder werden durch Auswahl des Datentyps ausgefüllt.
- Mindestwert (nur bei Zahlen- und Datumstypen. Validierung bei der Dateneingabe)
- Maximalwert (nur bei Zahlen- und Datumstypen. Validierung bei der Dateneingabe)
- Mehrsprachigkeit (Aktivierung der Mehrsprachigkeitsfunktion für dieses Attribut. Im Datensatz erscheint dann ein Icon für die Eingabe der Übersetzungen.
- Kommentar (interner Kommentar)
Verknüpfung zu anderen BOs (Referenzfeld) / Nachschlagefeld
- Verweis (Angabe des BOs, das referenziert werden soll)
- Kaskadiert löschen (wird der Datensatz gelöscht, so wird auch der Datensatz der Referenz gelöscht)
- Suchfeld (im Layout wird per Default eine LOV Komponente eingebunden. Kann aber nachträglich geändert werden. Für den Webclient ist diese Einstellung nicht relevant).
Für die Anzeige der Daten im Referenzfeld können Attribute des referenzierten BOs ausgewählt und mittels statischen Zeichen verkettet werden.
Beispiel: ${kundennummer} - ${name} 
Allgemeine Eigenschaften
- Feldnamne (Identifizierung des Attributs innerhalb von Regeln und im Layouteditor. Der Feldname kann nachträglich gändert werden.)
- Standardwert (wird in einem neuen Datensatz per Default eingetragen)
Eindeutig (Wert ist über alle Datensätze eindeutig. Sind mehrere Attribute eines BOs als Eindeutig markiert sind diese Felder immer in Kombination eindeutig. Soll die Eindeutigkeit nachträglich hinzugefügt werden, ist das aktuell nur möglich solange keine Daten existieren, ansonsten ist der Haken ausgegraut).
Wenn es nicht möglich ist die Daten zu löschen, kann auch folgendermaßen vorgegangen werden. Voraussetzung: Die Eindeutigkeit der vorhandenen Daten ist sichergestellt !
Nuclet in Verzeichnisstruktur exportieren
Entsprechende .eoml Datei im Tag <unique> verändern
Nuclet importieren.- Historie (dieses Attribut wird historisiert)
- Pflichtfeld (Validierung bei der Dateneingabe. Soll das Pflichtfeld nachträglich hinzugefügt werden, so muss ein Wert angegeben werden. Dieser wird bei allen bestehenden Daten eingetragen.
- Hintergrundfarbe (Groovy-Skriptcode für Hintergrundfarbe des Feldes)
- Attributgruppe (Zuweisung einer Attributgruppe. Wird für statusabhängige Berechtigungen verwendet)
- Berechnungsvorschrift TODO
- Bererechnungsausdruck (Groovy-Skriptcode für Dateninhalt)
- DB-Spaltenname (kann nachträglich geändert werden)
- Indiziert (falls erwünscht, kann ein datenbankseitiger Index generiert werden)
- Versteckt (wenn aktiv, ist dieses Attribut für den Anwender nicht in der Spaltenauswahl sichtbar. Wird verwendet, wenn es sich um interne Attribute handelt, die für den Anwender nicht relevant sind)
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.
Überblick
Inhalte