Allgemein

Regeln des Typs "PrintFinal" können nur Businessobjekte zugewiesen werden und müssen das Interface "PrintFinalRule" implementieren.

Innerhalb des Baums mit der Regelbibliothek werden sie dem Knoten "PrintFinal" zugeschrieben.

Struktur

package org.nuclet.businessentity; 
import org.nuclos.api.rule.PrintFinalRule; 
import org.nuclos.api.context.PrintFinalContext; 
import org.nuclos.api.annotation.Rule; 
import org.nuclos.api.exception.BusinessException; 
/** @name        
  * @description 
  * @usage       
  * @change      
*/
@Rule(name="Dokumente archivieren", description="Dokumente archivieren")
public class Dokumentearchivieren implements PrintFinalRule {
    public void printFinal(PrintFinalContext context) throws BusinessException { 
    }
}

Das entsprechende Interface schreibt die Implementierung der Methode "printFinal" vor und liefert als Kontext die Klasse PrintFinalContext.

Darin enthalten sind

• die gesammelten Druckergebnisse bestehend aus Ausgabeformat und Datei
• das Businessobjekt aus dem Ausführungskontext

Weiterhin können die Funktionen des übergeordneten RuleContexts genutzt werden.

Nach dem Absenden der Druckaufträge an Nuclos wird eine Instanz der PrintFinalRule erstellt und die print-Methode mit einem PrintFinalContext aufgerufen.

Dieser enthält die gesammelten Druckergebnisse.

Innerhalb der printFinal-Methode kann der Regelprogrammierer auch eine BusinessException werfen, die zum Abbruch des Events 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 "Print" können nur Businessobjekte 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, nicht die Regel selbst. Weiterhin lässt sich 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 "PrintFinal" veranschaulicht.

Probleme und Lösungen

Support und Informationen zur Problembehandlung finden Sie hier.