Seitenhistorie
...
| Auszug |
|---|
...
|
...
Definition
Menüaufruf: (Konfiguration) - (Regelwerke) - (Regeln (serverseitig))
Die Nuclos API ermöglicht die Erstellung von (java-basierenden) Geschäftsregeln, die lesend und schreibend bei bestimmten Ereignissen auf Inhalte in Nuclos zugreifen können. Dazu bietet die Nuclos API verschiedene Klassen und Objekte an, um mit Nuclos zu interagieren.
| Info |
|---|
Die vollständige Dokumentation der Nuclos API findet sich unter http://api.nuclos.de/ |
Ereignisse
Ereignisse (Ereignisse Event Regeln), an die Geschäftsregeln geknüpft werden können, sind:
| |
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 | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Auf dieser Seite
|
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.
| Info | ||
|---|---|---|
| ||
Die vollständige API ist unter api.nuclos.de dokumentiert. |
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
...
| Info |
|---|
Um voneinander abhängige Regeln, die nicht kompilierbar sind, korrigieren zu können, steht der Schalter "Automatische Kompilierung" (in der Toolbar des Regeleditors) zur Verfügung. Darüber lässt sich die automatische Kompilierung beim Speichern vorübergehend deaktivieren. Sobald man sie dort wieder aktiviert, wird beim nächsten Speichern wieder alles durchkompiliert. Achtung: Solange Regeln nicht kompiliert sind, sind sie im Regelmanager (siehe folgender Abschnitt) auch nicht sichtbar. |
zum Bearbeiten von Regeln. Für komfortable Entwicklung/Debugging gibt es zusätzlich die IntelliJ-Anbindung.
| Hinweis | ||
|---|---|---|
| ||
Ü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.
Regelmanager
Der Server Regelmanager (Menüaufruf: (Konfiguration) - (Server Regelmanager)) ist das zentrale Werkzeug in Nuclos, um die Zuordnung zwischen Geschäftsregeln und Ereignissen zu verwalten. Die Zuweisung von Geschäftsregeln aus der Regelbibliothek (linker Baum) zu den Ereignissen (rechter Baum) geschieht mittels Drag&Drop.
Anwendungsspezifische Objekte
Nuclos kümmert sich automatisch um die Generierung aller nötigen anwendungsspezifischen Objekte. Dazu zählen
- Businessobjekte (https://api.nuclos.de/org/nuclos/api/businessobject/). Businessobjekte repräsentieren die konfigurierten Businessobjekt jedes Nuclets. Für jedes Businessobjekt wird ein repräsentierendes Businessobjekt erzeugt, das entsprechende getter- und setter-Methoden für sämtliche Attribute des Businessobjekts bereitstellt.
- Statusmodelle (https://api.nuclos.de/org/nuclos/api/statemodel/). Statusmodelle repräsentieren die konfigurierten Prozesse jedes Nuclets. Für jeden Prozess (Statusmodell) wird ein repräsentierendes Objekt erzeugt, dass den Geschäftsregeln einen erleichterten Zugriff auf die Statusnamen und -numerale bietet.
- Datenquellen (https://api.nuclos.de/org/nuclos/api/datasource/). Datenquellen repräsentieren die konfigurierten Datenquellen jedes Nuclets. Für jede Datenquelle wird ein repräsentierendes Objekt erzeugt, dass den Geschäftsregeln einen erleichterten Zugriff auf die Datenquelleninhalte bietet.
- Reports (https://api.nuclos.de/org/nuclos/api/report/)
- usw..
Werden Businessobjekte, Statusmodelle, Datenquellen, Reports und Formulare geändert, sind die Regeln, die diese anwendungsspezifischen Objekte verwenden, nicht mehr kompilierbar. Das hilft bei der unmittelbaren Erkennung der in Geschäftsregeln ggf. anzupassenden Stellen, die vorübergehend nicht mehr zu den geänderten anwendungsspezifischen Objekten passen.
...
| Tipp | ||
|---|---|---|
| ||
Kommazahl-Attribute werden als |
|
...
Zwei zeitsparende Hinweise zu BigDecimal:
...
Nutze |
...
statt |
...
|
...
|
...
. |
...
Unterstützende Klassen (Provider)
Provider (https://api.nuclos.de/org/nuclos/api/provider/) bieten unterstützende Funktionen, um Inhalte in Nuclos über Geschäftsregeln zu verändern. Aktuell sind folgende Provider implementiert.
- QueryProvider
- StatemodelProvider
- GenerationProvider
- DatasourceProvider
- BusinessObjectProvider
- MailProvider
- PrintoutProvider
- ReportProvider
- FileProvider
Regelausführung und Unterformulare
Die Regelausführung bei Änderung von BOs in Unterformularen bedarf derzeit noch der Systematisierung in Nuclos.
Derzeitigs Verhalten ist wie folgt:
- Bei Neuanlage (InsertRule, InsertFinalRule) nur bei Objekten mit Statusmodell
- Bei Änderung (UpdateRule, UpdateFinalRule) keine Regelausführung
- Beim Löschen (DeleteRule, DeleteFinalRule) nur bei Objekten mit Statusmodell
Ändern, Hinzufügen und Löschen von Businessobjekten im Regelkontext
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.
...
| Warnung | ||
|---|---|---|
|
Ein |
Verwandte Seiten
Überblick
Inhalte