...

...

...

Menüaufruf: (Konfiguration) - (Regel Management)

Das Regelmanagement dient zur Anzeige und Verwaltung bestehender Regeln und deren Verknüpfung mit Businessobjekten, Statusmodellen, Arbeitsschritten und Fristen.

Gliederung

Die graphische Oberfläche des Regelmanagements unterteilt sich ein zwei Bereiche. Auf der linken Hälfte befindet sich der Baum mit der Regelbibliothek. Dieser zeigt alle Regeln an, die dem Nuclos System aktuell bekannt sind. Auf der rechten Hälfte befindet sich der Baum mit den Regelzuweisungen. Darunter versteht man alle Businessobjekte, Statusmodelle, Arbeitsschritte und Fristen, die mit einer Regel verknüpft werden können oder es bereits sind.

Regelbibliothek

Auf oberster Ebene des Baumes werden alle Nuclets angezeigt, die in der aktuellen Version vorhanden sind. Mit der Angabe eines Package-Pfades wird eine Regel automatisch dem passenden Nuclet zugewiesen und kann im Baum entsprechend gefunden werden. Regeln ohne Angabe eines Packages werden dem Knoten „Default“ zugewiesen.

Auf der darunter liegenden Ebene werden alle Regel-Typen angezeigt, über die Nuclos verfügt. Dazu gehören:

• Aktualisieren
• Aktualisieren (im Anschluss)
• Anlegen
• Anlegen (im Anschluss)
• AuthenticationRule
• Benutzeraktion
• CustomRestRule
• DatasourceRule
• Druckprofil
• Drucken (im Anschluss)
• Job
• Kommunikation
• Löschen
• Löschen (im Anschluss)
• Objektgenerator
• Objektgenerator (im Anschluss)
• Statuswechsel
• Statuswechsel (im Anschluss)

Eigenschaften:

Mit der Auswahl einer Regel oder eines Regel-Typs erscheint unterhalb des Regelbibliothekbaums ein Eigenschaftsfenster mit allen wichtigen Informationen. Dazu gehören Klassenname, Typ, Erstellungsdatum oder auch Package- und Nuclet-Zuweisung.

Eigenschaften eines Regeltyps:

Image Removed

Eigenschaften einer Regel:

Image Removed

Zur Unterstützung aussagekräftiger Bezeichnungen und Beschreibungen, sollte eine Regel die Annotation Rule enthalten:

@Rule(name="Statuswechsel im Anschluss Lagerposition", description="Statuswechsel im Anschluss Lagerposition")

Sprache: Deutsch · English

Server Regelmanager

Was ist der Server-Regelmanager?

Der Regelmanager zeigt und verwaltet bestehende Regeln und ihre Verknüpfung mit Businessobjekten, Statusmodellen, Arbeitsschritten und Fristen. Die Oberfläche hat zwei Bäume: links die Regelbibliothek, rechts die Regelzuweisung.

Menüaufruf: Konfiguration → Server Regelmanager

Image Added

Regelmanager: Regelbibliothek (links) und Zuweisung (rechts).

Regelbibliothek (links)

Oberste Ebene: alle Nuclets (Regeln ohne Package landen unter Default). Darunter die Regeltypen (Anlegen, Aktualisieren, Löschen, Statuswechsel, Objektgenerierung, Job, Benutzeraktion, CustomRestRule … jeweils auch „im Anschluss“). Das Eigenschaftsfenster zeigt Klassenname, Typ, Datum, Package/Nuclet.

Regelzuweisung (rechts)

Analog nach Nuclets gegliedert, darunter Businessobjekte, Statusmodelle, Arbeitsschritte und Fristen. Integrationspunkte werden dunkelblau hervorgehoben. Änderungen (Löschen einer Zuweisung, Ausführungsreihenfolge) werden automatisch übernommen.

Image Added

Regelzuweisung mit Eigenschaftsfenster.

Neue Regel anlegen und zuweisen

1. Klasse anlegen: Nuclet + EventSupport-Typ per Rechtsklick wählen.
2. Name/Beschreibung eingeben – werden in den Quellcode eingebettet.
3. Der Editor öffnet den Quellcode mit dem passenden Interface und den aufgerufenen Methoden:

Regelzuweisung

Auf oberste Ebene des Regelzuweisungsbaums sind, analog zur Regelbibliothek, alle Nuclets aufgelistet. Unterhalb davon befinden sich die Kategorien Businessobjekte, Statusmodelle, Arbeitsschritte und Fristen. Diese stellen innerhalb von Nuclos die Einheiten dar, die mit Regeln verknüpft werden können. Durch das Öffnen der jeweiligen Kategorie erscheinen alle vom User angelegten Elemente dieser Kategorien. Wurden Elemente noch nicht einem Nuclet zugwiesen,  sind unter dem Knoten „Default“ zu finden. Die implementierten Regeln können durch Auswahl des Typs im Eigenschaftsfenster eingesehen werden.

Eigenschaften:

Mit der Auswahl eines Elements erscheint ein Fenster unterhalb des Baums, dass alle relevanten Informationen und Eingabemöglichkeiten zu den zugewiesenen Regel enthält. Die Grundfunktionalitäten sind das Löschen einer Regelzuweisung und das Festlegen der Ausführungsreihenfolge. Änderungen werden automatisch übernommen und müssen nicht separat abgespeichert werden.

Image Removed

Integrationspunkte

Integrationspunkte werden im Regelmanager dunkelblau hervorgehoben.

Image Removed

Bedienung

Zur Erstellung und Zuweisung einer neuen Regel bedarf es folgender Schritte:

 1. Anlegen einer neuen Klasse:

Mit der Auswahl eines Nuclets und eines EventSupport-Typs kann die Zugehörigkeit und der Typ der neuen Klasse festgelegt werden. Wählen Sie dazu das entsprechende Element aus und öffnen mit der rechten Maustaste das Kontext-Menü

2. Beschreibung und Regelname

Im weiteren Schritt wird eine Eingabemaske eingeblendet, in der die Bezeichnung und die Beschreibung der neuen Klasse angegeben werden können. Diese werden dann automatisch in den Quellcode eingebettet.

Bestätigt mit "OK" wird der Editor "Server Regel (API-basiert) geöffnet, der den vollständigen Quellcode der neuen Klasse beinhaltet. Je nach Ausprägung sind darin die Interfaces für die Typisierung zu sehen und die Methoden dieses Typs, die bei der Ausführung der Regel aufgerufen werden. Diese Methoden können dann vom Benutzer um benutzerspezifische Angaben erweitert werden.

...

package org.nuclet.lager;

...

import org.nuclos.api.rule.InsertFinalRule;

...

import org.nuclos.api.context.InsertContext;

...

import org.nuclos.api.annotation.Rule;

...

import org.nuclos.api.exception.BusinessException;

...

...

...

@Rule(name="Anlegen Lagerposition im Anschluss",
      description="Anlegen Lagerposition im Anschluss")
public class AnlegenLagerpositionImAnschluss implements InsertFinalRule {
   

...

 public void insertFinal(InsertContext context) throws BusinessException {

...

    }
}

1. Speichern & schließen – die Bibliothek lädt neu, die Regel erscheint unter ihrer Rubrik.
2. Zuweisen: Regel per Drag-and-Drop auf das Zielelement ziehen (typsicher – ungültige Ziele zeigen ein Verbotsschild). Optional auf Status/Aktion einschränken; ohne Angabe gilt sie für alle.

Image Added

Neue Regel per Drag-and-Drop zuweisen.

Verwandte Seiten

Regeln (serverseitig)

---

Regeln schreiben.

Öffnen →

Ausführungsreihenfolge der Regeln

---

Reihenfolge.

Öffnen →

Statusmodell

---

Regeln am Übergang.

Öffnen →

Die von Nuclos aufgerufenen Methoden (im oberen Beipsiel "insertFinal") enthalten ein typisierten Kontext, der alle für diesen Schritt relevanten Informationen und Objekte enthält. Nähere Informationen finden Sie in den Beispielen zu den einzelnen Ausprägungen.

3. Speichern und Schließen

Nach Fertigstellung der Klasse wird der Baum mit der Regelbibliothek automatisch neu geladen werden. Die Regel erscheint unter der gewählten Rubrik.

Image Removed 

4. Zuweisung

Für die Zuweisung muss die neu erstellte Regel ausgewählt und per Drap& Drop auf das Zielelement im Zuweisungsbaum gezogen werden. Wichtig ist, dass die Zuweisung immer typsicher ist. So kann eine Klasse vom Typ „Anlegen“ nicht mit einem Statusmodell kombiniert werden und eine Job-Regel nicht mit einem Businessobjekt. Ob ein Ziel auch ein gültiges Ziel ist, erkennt man beim Drag&Drop am Mauszeiger, der im ungültigen Fall ein Verbotsschild anzeigt.

Anschließend wird unterhalb des Zielelements der Typ der neu zugewiesenen EventSupport-Klasse angezeigt, nicht die Klasse selbst. Um diese einzusehen, muss der Typ ausgewählt werden und er erscheint unterhalb des Baums das Eigenschafts-Fenster.

Nach Bedarf und abhängig vom Regeltyp können nun noch Einschränkungen auf Status und Aktion durchgeführt werden. Werden keine Angaben gemacht, gilt die Regel für alle Status und alle Aktionen.

Damit sind alle Schritte abgearbeitet und die Regel wird mit dem nächsten Ereignis ausgeführt, mit dem sie verknüpft wurde.

Image RemovedImage Removed

Image Removed