Seitenhistorie
| Auszug | |
|---|---|
|
...
...
| maxLevel | 2 |
|---|
Allgemein
Regeln des Typs "Anlegen (im Anschluss)" können nur Businessobjekten zugewiesen werden und müssen das Interface "InsertFinalRule" implementieren. Im Gegensatz zum Typ "Anlegen" werden Regeln dieser Art nach dem Anlegen eines neuen Datensatzes ausgeführt.
Innerhalb des Baums mit der Regelbibliothek werden sie dem Knoten "Anlegen (im Anschluss)" zugeschrieben.
Struktur
Quellcode einer Klasse des Typs "Anlegen (im Anschluss)":
...
| |
Nuclos Event-Regel Anlegen (im Anschluss): Interface, InsertContext, Struktur, Zuweisung im Server-Regelmanager, Beispielcode (Java). |
Sprache: Deutsch · English
Event - Anlegen (im Anschluss)
Ereignis-Regel „Anlegen (im Anschluss)“: Interface, Kontext und ein Beispiel – so reagierst du auf dieses Nuclos-Ereignis.
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Auf dieser Seite
|
Wann greift die Regel?
Diese serverseitige Regel wird ausgeführt nach dem erfolgreichen Anlegen eines Datensatzes. Sie kann einem Businessobjekt zugewiesen werden.
Struktur
Grundgerüst der Regelklasse (der Regeleditor legt es automatisch an):
| Codeblock | ||
|---|---|---|
| ||
package org.nuclet.lager;
import org.nuclos.api.annotation.Rule;
import org.nuclos.api.context.InsertContext;
import org.nuclos.api.exception.BusinessException;
import org.nuclos.api.rule.InsertFinalRule;
/** @name
* @description
* @usage
* @change
*/
@Rule(name="Anlegen Lagerposition im Anschluss", description="Anlegen Lagerposition im Anschluss")
public class AnlegenLagerpositionImAnschluss implements InsertFinalRule {
public void insertFinal(InsertContext context) throws BusinessException {
}
} |
| Info | ||
|---|---|---|
| ||
Der Kontext |
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 „Anlegen im Anschluss„ und die Weiterverarbeitung der übergebenen Inhalte veranschaulichen.
| Codeblock | ||
|---|---|---|
| ||
package org.nuclet.projekt;
import org.nuclos.api.annotation.Rule;
import org.nuclos.api.context.InsertContext;
import org.nuclos.api.exception.BusinessException;
import org.nuclos.api.rule.InsertFinalRule;
/**
* @name AnsprechpartnerErstellen
* @description Unterstützende Regel zum Erstellen neuer Ansprechpartner aus Unterprojekten
* @usage
* @change
*
*/
@Rule(name="AnsprechpartnerErstellen", description="Unterstützende Regel zum Erstellen neuer Ansprechpartner aus Unterprojekten")
public class AnsprechpartnerErstellen implements InsertFinalRule {
public void insertFinal(InsertContext context) throws BusinessException {
final Ansprechpartner boAnsprechpartner = context.getBusinessObject(Ansprechpartner.class);
if (boAnsprechpartner.getUnterprojektsrefId() != null) {
final Unterprojekt boUnterprojekt = Unterprojekt.get(boAnsprechpartner.getUnterprojektsrefId());
boUnterprojekt.setAnsprechpartnerrefId(boAnsprechpartner.getId());
boUnterprojekt.save();
}
}
} |
Verwandte Seiten
Das entsprechende Interface schreibt die Implementierung der Methode "insertFinal" vor und liefert als Kontext die Klasse InsertContext. Darin enthalten ist das BusinessObject. Weiterhin können die Funktionen des übergeordneten RuleContexts genutzt werden.
Soll ein Datensatz des zugewiesenen Businessobjekts neu angelegt werden, erstellt Nuclos nach dem Anlegen des neuen Datensatzes eine Instanz dieser Regel und ruft die Methode insertFinal auf. Der Kontext beinhaltet den nun angelegten Datensatz. Innerhalb der insertFinal-Methode kann der Regelprogrammierer auch eine BusinessException auslösen, die zum Abbruch des Events und 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 "Anlegen (im Anschluss)" können nur Businessobjekten zugewiesen werden. Nach der Verknüpfung erscheint die Klasse nach Auswahl des Businessobjekts 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 zum Businessobjekt gelöscht werden. Wichtig ist, dass damit nur die Zuweisung gelöscht wird. Weiterhin lässt 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 "Anlegen" veranschaulicht.
Probleme und Lösungen
Support und Informationen zur Problembehandlung finden Sie hier.Überblick
Inhalte