Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Auszug

...

hidden

...

Allgemein

...

true

Nuclos Event-Regel Objektgenerierung (im Anschluss)

...

Innerhalb des Baums mit der Regelbibliothek werden sie dem Knoten "Arbeitsschritt (im Anschluss)" zugeschrieben.

GenerateFinalRules werden nicht ausgeführt, wenn:

  • "Generiertes Objekt nicht speichern" im Objektgenerator ausgewählt ist
  • ein Validierungsfehler (Pflichtfeldprüfung) oder anderer Fehler während des Speicherns auftriit

Struktur

Quellcode einer Klasse des Typs "Arbeitsschritt (im Anschluss)":

...

: Interface, GenerateContext, Struktur, Zuweisung im Server-Regelmanager, Beispielcode (Java).

globe with meridians Sprache: Deutsch · English

open book Event - Objektgenerierung (im Anschluss)

Ereignis-Regel „Objektgenerierung (im Anschluss)“: Interface, Kontext und ein Beispiel – so reagierst du auf dieses Nuclos-Ereignis.

Status
colourGrey
titleReferenz
Status
colourBlue
titleEntwickler
Status
colourGreen
titleStand: Jul 2026
Status
colourGrey
titlegilt fuer Nuclos 4.2026.x

Panel
bgColor#F4F5F7

Auf dieser Seite

Inhalt
maxLevel2
minLevel2

Wann greift die Regel?

Diese serverseitige Regel wird ausgeführt nach einer erfolgreichen Objektgenerierung. Sie kann einem Objektgenerator zugewiesen werden.

Struktur

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

Codeblock
languagejava
package org.nuclet.lager; 

import org.nuclos.api.rule.GenerateFinalRule; 
import org.nuclos.api.context.GenerateContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 
/
** @name        
  * @description 
  * @usage       
  * @change      
*/

@Rule(name="Objektgenerierung im Anschluss", description="Objektgenerierung im Anschluss")
public class ObjektgenerierungImAnschluss implements GenerateFinalRule {

    public void generateFinal(GenerateContext context) throws BusinessException { 
    }
}
Info
titleKontext: GenerateContext

Der Kontext GenerateContext 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 „Objektgenerierung (im Anschluss)„ und die Weiterverarbeitung der übergebenen Inhalte veranschaulichen.

Codeblock
languagejava
package org.nuclet.company; 

import org.nuclos.api.rule.GenerateRule; 
import org.nuclos.api.context.GenerateContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 
import java.util.Collection;

/** @name        
  * @description 
  * @usage       
  * @change      
*/
@Rule(name="BestellungErstellen", description="BestellungErstellen")

public class BestellungErstellen implements GenerateRule {

    public void generate(GenerateContext context) throws BusinessException { 
        Collection<Anfrage> sourceObjects = context.getSourceObjects(Anfrage.class);
        
        int sumOfArticles = 0;
        
        for (Anfrage a: sourceObjects) {
            // How many articles are in this inquiry
            sumOfArticles += a.getAnfrageposition().size();
        }
        
        Bestellung targetObject = context.getTargetObject(Bestellung.class);
        
		// create new history entry        
	    BestellungHistory newHistory = new BestellungHistory();
        newHistory.setBestellungId(targetObject.getId());
        newHistory.setBemerkung(sumOfArticles + " Einträge");
         
        // save new entry
        BusinessObjectProvider.insert(newHistory);
        
    }
}

Verwandte Seiten

open book Regeln (serverseitig)


Grundlagen.

Öffnen →

gear Server Regelmanager


Zuweisen.

Öffnen →

clipboard Ausführungsreihenfolge der Regeln


Reihenfolge.

Öffnen →

Das entsprechende Interface schreibt die Implementierung der Methode "generateFinal" vor und liefert als Kontext die Klasse GenerateContext. Darin enthalten sind die Einträge der Quellentität, das Zielobjekt und - falls angegeben - das Parameterobjekt. Weiterhin können die Funktionen des übergeordneten RuleContexts genutzt werden.

Innerhalb der generateFinal-Methode kann der Regelprogrammierer auch eine BusinessException auslösen, die zum Abbruch des Events führt. Die Fehlermeldung wird in Nuclos angezeigt.

Die Angabe der Annotation "Rule" ist nicht zwingend notwendig, wird aber empfohlen, da die Beschreibungen (name und description) im Regelbibliotheksbaum angezeigt werden.

Zuweisung

Klassen des Typs "Arbeitsschritt (im Anschluss)" können nur Arbeitsschritten zugewiesen werden. Nach der Verknüpfung erscheint die Klasse nach Auswahl des Arbeitsschrittes und des Typs im Zuweisungsfenster .

Image Removed

Mit dem Symbol des Mülleimers kann die Zuweisung der Klasse zum Arbeitsschritt gelöscht werden. Wichtig ist, dass damit nur die Zuweisung gelöscht wird. Weiterhin lässt sich mit Hilfe der Pfeile-Buttons die Ausführungsreihenfolge verändern.

Jede Änderung wird automatisch gespeichert.

Beispiel

 Hier finden Sie ein Beispiel, das den Aufbau einer Regel vom Typ "Arbeitsschritt (im Anschluss)" veranschaulicht.

Probleme und Lösungen

Support und Informationen zur Problembehandlung finden Sie hier.