globe with meridians Sprache: Deutsch · English

open book Event - Aktualisieren

Ereignis-Regel „Aktualisieren“: Interface, Kontext und ein Beispiel – so reagierst du auf dieses Nuclos-Ereignis.

REFERENZ ENTWICKLER STAND: JUL 2026 GILT FUER NUCLOS 4.2026.X

Auf dieser Seite

Wann greift die Regel?

Diese serverseitige Regel wird ausgeführt beim Aktualisieren eines Datensatzes (vor dem Speichern). Sie kann einem Businessobjekt zugewiesen werden.

Struktur

Grundgerüst der Regelklasse (der Regeleditor legt es automatisch an):

package org.nuclet.lager; 

import org.nuclos.api.rule.UpdateRule; 
import org.nuclos.api.context.UpdateContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 

/** @name        
  * @description 
  * @usage       
  * @change      
*/

@Rule(name="Aktualisieren einer Lagerposition", description="Aktualisieren eines Lagerposition")
public class AktualisierenLagerposition implements UpdateRule {
    public void update(UpdateContext context) throws BusinessException { 
    
    }
}

Kontext: UpdateContext

Der Kontext UpdateContext liefert das betroffene BusinessObject über context.getBusinessObject(...); zusätzlich stehen die Funktionen des RuleContext (Provider) bereit. Eine BusinessException bricht den Vorgang ab.

Zuweisung

Im Server-Regelmanager per Drag-and-Drop dem Ziel zuweisen. Optional lässt sich die Ausführung auf einen Status oder eine Aktion einschränken; die Reihenfolge steuerst du über die Pfeil-Buttons.

Zuweisung „Aktualisieren“.

Beispiel

Das folgende Beispiel soll den Aufbau einer Regel vom Typ „Aktualisieren„ und die Weiterverarbeitung der übergebenen Inhalte veranschaulichen.

package org.nuclet.company; 

import java.util.List;
import org.nuclos.api.rule.UpdateRule; 
import org.nuclos.api.context.UpdateContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 

/** @name        
  * @description 
  * @usage       
  * @change      
*/
@Rule(name="UpdateBestellung", description="UpdateBestellung")
public class UpdateBestellung implements UpdateRule {
    public void update(UpdateContext context) throws BusinessException { 
        Bestellung curBestellung = context.getBusinessObject(Bestellung.class);
        List<Bestellposition> lstPositionen = curBestellung.getPositionen();
        
        double gesamteArtikelAnzahl = 0d;
        
        for (Bestellposition curPos : lstPositionen) {
            gesamteArtikelAnzahl += curPos.getAnzahlArtikel();
        }
        
        curBestellung.setKurzbeschreibung("Bestellung " + curBestellung.getNummer() + " umfasst insgesamt " + gesamtArtikelAnzahl + "Artikel.");
    }
}

Verwandte Seiten

open book Regeln (serverseitig)


Grundlagen.

Öffnen →

gear Server Regelmanager


Zuweisen.

Öffnen →

clipboard Ausführungsreihenfolge der Regeln


Reihenfolge.

Öffnen →

  • Keine Stichwörter