Menüaufruf: (Konfiguration) - (Businessobjekt)
Alle in Nuclos erfassten Daten des Unternehmens werden in Businessobjekte geordnet. Ein Businessobjekt entspricht in der Sprache der Datenmodelle einer Entität. Anders ausgedrückt ist es eine Abstraktion von Dingen, die man im Unternehmen gern verwalten möchte. Der Name des Businessobjektes kennzeichnet diese Abstraktion sprachlich idealerweise so, dass jede/r im Unternehmen weiß, was damit gemeint ist. Typische Beispiele sind z.B. "Kunde", "Artikel" oder "Auftrag".
Businessobjekte können, müssen aber nicht, ein Statusmodell haben. Im Statusmodell werden meist betriebliche Prozesse dieses Businessobjektes abgebbildet, z. B. bestellt → geliefert → bezahlt. Es ist aber auch möglich, im Statusmodell bestimmte dauerhafte Verwaltungszustände darzustellen wie z.B. aktiv - inaktiv.
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.
Die erste Seite des BO-Wizard gibt einen Überblick über die existierenden Businessobjekte.
Im Bereich Spalten kann die Ansicht über das Feld "Name" gefiltert werden. Desweiten können Spalten ein- oder ausgeblendet werden, indem die Checkboxen aktiviert oder deaktiviert werden. Weitere Filtermöglichkeiten über die Werte der einzelnen Spalten ergeben sich über die Auswahl eines Wertes aus der Combobox.
Die eingeblendeten Spalten können außerdem alphabetisch sortiert werden, indem auf den jeweiligen Spaltenheader geklickt wird.
Erstellen
um ein neues BO anzulegen, wird im oberen Textfeld der Name eingegeben und ein ensprechendes Nuclet gewählt werden. Ist der Name in diesem Nuclet bereits vergeben, wird eine Meldung ausgegeben. Somit ist es möglich, gleichnamige Businessobekte anzulegen sofern diese nicht dem gleichen Nuclet zugeordnet sind.
Anhand dieses Namens wird später auch der Tabellenname der Datenbank erzeugt.
Der Interne Name darf aus max. 25 Zeichen bestehen.
Ändern
um ein BO zu ändern, wird dieses in der Liste markiert und auf weiter geklickt. Die weitere Bearbeitung findet in den unten folgenden Schritten statt.
Löschen
markieren Sie das zu löschende BO in der Liste und klicken Sie auf Businessobjekt entfernen. Wird ein BO gelöscht, werden sowohl alle zugehörigen Metadaten aus dem Nuclet entfernt als auch die zugehörige Tabelle in der Datenbank.
Ein BO kann erst gelöscht werden, wenn kein anderes BO mehr darauf referenziert. Darüber wird der Anwender in einem Dialog informiert. |
Alle vorhandenen Daten werden unwiederruflich gelöscht. Ein entfernes BO kann nicht wieder hergestellt werden. |
Hier werden alle allgemeinen Eigenschaften für das Businessobjekt festgelegt.
Suchmaske erforderlich?: Falls für das BO eine Suchmaske (Suche nach Attributen) benötigt wird
<Kürzel><MM><YY>-<fortlaufende Nummer>. Beispiel: KU0716-00001.
Der Identifizierer kann nur im Zusammenhang mit einem Statusmodell aktiviert werden.
Achtung: Die Geschäftslogik sollte auf Konflikte geprüft werden! Es könnte z.B. mandantenübergreifende Import Jobs geben die, wenn über einen Artikelnamen ein Artikel gesucht, erwarten, dass nur ein Datensatz gefunden wird. Auch Datenbank Prozeduren gehören zu den zu überprüfenden Komponenten. |
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:
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. Hinweis: die Spalteneinstellungen für bestimmte Benutzergruppen überschrieben die o.g. Default-Reihenfolge.
Attribute können ebenfalls via Drag&Drop an die gewünscht Stelle gezogen werden.
Um Attribute leichter zu finden, ist auch eine Sortierung der Spalten möglich. Klicken sie dazu auf den jeweiligen Header der zu sortierenden Spalte. Bei aktivierter Sortierung, ist die Einstellung der Reihenfolge nicht möglich. Um die Sortierung wieder zu deaktivieren, klicken sie erneut auf den Header bis kein Sortierpfeil mehr angezeigt wird.
Neues Attribut hinzufügen, markiertes Attribut löschen oder markiertes Attribut bearbeiten (auch Doppelklick möglich).
Dunkelblaue Attribute repräsentieren Referenzen auf Integrationspunkte, angelehnt an den Regelmanager, welcher ebenfalls Integrationspunkte dunkelblau darstellt.
Folgende Felder können ausgefüllt werden:
Die folgenden Eingabefelder variieren je nach der Auswahl des Datentyps.
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 | Textfeld mit 255 Zeichen |
Datum | java.util.Date | date | Datumsfeld (ohne Uhrzeit). Definition eines Ausgabeformates über Pattern möglich. dd.MM.yyyy erzeugt z.B. 15.07.2015 | |
Dokumentenanhang | blob | 255 | Näheres unter Spezielle Datentypen | |
Ganzzahl | java.lang.Integer | number | 9 | Ganzahl mit 9 Stellen |
Kommazahl (9,4) | java.lang.Double | number | 9 | Kommazahl mit 9 Stellen insgesamt, davon 2 Nachkommastellen. Definition eines Ausgabeformates über Pattern möglich. #,##0.00 erzeugt z.B. 1.248,40 |
Ja/Nein | java.langBoolean | number | 1 | Null-Werte nicht möglich. Attribut muss ein Pflichtfeld sein. |
Verschlüsselter Text | varchar | 255 | Näheres unter Spezielle Datentypen | |
Bild | blob | 255 | Näheres unter Spezielle Datentypen | |
Autonummer | java.lang.Integer | number | 9 | Näheres unter Spezielle Datentypen |
Referenzfeld | java.lang.String | varchar | 255 | Referenz zu anderen Businessobjekten (s.u. 4.3 Verknüpfung zu anderen Businessobjekten) |
Nachschlagefeld | java.lang.String | varchar | 255 | Nachschlagefeld zu anderen Businessobjekten. Unterschied zu Referenzfeld: ein Nachschlagefeld bietet eine Auswahlkomponente auf ein Referenz-BO, gespeichert wird aber nur der Text. Verwendungszweck: erleichterte Eingabe für den Anwender bei z.B. Titel, Anrede usw. Anwender soll Auswahlmöglichkeiten erhalten statt eigenen Text einzugeben. |
java.lang.String | varchar | 255 | Näheres unter Datenkomponenten | |
PhoneNumber | java.lang.String | varchar | 255 | Näheres unter Datenkomponenten |
Hyperlink | java.lang.String | varchar | 1000 | Näheres unter Datenkomponenten |
Memo | java.lang.String | varchar | 4000 | |
Text (Large Object) | java.lang.String | clob | 2147483647 | |
Binär (Large Object) | blob |
Der Verweis kann entweder auf ein anderes Businessobjekt oder auf einen Integrationspunkt erfolgen.
Verweis auf Integrationspunkt: Angabe des Integrationspunktes, der referenziert werden soll.
Verweis auf Businessobjekt: 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}
Ein Valuelist Provider kann sowohl für ein Feld innerhalb eines Layouts definiert werden, als auch attributübergreifend. In dieser Maske können sie einen Valuelist Provider auswählen, der dann für alle Auswahllisten dieses Attributes herangezogen wird.
Beispiel: ein Anwender in einer Zweigfiliale "Hamburg" darf generell nur Warengruppen auswählen, die diesen Standort betreffen.
Wird bisher nur von der Stapelverarbeitung im Webclient verwendet. Ganz im Gegensatz zum Javaclient benötigt diese keine Layouts.
Je nachdem mit welcher Sprache sich ein Anwender im Logindialog anmeldet, wird die entsprechende Übersetzung in den Labels angezeigt. Die Beschreibung stellt im Richclient das Tooltip dar, wenn man mit der Maus über das Feld fährt.
Aktuell steht Deutsch und Englisch zur Verfügung.
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 ! |
Berechnung nur auf Anfrage: Ein so markiertes Attribut wird nicht mehr automatisch vom Layout oder von der Regel-API berechnet, das heißt, es ist auch im Layout oder in der API nicht verwendbar. Es wird nur dann berechnet und angezeigt, wenn man es in der Listenansicht einblendet. Diese Option ist für Attribute sinnvoll, deren Berechnung sehr lange dauert.
In diesem Bereich können Aktionen für das BO definiert werden. Mit dem Aktionsmechanismus hat man die Möglichkeit, für ein BO verschiedene Layouts zu gestalten oder verschiedene Prozesse (Statusmodelle) zu durchlaufen.
Anwendungsfall: die Eingabemaske für Kunde der Aktion "Unternehmen" hat Eingabefelder wie Standort, Abteilung oder USt-Identifikationsnummer, die ein Privatkunde nicht hat.
Für weitere Informationen siehe Aktionen
In diesem Bereich werden auch Kontexte für das BO definiert. Der Kontext wird von der Webclient Suche verwendet und beinhaltet die Unterformular Business Objekte, in denen gesucht werden darf.
Dieser Bereich der Menükonfiguration stellt eine Verfeinerung des Menüpfades unter Schritt 2 dar und ist optional.
Man kann Menüpfade aktionsabhängig konfigurieren oder auch die Neuanlage eines Datensatzes in einem anderen Menübereich platzieren.
Ist der Haken "Neu?" aktiviert, so wird sofort die Eingabemaske für einen neuen Datensatz geöffnet, ohne in der Suchliste bzw. Suchmaske zu starten.
${kundenname}(${kundennummer}) - ${nuclosState} -> Kunde AG(1001) - Aktiv
In der Baumdarstellung können alle BOs eingebunden werden, die einen Fremdschlüssel auf das Haupt-Businessobjekt haben. Knoten können über das Kontextmenü hinzugefügt, gelöscht oder bearbeitet werden. Per Drag&Drop kann die Position der Unterknoten verändert werden. Die Unterelemente werden dann in dieser Reihenfolge angezeigt.
In diesem Bereich werden alle existierenden Benutzergruppen aufgelistet. Die entsprechenden Berechtigungen für dieses BO können an dieser Stelle gepflegt werden.
Desweiteren kann dieses BO für die Sperrfunktion aktiviert und entsprechend konfiguriert werden. Details siehe Sperrlogik.
Für das Businessobjekt und den Menüpfad können Übersetzungen gepflegt werden,
ebenso die Knotendarstellung und das Tooltip sowie Aktionen können angepasst werden.
Für jedes Businessobjekt kann man automatisch ein Layout generieren lassen bzw. auch ein vorhandenes Layout aktualisieren.
Das bereits bestehende Layout wird dabei überschrieben ! |
Hintergrundfarbe: Groovy-Skript für die Farbe der Zeilendarstellung. Gilt für Suchergebnislisten und für Unterformulare. Siehe dazu Regeln (clientseitig)
Maske aktualisieren ?: ist dieser Haken aktiviert, so wird das Layout neu erzeugt bzw. das Vorhandene überschrieben
Gruppierung: die einzelnen Attribute jeder Attributgruppe werden in einem Panel zusammengefasst
Unterformulare: jedes BO mit einem Fremdschlüssel auf dieses BO wird im Layout als Unterformular eingefügt.
Editierungsfelder: CreatedAt, CreatedBy, ChangedAt und ChangedBy werden im Layout eingefügt
Reihenfolge: hier wird die Reihenfolge der Attribute im Layout definiert. Die Attribute werden alle untereinander in einem Panel angeordnet.