| Auszug |
|---|
|
Nuclos serverseitige Regeln: Event-Regeln (Insert, Update, Delete, Statuswechsel, Job), Regeleditor, Provider, Regelkontext, BigDecimal, Endlosschleifen vermeiden. |
Sprache: Deutsch · English
Regeln (serverseitig)
Java-Geschäftsregeln auf dem Server: an Ereignisse geknüpft, mit Zugriff auf Businessobjekte, Provider und die volle Nuclos-API.
| Status |
|---|
| colour | Blue |
|---|
| title | Entwickler |
|---|
|
| Status |
|---|
| colour | Green |
|---|
| title | Stand: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | gilt fuer Nuclos 4.2026.x |
|---|
|
Was sind serverseitige Regeln?
Die Nuclos-API ermöglicht Java-basierte Geschäftsregeln, die bei bestimmten Ereignissen lesend und schreibend auf Inhalte zugreifen. Reichen die übrigen Low-Code-Mittel nicht aus, setzt du hier komplexe Validierungen, Berechnungen, Webservice-Aufrufe oder automatische Datenänderungen um.
Menüaufruf: Konfiguration → Regelwerke → Regeln (serverseitig)
Ereignisse
| Ereignis | Regel-Interface(s) | Beispiel |
|---|
| Neuanlage | InsertRule, InsertFinalRule | neuer Datensatz (z. B. Rechnung) |
| Änderung | UpdateRule, UpdateFinalRule | bestehender Datensatz (z. B. Auftrag) |
| Löschen | DeleteRule, DeleteFinalRule | bestehender Datensatz |
| Statuswechsel | StateChangeRule, StateChangeFinalRule | z. B. Offen → Mahnung |
| Objektgenerator | GenerateRule, GenerateFinalRule | z. B. Lieferschein aus Auftrag |
| Schaltfläche | CustomRule | Benutzeraktion im Layout |
| Job | JobRule | zeitgesteuert, wiederkehrend |
Regeleditor
Der Regeleditor ist das zentrale Werkzeug zum Bearbeiten von Regeln. Für komfortable Entwicklung/Debugging gibt es zusätzlich die IntelliJ-Anbindung.
| Hinweis |
|---|
| title | Automatische Kompilierung |
|---|
|
Über den Schalter Automatische Kompilierung lässt sich das Kompilieren beim Speichern vorübergehend abschalten (nützlich bei voneinander abhängigen, noch nicht kompilierbaren Regeln). Achtung: Nicht kompilierte Regeln sind im Regelmanager nicht sichtbar. |
Schalter „Automatische Kompilierung“ im Regeleditor.
Anwendungsspezifische Objekte
Nuclos generiert automatisch repräsentierende Objekte für Businessobjekte, Statusmodelle, Datenquellen und Reports (mit Gettern/Settern). Ändern sich diese Metadaten, lassen sich abhängige Regeln nicht mehr kompilieren – ein direkter Hinweis auf anzupassende Stellen.
| Tipp |
|---|
|
Kommazahl-Attribute werden als java.math.BigDecimal abgebildet. Nutze BigDecimal.valueOf(double) statt new BigDecimal(double) und bei Division stets .divide(BigDecimal, RoundingMode). |
Provider (unterstützende Klassen)
Provider bieten Funktionen, um Inhalte aus Regeln heraus zu verändern: QueryProvider, StatemodelProvider, GenerationProvider, DatasourceProvider, BusinessObjectProvider, MailProvider, PrintoutProvider, ReportProvider, FileProvider.
Regeln, Unterformulare und der Regelkontext
- In Regeln vor dem Ereignis (Insert/Update/StateChange/Generate) werden Änderungen am Kontextobjekt über Attribut-Setter automatisch übernommen;
delete() auf abhängige Objekte gilt als Änderung. - In Final-Regeln (im Anschluss) ist zum Ändern anderer Objekte ein explizites
save() nötig – das löst deren Update-/UpdateFinal-Regeln aus.
Verwandte Seiten
Server Regelmanager
Regeln zuweisen.
Öffnen →
Ausführungsreihenfolge der Regeln
Reihenfolge je Aktion.
Öffnen →
