Überblick
Kurzbeschreibung
Das Nummernkreisee-Nuclet bietet unterstütztende Funktionalität zur automatischen Nummerngenerierung.
Nuclet-Bestandteile
Das Nummernkreise-Nuclet umfasst im Rahmen der .nuclet-Datei
die Entitäte „Nummernkreise“
das Layout für diese Entität,
drei Java-Regeln.
Typ | Name, englisch | Name, deutsch | Kurzbeschreibung |
---|---|---|---|
Entität | Nummernkreise | Nummernkreise |
|
Layout | Nummernkreise |
|
|
Java-Package | org.nuclet.nummernkreise.logic | Logik für die Nummerngenerierung | |
| org.nuclet.nummernkreise.rule | Steuerung von Insert-/Update-/Delete-Events bzw. Statuswechsel |
Tabelle 1: Nuclet-Bestandteile
Java-Package-Struktur
Die Java-Regeln sind in fünf Packages unterteilt:
Regeln für maskengesteuerte Events (org.nuclet.basistemplate.rule)
Regeln für die Geschäftslogik (org.nuclet.basistemplate.logic)
Regeln für entitätsbezogene Datenbankzugriffe (org.nuclet.basistemplate.facade)
Regeln für enitätsübergreifende Verallgemeinerungen und als Schnittstelle für die Java-Klassen des Lager-Nuclets (org.nuclet.basistemplate.wrapper)
Objektklassen für Preisinformationen (org.nuclet.basistemplate.object)
Integration
Notwendige Schritte zur Integration
Die Integration des Nummernkreise-Nuclets erfolgt in 5 Schritten:
Download
Nuclet-Import
Nummernkreise festlegen
Sourcecode-Anpassungen in Java-Regeln
Einhängen der Java-Regeln im Regel-Management
Alle Integrationschritte werden im folgenden im Detail erläutert.
Schritt 1: Download
Download der ZIP-Datei „Nummernkreise-v1.0.0.zip“ auf der Nuclos-Webpage unter „Nuclos Services“ > „Download“ > „Nuclet Download“. Das ZIP anschließend lokal entpacken.
Schritt 2: Nuclet-Import
Import des Basistemplate-Nuclets unter „Konfiguration“ > „Nuclet Management“ > „Importieren“ in Ihre bestehende Nuclos-Instanz, Auswahl der Datei „Nummernkreise-v1.0.0.nuclet“
Schritt 3: Nummernkreise festlegen
Für die automatisierte Nummernvergabe ist unter „Stammdaten“ für alle Entitäten, für die Nummern generiert werden sollen, jeweils ein Nummernkreis festzulegen. Die Nummernkreise umfasen die Definition eines Präfix und einer Anzahl von numerischen Stellen.
Beispielsweise führte die Definition
Name des Businessobjektes: Bestellung
Präfix: BE
Stellenanzahl: 4
Nächster Wert: 1
dazu, dass die Numerierung der Bestellungen das Schema „BE0001“, „BE0002“ „BE0003“, usw. hätte.
Schritt 4: Sourcecode-Anpassungen in Java-Regeln
Java-Klasse | Kurzbeschreibung |
---|---|
org.nuclet.nummernkreise.rule.GeneriereNummer | Nummerngenerierung bei Insert-Event |
org.nuclet.nummernkreise.rule.GeneriereNummerBeiStatuswechsel | Nummerngenerierung bei Statuswechsel |
Tabelle 2: Anwendungsspezifische Anpassungen in Java-Regeln
Das Nummernkreise-Nuclet hält jeweils eine Java-Regel vor für
Nummern, die beim Insert generiert werden sollen
Nummern, die bei einem Statuswechsel generiert werden sollen
Diese Regeln müssen bei der Nuclet-Integration mit einer Implementierung für die tatsächlich genutzten Entitäten gefüllt werden.
Hier nun ein Beispiel, wie die Klasse org.nuclet.nummernkreise.rule.GeneriereNummer im Basistemplate-Nuclet angepasst worden ist:
/** @name GeneriereNummer * @description Generiert fortlaufende Nummern * @usage * @change */ @Rule(name="GeneriereNummer", description="Generiert fortlaufende Nummern") public class GeneriereNummer implements InsertRule { public void insert(InsertContext context) throws BusinessException { final Modifiable businessObject = context.getBusinessObject(Modifiable.class); if (businessObject instanceof Auftrag) { ((Auftrag)businessObject).setNummer(NummernkreiseLogik.getNextValue(Auftrag.class)); } else if (businessObject instanceof Bestellung) { ((Bestellung)businessObject).setNummer(NummernkreiseLogik.getNextValue(Bestellung.class)); } else if (businessObject instanceof Lieferschein) { ((Lieferschein)businessObject).setNummer(NummernkreiseLogik.getNextValue(Lieferschein.class)); } } }
Schritt 5: Einhängen der Java-Regeln im Regel-Management
Die Java-Regeln, die in Schritt 5 angepasst worden sind, müssen im letzten Schritt noch den tatsächlichen Entitäten (bzw. deren Events oder Statuswechseln) zugeordnet werden. Dies erfolgt über den Menüpunkt „Konfiguration“ > „Regel Management“.