...

Das Regelmanagement dient zur Anzeige und Verwaltung bestehender EventSupport-Klassen Regeln und deren Verknüpfung mit Entitäten, Statusmodellen, Arbeitssschritte oder 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 EventSupport-Klassen Regeln an, die dem Nuclos System aktuell bekannt sind. Auf der rechten Hälfte befinden befindet sich der Baum mit den Regelzuweisungen. Darunter versteht man alle Entitäten, Statusmodelle, Arbeitsschritte und Fristen, die mit einer EventSupport-Klasse 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 EventSupport-Klasse Regel automatisch dem passenden Nuclet zugewiesen und kann im Baum entsprechend gefunden werden. EventSupport-Klassen Regeln ohne Angabe eines Packages werden dem Knoten „Default“ zugewiesen.

Auf der darunter liegenden Ebene werden alle EventSupportRegel-Typen angezeigt, über die Nuclos verfügt. Implementierung eine EventSupport-Klasse z.B. das Interface "InsertSupport", so wird die Klasse typisiert und unter dem Knoten "Anlegen" angezeigt.Dazu gehören:

• Benutzeraktion
• Löschen (im Anschluss)
• Löschen
• Arbeitsschritt (im Anschluss)
• Arbeitsschritt
• Event - AnlegenEvent - Anlegen (im Anschluss)Anlegen (im Anschluss)
• Anlegen
• Statuswechsel (im Anschluss)
• Statuswechsel
• Aktualisieren (im Anschluss)
• Aktualisieren
• Job

 Image Removed

Eigenschaften:

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

Image RemovedEigenschaften eines Regeltyps:

Image Added

Eigenschaften einer Regel:

Image Added

Zur Unterstützung aussagekräftiger Bezeichnungen und Beschreibungen, muss sollte eine Eventsupport-Klasse Regel die Annotation NuclosEvent Rule enthalten:

...

@Rule(name="

...

Statuswechsel im Anschluss Lagerposition", description="

...

Statuswechsel im Anschluss Lagerposition")

Regelzuweisung

Auf oberste Ebene des Regelzuweisungsbaums sind, analog zur Regelbibliothek, alle Nuclets aufgelistet. Unterhalb davon befinden sich die Kategorien Entitäten, 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 EventSupport-Klassen Regeln können durch Auswahl des Typs im Eigenschaftsfenster eingesehen werden.

...

Mit der Auswahl eines Elements erscheint ein Fenster unterhalb des Baums, dass alle relevanten Informationen und Eingabemöglichkeiten zu den zugewiesenen EventSupport-Klassen 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

 Image Added

Bedienung

Zur Erstellung und Zuweisung einer neuen EventSupport-Klasse 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ü

Image Modified

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; 

/** @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 { 
    
    }
}

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 muss der Baum mit der Regelbibliothek neu geladen werden. Wählen Sie dazu :

Image Modified

4. Zuweisung

Für die Zuweisung muss die neu

...

erstellteRegel 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 einer Entität. 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.

Image Modified

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