Nuclos Event-Regel Benutzeraktion: Interface, CustomContext, Struktur, Zuweisung im Server-Regelmanager, Beispielcode (Java).

globe with meridians Sprache: Deutsch · English

open book Event - Benutzeraktion

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

Auf dieser Seite

Wann greift die Regel?

Diese serverseitige Regel wird ausgeführt beim Klick auf eine Schaltfläche im Layout. 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.CustomRule; 
import org.nuclos.api.context.CustomContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 

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

@Rule(name="Benutzeraktion Lager", description="Benutzeraktion Lager")
public class BenutzeraktionLager implements CustomRule {
   
    public void custom(CustomContext context) throws BusinessException { 
    }
}

Der Kontext CustomContext 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.

Beispiel

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

package org.nuclet.company; 

import org.nuclos.api.rule.CustomRule; 
import org.nuclos.api.context.CustomContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 
import org.nuclos.api.provider.BusinessObjectProvider;
/** @name        
  * @description 
  * @usage       
  * @change      
*/
@Rule(name="Bestellungpuefen", description="Bestellungpuefen")
public class Bestellungpuefen implements CustomRule {
    public void custom(CustomContext context) throws BusinessException { 
    
        Bestellung b = context.getBusinessObject(Bestellung.class);
        
        if (b.getBestellungsposition().size() <= 0) {
            b.setKurzbeschreibung("Nicht vollständig");
        }
        else {
            b.setKurzbeschreibung("Vollständig!");
        }
    }
}

Verwandte Seiten

open book Regeln (serverseitig)


Grundlagen.

Öffnen →

gear Server Regelmanager


Zuweisen.

Öffnen →

clipboard Ausführungsreihenfolge der Regeln


Reihenfolge.

Öffnen →