Allgemein

Regeln des Typs "Aktualisieren (im Anschluss)" können nur Entitäten zugewiesen werden und müssen das Interface "UpdateFinalRule" implementieren. Im Gegensatz zum Typ "Aktualisieren" werden Regeln dieser Art nach dem Aktualisieren eines neuen Datensatzes ausgeführt.

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

Struktur

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

package org.nuclet.lager; 

import org.nuclos.api.rule.UpdateFinalRule; 
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 Lagerposition im Anschluss", description="Aktualisieren Lagerposition im Anschluss")
public class AktualisierenLagerPositionImAnschluss implements UpdateFinalRule {
   
 public void updateFinal(UpdateContext context) throws BusinessException { 
    }
}

Das entsprechende Interface schreibt die Implementierung der Methode "updateFinal" vor und liefert als Kontext die Klasse UpdateContext. Darin enthalten ist das BusinessObject. Weiterhin können die Funktionen des übergeordneten RuleContexts genutzt werden.

Wurde ein Datensatz der zugewiesenen Entität aktualisiert, erstellt Nuclos im Anschluss eine Instanz dieser Regel und ruft die Methode update auf. Der Kontext beinhaltet den im Vorfeld aktualisierten Datensatz. Innerhalb der updateFinal-Methode kann der Regelprogrammierer auch eine BusinessException werfen, die zum Abbruch des Events, aber nicht zum Abbruch des Speichervorgangs selbst 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 "Aktualisieren (im Anschluss)" können nur Entitäten zugewiesen werden. Nach der Verknüpfung erscheint die Klasse nach Auswahl der Entität und des Typs im Zuweisungsfenster und bietet folgende weitere Einstellungsmöglichkeiten:

• Ausführen bei einem bestimmten Status
• Ausführen bei einer bestimmten Aktion

Mit dem Symbol des Mülleimers kann die Zuweisung der Klasse zur Entität 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 "Aktualisieren (im Anschluss)" veranschaulicht.

Troubleshooting