Die hinterlegten Status können für manuelle Statuswechsel im StatemodelProvider verwendet werden.

In Nuclos können Arbeitsschritte erstellt werden. Um auch innerhalb von Regeln Arbeitsschritte manuell ausführen zu können, werden nach dem erfolgreichen Speichern eines Arbeitsschrittes sogenannte Arbeitsschritt-Klassen oder auch Generation-Klassen erstellt. Diese können über den GenerationProvider gestartet werden. Eine Arbeitsschritt-Klasse ist mittels Generics typsicher aufgebaut und legt Quell- und Zielobjekte als BusinessObjekte fest.

Allgemeine Konventionen:

Beispiel der Arbeitsschritt-Klasse "ErstelleRechnungAusAuftragGEN":

public class ErstelleRechnungAusAuftragGEN implements Generation<Auftrag, Rechnung> { 
	public Class<Auftrag> getSourceModule() {
 		return Auftrag.class;
	}
	public Class<Rechnung> getTargetModule() {
		return Rechnung.class;
	}
}

ReportDatasource-Klasse

public class ExportRechnungsdatenDS implements Datasource {

	public static final Long id = new Long(40016085); 
	public static final String name = "Export: Rechnungsdaten"; 
	public static final String description = "Export: Rechnungsdaten - für alle Kunden"; 
	public Long getId() { return new Long(40016085);}  
}

public class MeinAuftragReportRE implements Report {
	public static final OutputFormat Auftrag = new OutputFormat(new Long(40314675L));

	public Long getId() {
    	return new Long(40314673L); 
	}
}

public class AngebotPO implements Printout {
	public static final OutputFormat Angebot_Druck = new OutputFormat(new Long(40019472L));
	public static final OutputFormat Angebot_Email = new OutputFormat(new Long(40298009L));

	public Long getId() {
    	return new Long(40019470L); 
	}

Wird in Nuclos eine ImportStrukturDefinition angelegt, wird eine entsprechende Definition-Klasse erstellt. Diese kann in der Regelprogrammierung verwendet und über den ImportProvider ausgeführt werden. Innerhalb der generierten Java-Klasse wird die interne Nuclos-Id der Strukturdefinition abgelegt.

Allgemeine Konventionen:

• Der Name der ImportStrukturDefintion-Klasse entspricht dem java-tauglich überarbeiteten Namen des Sturkturdefinition. So sind weder Sonderzeichen noch Leerzeichen erlaubt.
• Jede ImportStrukturDefintion-Klasse besitzt weiterhin eine Package-Angabe. Wurde eine Sturkturdefinition keinem Nuclet zugewiesen, wird als Default das Package "org.nuclet.importstructure" verwendet, ansonsten der Pfad des Nuclets, z.B: org.meineFirma.meinNuclet

public class MaterialImportIDS implements ImportStructureDefinition {
public Long getId() {
    return new Long(41763890L);
}

NucletParameter:

Wird in Nuclos ein Nuclet Parameter angelegt, wird für das entsprechende Nuclet eine Parameter-Klasse generiert, die in der Regelprogrammierung mittels ParameterProvider verwendet werden kann. Innerhalb der generierten Java-Klasse wird der neue Parameter als Konstante angelegt.

Allgemeine Konventionen:

package org.nuclet.zahlungsverkehr;

import org.nuclos.api.parameter.NucletParameter;

public class ZahlungsverkehrNucletParameter {

    public static final NucletParameter MT940_DIRECTORY = new NucletParameter("gV8rfNzwf59Dx6fsiVoc");
    public static final NucletParameter MT940_FILE_ENCODING = new NucletParameter("pz3QpFCqSUumGgqNxZD9");
    public static final NucletParameter MT940_FILE_EXTENSION = new NucletParameter("tn9x29Y7Rn5kDilAVyaY");
    public static final NucletParameter MT940_REFERENCE_TYPE = new NucletParameter("8dTfwTM26hCR2GqQRNdt");
   
}

SystemParameter:

Werden in Nuclos Systemparameter über "Parameter" angelegt, wird die Klasse "NuclosSystemParameter" generiert. Diese beinhaltet alle SystemParameter, die nicht einem Nuclet zugewiesen sind, und kann mittels ParameterProvider verwendet werden.

Allgemeine Konventionen:

package org.nuclos.parameter;

import org.nuclos.api.parameter.SystemParameter;

public class NuclosSystemParameter {
   
    public static final SystemParameter POP3Username = new SystemParameter("MSBTcg7xpw1rGrQdQfUN");
    public static final SystemParameter POP3Server = new SystemParameter("oY9S8h6GfxXTN7nZgZYx");
    public static final SystemParameter POP3Port = new SystemParameter("EPFVPnfPTKPZPN4o9QsH");
    public static final SystemParameter POP3Password = new SystemParameter("7FcWwzSt9gxl4lEKne8F");
    public static final SystemParameter IMAPServer = new SystemParameter("qGDEZAUGXpVpMi4A83SV");
    public static final SystemParameter IMAPPort = new SystemParameter("ZjDGZCA6EN8ckspRgYXy");
    public static final SystemParameter IMAPProtocol = new SystemParameter("cbv5h8m9zDBJlY6swmWD");
    public static final SystemParameter IMAPUsername = new SystemParameter("xn2JskFs6nr2sChu5UR7");
    public static final SystemParameter IMAPPassword = new SystemParameter("OJMsKlFfH0ujcSPH5j15");
}

Klassengenerierung und Regelkompilierung

Allgemein

Für die oben beschriebenen Klassen gelten bestimmte Regeln und Reihenfolgen, in der sie erstellt und bereitgestellt werden. Die Klassen werden je nach Typ kompiliert und gruppiert in einer eigenen Jar im CodeGenerator-Verzeichnis abgelegt. Von dort aus werden die Archive in den Classloader aufgenommen und können verwendet werden.

Zeitpunkt der Generierung

Systemstart

Bei Systemstart werden alle der genannten Klassen neu gebaut und im Classloader bereitgestellt. Dazu werden alle vorhanden Klassen und Archive aus dem Codegenerator-Verzeichnis gelöscht. Sollte es an dieser Stelle zu einem Fehler kommen, bleiben die Verzeichnisse (teilweise) leer. Der Server startet weiterhin.

Import eines Nuclets

Mit dem Import eines Nuclets ändert sich in Nuclos alles. Es werden neue Strukturen eingespielt, neue Businessobjekte, Statusmodelle, etc. Logischerweise müssen alle bereits erstellen Klassen gelöscht und der neuen Umgebung entsprechend generiert werden. Auch hier kann es bei ungültigen Daten zu Fehlern und somit zu Fehlermeldungen bei der Kompilierung von Klassen kommen.

Laufzeit

Auch zur Laufzeit können sich Strukturen von Businessobjekten, Statusmodell, etc. ändern, was eine Anpassung und Neuerstellung der Java-Klassen notwendig macht. Wird eine Businessobjekt verändert, muss das entsprechende BusinessObjekt neu erstellt werden. Das Nuclet.jar und das Generation.jar mit den Arbeitsschritten im Anschluss ebenfalls, da sie mit dem betroffenen BusinessObjekt evtl. arbeiten. Für die Sicherstellung der Datenstrukturen ist das notwendig.

Report-Klassen, Arbeitsschritt-Klassen und Statusmodell-Klassen fordern ebenfalls eine Neugenerierung des Nuclet-jars, sollte im entsprechenden Editor das Modell verändert worden sein (löschen, anlegen oder aktualisieren).

Beispiel: In Nuclos wird ein Statusmodell im Editor geladen und dadurch verändert, dass ein Status hinzugefügt wird: Status 40 "Auftrag in Bearbeitung". Mit dem Speichern des Modells wird nun eine neue Statusmodell-Klasse "AuftragSM" erstellt, die diesen Status beinhaltet. Daraufhin erstellen wir eine Regel, die über den StatusmodelProvider eine gegebene Instanz eines Auftrags auf den neuen Status 40 anheben soll. Also einen Statuswechsel vornimmt. Mit dem Speichern der Regel soll die Nuclet.jar neu gebaut werden. Wurde "AuftragSM" korrekt erstellt, kann das Nuclet.jar mit unserer neuen Regel problemlos erstellt werden.
Nun soll aus nicht näher bekannten Gründen der neue Status ein anderes Numeral erhalten. Der Wert wird von 40 auf 50 gesetzt. Mit dem Speichern wird wie zuvor eine neue Statusmodell-Klasse erzeugt, die mit dem Status 50 aktuell ist. Dennoch erscheint jetzt eine Fehlermeldung, die besagt, dass eine Regel nicht kompiliert werden kann! Was ist passiert? Die Statusmodell-Klasse wurde zwar erfolgreich verändert und neu kompiliert. Unsere Regel möchte aber immer noch einen Auftrag auf den Status 40 anheben und findet diesen Status nun nicht mehr. Damit ist die Regel nicht mehr kompilierbar und die Nuclet.jar nicht baubar. Als Folge müssen alle Referenzen auf den Status 40 manuell aktualisiert werden. In unseren Fall eine Regel.