Das E-Mail-Benachrichtigungsmodul unseres Systems ermöglicht eine flexible Gestaltung von Benachrichtigungen durch einen spezialisierten Editor. Dieser Editor erlaubt das Einsetzen von vordefinierten Platzhaltern in E-Mail-Vorlagen. Bei der Versendung werden diese Platzhalter automatisch mit den zugehörigen Daten gefüllt.

Organisation der Platzhalter

Die Platzhalter sind nach Themen gruppiert, wie Empfänger, Benachrichtigungstyp, Benachrichtigungsregel, Systemeinstellungen für die Vorlaufzeit zur Erneuerungserinnerung, das Ablaufdatum der Zertifizierung und Zertifizierungsobjekte. Wir werden später erläutern, wie diese letzten drei programmatisch bereitgestellt werden, um ihre Auswahl in der E-Mail-Vorlage zu ermöglichen.

Die Konfiguration umfasst verschiedene Eingabefelder, die das JSF Expression Language Format unterstützen. Dieses Format erlaubt es, dynamische Ausdrücke direkt im XHTML-Code zu nutzen, was eine effiziente Datenverarbeitung und -darstellung ermöglicht.

Hier ist ein Beispiel, wie dynamische Listen von Zertifizierungsobjekten im XHTML dargestellt werden können:

Dieser Codeabschnitt demonstriert, wie man eine ungeordnete Liste von Objekten erstellt, wobei jedes Element der Liste einem Zertifizierungsobjekt entspricht.

Das neue Benachrichtigungen Modul kann beim Erstellen konfiguriert werden. Ein Wochentag kann bestimmt werden, an den es ausgelöst werden soll.

Die Nutzer benötigten ein System, das sie rechtzeitig informiert, welche Objekte innerhalb zB. des nächsten 365 Tage eine Erneuerung ihrer Zertifikate benötigen.

Die Oberfläche für die Benachrichtigungskonfiguration ermöglicht es dem Administrator, das Benachrichtigungsmodul flexibel anzulegen. Die Konfiguration erfolgt über XHTML und ist wie folgt definiert:

Dieser Codeabschnitt demonstriert, wie Label in JSF konfiguriert werden. Es zeigt auch, wie man eine `af:panelLabelAndMessage` verwendet, um Label und Wert/Input in einer Zeile zu organisieren. Die Facetten, hier verwendet mit ``, erlauben es, spezifische Teile an bestimmten Stellen zu positionieren, was für ein übersichtliches Layout sorgt.

Zuerst haben wir ein AFPanelFormLayout verwendet und das hat dafür gesorgt, dass der Label in eine neue Zeile gerutscht ist, statt in derselben Zeile wie der Wert/Input zu bleiben.

Um diese Anordnung zu korrigieren, haben wir das AFPanelLabelAndMessage-Element eingeführt, das sowohl das Label als auch den zugehörigen Wert (Message) umfasst. Dieses Element erlaubt es uns, die Anzeige so zu steuern, dass Label und Wert in derselben Zeile erscheinen. Es ist auch wichtig, das Attribut simple="true" beim Input-Text zu verwenden, um unerwünschte Label-Darstellungen zu vermeiden und nur den Wert anzuzeigen. Diese Anpassung verhindert unnötige Einrückungen und sorgt für ein sauberes Layout.

Zusätzlich wurde die Notwendigkeit einer angepassten Breite für den Input-Text mittels der Style-Klasse size80 betont, die eine angemessene Breitenanpassung ermöglicht und so das Gesamtbild verbessert. Es wird auch gezeigt, wie Facetten genutzt werden können, um spezifische Layout-Anforderungen innerhalb von JSF-Komponenten zu erfüllen. Insbesondere die end Facette im AFPanelLabelAndMessage, die dazu dient, den Output-Text mit einem kleinen Abstand richtig zu positionieren, um eine klare Trennung der Elemente zu gewährleisten.

Das Modul nutzt das Interface RecertificationDueNotificationRule, um die Regeln für die Benachrichtigungszeitpunkte zu definieren. Die Klasse RecertificationDueNotificationRuleDecorator implementiert dieses Interface und stellt Methoden bereit, um die Einstellungen für die Vorlaufzeit der Erneuerungserinnerungen zu lesen und zu schreiben.

    
@Name(RecertificationDueNotificationModule.COMPONENT_NAME)
@Scope(ScopeType.APPLICATION)
@AutoCreate
@Startup(depends = {"org.jboss.seam.navigation.pages", StandingDataPersister.COMPONENT_NAME})
public class RecertificationDueNotificationModule
    extends TimeBasedNotificationModule<RecertificationDueNotificationRule> {

    private static final long serialVersionUID = -2321605615754993069L;
    public static final String COMPONENT_NAME = "RecertificationNotificationModule";

    @In
    private ActivityDao activityDao;
    @In
    private TaskDao taskDao;

    @Override
    protected void processTimeBasedNotification(RuleContext<RecertificationDueNotificationRule> rule) {
        Long renewalReminderLeadTime = rule.getConfig().getRenewalReminderLeadTime();
        Date from = rule.getLastInvocation();
        Date to = rule.getNow();
        User user = rule.getUser();

        Date renewalReminderLeadTimeEnd = DateUtils.addDays(to, renewalReminderLeadTime.intValue());
        Date lastRenewalReminderLeadTimeEnd = DateUtils.addDays(from, renewalReminderLeadTime.intValue());
        List<Funcloc> funclocList = getFunclocList(
                lastRenewalReminderLeadTimeEnd, renewalReminderLeadTimeEnd);

        if (!funclocList.isEmpty()) {
            sendNotification(rule, funclocList, renewalReminderLeadTime);
        }
    }

    public List<Funcloc> getFunclocList(Date lastRenewelReminderLeadTimeEnd, Date renewelReminderLeadTimeEnd) {
        String hqlQuery = "select f from Funcloc f join f.attributes attribs where f.typeCat.name = 'SAV' and attribs.attribTypeCat.name = 'Rezertifizierung' and trunc(:lastRenewalReminderLeadTimeEnd) < trunc(safe_to_date(attribs.value)) and trunc(safe_to_date(attribs.value)) <= trunc(:renewalReminderLeadTimeEnd)";
        Query query = Lookup.entityManager().createQuery(hqlQuery);
        query.setParameter("lastRenewalReminderLeadTimeEnd", lastRenewelReminderLeadTimeEnd);
        query.setParameter("renewalReminderLeadTimeEnd", renewelReminderLeadTimeEnd);
        List<Funcloc> funclocList = query.getResultList();
        return funclocList;
    }
}