| Auszug |
|---|
|
Nuclos Ausführungsreihenfolge der Regeln: Insert/Update/Delete/StateChange, Final Rules, Unterformulare, Objektgenerierung, Benutzeraktion, updateAfterExecution. |
Sprache: Deutsch · English
Ausführungsreihenfolge der Regeln
Welche Regel läuft wann? Die Reihenfolge der API-Regeln je Aktion – Anlegen, Bearbeiten, Löschen, Klonen, Job, Druck.
| Status |
|---|
| colour | Blue |
|---|
| title | Entwickler |
|---|
|
| Status |
|---|
| colour | Green |
|---|
| title | Stand: Jul 2026 |
|---|
|
| Status |
|---|
| colour | Grey |
|---|
| title | gilt fuer Nuclos 4.2026.x |
|---|
|
...
|
|---|
|
Überblick über die Reihenfolge, in der |
...
die einem BO zugeordneten API-Regeln |
...
je nach Aktion ausgeführt werden. |
...
Anlegen
- StateChangeRule
...
- zum initialen Status (nur
...
- mit Statusmodell)
...
- InsertRule (übergeordnetes BO) → Pflichtfeldprüfung
...
- InsertRule der Unterformular-BOs (nur
...
- bei eigenem Statusmodell) → Pflichtfeldprüfung
- StateChangeFinalRule (initialer Status)
- InsertFinalRule der Unterformular-BOs, dann des übergeordneten BOs
Bearbeiten
UpdateRule (Haupt-BO) → Pflichtfeldprüfung Haupt-/UF-BO → UpdateFinalRule (Haupt-BO).
Löschen
Datensätze in Unterformularen werden mitgelöscht (
Bearbeiten
- Update Rule für übergeordnetes BO
- Prüfung der Pflichtfelder (Nuclos) übergeordnetes BO
- Prüfung der Pflichtfelder Unterformular-BOs (Nuclos)
- Update Final ("im Anschluss") für übergeordnetes BO
Löschen
...
ab Nuclos 4.38 nur
...
bei delete cascade am Referenzattribut); DeleteRules laufen für UF-BOs nur mit eigenem Statusmodell.
Weitere Aktionen
| Aktion | Reihenfolge |
|---|
| Klonen | Generate → GenerateFinal → Maske → speichern → Insert → InsertFinal |
| Benutzeraktion | CustomRule → (UpdateRule → UpdateFinalRule) |
| Objektgenerierung | GenerateRule → InsertRule → InsertFinalRule → GenerateFinalRule |
| Drucken | PrintRule → PrintFinalRule |
| Job | JobRule |
| REST-Service | CustomRestRule |
| Hinweis |
|---|
| title | Benutzeraktion & save() |
|---|
|
Bei Benutzeraktionen steuert context.setUpdateAfterExecution(...), ob im Anschluss gespeichert wird. Sollen aus der CustomRule Statuswechsel oder save()-Aufrufe erfolgen, muss der Wert false sein. |
Verwandte Seiten
Regeln (serverseitig)
Regelarten.
Öffnen →
Server Regelmanager
Reihenfolge setzen.
Öffnen →
- offen: Was wenn UF mit Statusmodell existieren und gelöscht UND bearbeitet wird?
Statuswechsel
Haupt-BO
UF-BO
Beim Klonen
Generate -> Generate Final -> Maske öffnet sich -> speichern -> Insert -> Insert Final
Achtung: Beim Verwenden eines Objektgenerators für das Klonen greift die Ausführungsreihenfolge von Objektgeneratoren
Benutzeraktion
| Kein Format |
|---|
CustomRule -> (UpdateRule -> UpdatFinalRule) |
- Im Kontext von Benutzerregeln existiert die Methode
context.setUpdateAfterExecution()- Ist updateAfterExecution true, wird im Anschluss an die Benutzerregel gespeichert
- Sollen aus der Benutzerregel Statuswechsel oder Regeln, die das Businessobjekt ändern (mit der save()-Methode) ausgeführt werden, muss updateAfterExecution auf false gesetzt werden
- Was passiert wenn vor der Ausführung der CustomRule gespeichert werden muss?
- Lösung: Aufruf von save() und anschließend ggf. neu laden des Datensatzes mit refresh()
Objektgenerierung
| Kein Format |
|---|
GenerateRule -> InsertRule -> InsertFinalRule -> GenerateFinalRule |
- GenerateFinalRules werden nur einmalig beim Speichern vor Anzeige des erzeugten Objekts ausgeführt. Wird in der anschließend angezeigten Maske gespeichert werden nur noch InsertFinalRules ausgeführt.
- Was passiert wenn "Quellobjekt aktualisieren" aktiv ist?
- Werden Regel für UF-BOs ausgeführt?
Drucken
| Kein Format |
|---|
PrintRule -> PrintFinalRule |
Jobausführung
Über REST-Service
| Kein Format |
|---|
CustomRestRule
