ContrlDeadlineJob

ContrlDeadlineJob konfigurieren

Der ContrlDeadlineJob setz den Status CTN (Contrl nicht fristgerecht) für Nachrichten, die keine CONTRL erhalten haben aber für die eine CONTRL erwartet wird.

Klasse:org.b2bbp.service.inbound.scheduled.SchedulerRegisterService

Es müssen nur noch ein paar Service Properties gesetzt werden:

Die Eigenschaften bzgl. des Schedulers (B3P_CRON_…) sind in der entsprechenden Dokumentation zurEintrichtung von Scheduler Services nachzulesen

• B3P_SCHEDULER_REGISTER_CLASSNAME ist als org.b2bbp.service.inbound.scheduled.ContrlDeadlineJob zu setzen.

• B3P_SCHEDULER_TYPE = DELAY
• B3P_DELAY_REPEAT = true
• B3P_DELAY_MINUTES = 60

Nach Vorgaben des BDEW sollen die CONTRLs spätestens nach 6 Stunden eintreffen. ALOCATS sollen spätestens nach 45 Minuten mit CONTRL beantwortet werden. Diese Werte können mit folgenden Serviceeigenschaften überschrieben werden:

• B3P_CHECK_HOURS (Default = 6)
• B3P_CHECK_MINUTES_ALOCAT (Default = 45)

Spartenspezifika

Da ab der Formatumsetllung Juni 2025 für Nachrichten der Sparte Strom keine positive CONTRL mehr versendet wird, werden alle Nachrichten an Marktteilnehmer der Sparte Strom, durch diesen Job nicht mehr beeinflusst.

Für die Konfiguration der Sparte siehe hier und für eine allgemeine Übersicht über Umstellungen im Rahmen der FU Juni 2025 siehe hier

Ausschlussliste für den Contrl-Deadline-Job

Funktionalität: Der ContrlDeadlineJob ändert an Nachrichten gelisteter Partner nicht mehr den Bestätigungsstatus. Dadurch bekommen diese nicht den Status Fristverletzung (CTN) und werden von den Reminder Jobs nicht berücksichtigt.

Extension “CONTRL_DEADLINE_PARTNER_BLACKLIST” enthält den Marktpartner-ID’s der Partner, z.B.:

8888888888881
9905096000009
Hanauer Netz GmbH Strom | 9911795000000

Die Marktpartner-ID’s müssen vollständig, exakt so wie sie im Nachrichtenmonitor dargestellt sind, aufgelistet werden.

Folgender Index wird in der Datenbank (Oracle) benötigt:

create index "IDX_MESSAGE_ACKNOWLEDGEMENT_2" on "B2BBP_DATA_MESSAGE" (PARTNER, ACKNOWLEDGEMENT, STARTED);

Folgender Index wird in der Datenbank (Postgres) benötigt:

create index IDX_MESSAGE_ACKNOWLEDGEMENT_2 on B2BBP_DATA_MESSAGE (PARTNER, ACKNOWLEDGEMENT, STARTED);

ContrlDeadlineReminderJob

ContrlDeadlineReminderJob konfigurieren

Der ContrlDeadlineReminderJob sendet eine Erinnerungsmail an alle konfigurierten Marktpartner, die zu einer Nachricht noch keine Contrl gesendet haben. Die Erinnerung wird für Nachrichten geschickt, die durch den ContrlDeadlineJob den Status CTN erhalten haben. Diese Nachrichten bekommen danach den Status SEN.

Wenn eine Nachricht den Status CTN hat und keine Kontaktadresse für den entsprechenden Partner gefunden werden kann, wird an eine interne Adresse eine Fehlermail versendet. In dieser E-Mail werden alle betroffenen Marktpartner aufgelistet.

Der ContrlDeadlineJob kann hierfür dupliziert werden. Ein paar Service-Eigenschaften sind dann am neuen Job zu ändern:

B3P_EXTENDED_MAIL_INFO

• Bei false werden nur Referenznummern angezeigt (Standardwert)

• Bei true wird für jede Nachricht folgende Informationen angezeigt:

  Referenznummer: 2342123213 Format: UTILMD Absender: 912122123123 Empfänger: 9123244223232 Empfänger E-Mail: energieEdi@beispiel.com Verarbeitet: 01.02.2013 10:22:30

B3P_EXTENDED_MAIL_CONTENT

Hier kann ein Template hinterlegt werden, um die erweiterten Informationen anders zu konfigurieren. Standardwert:

Referenznummer: ${referenceId} Format: ${bdewType} Absender: ${sender} Empfänger: ${receiver} Empfänger E-Mail: ${receiverEmail} Verarbeitet: ${started}

Abschließend müssen noch Extensions gepflegt werden, die den Mailversand konfigurieren

Zusätzliche Extensions

• Extension “CONTRL_DEADLINE_EMAIL_TEXT” enthält den Text der Mail, z.B.:

  “This is a test message. References are here:<br>\ <ref><br>\ Trailing text.”

  Zeilenumbrüche können durch den Html-Tag “<br>" erzeugt werden

• Extension “CONTRL_DEADLINE_EMAILS” enthält zeilenweise die Empfängeradressen, z.B.:

  9000000008080=world_in@b2bbp.org

  Die Extension wird nicht ausgewertet, falls die Nutzung des MPID Editors mit B3P_USE_MPID_EDITOR = true eingeschaltet wurde.

• Extension “CONTRL_DEADLINE_ERRORMAIL_TEXT” enthält den Text der Errormail, z.B.:

  “Für einige Nachrichten wurde keine CONTRL-Nachricht empfangen. Die Nachforderungs-E-Mail konnte jedoch nicht verschickt werden, da die Kontaktadressen fehlen. Bitte fügen Sie in der Marktpartner-Verwaltung Kontakte mit dem Typ “Kontakt für CONTRL-Ablehnungen” für diese Partner hinzu:
  <ref>”

• Extension “CONTRL_DEADLINE_ERRORMAILS” enthält die Errorempfängeraddresse, z.B.:

  “CONTRL_DEADLINE_ERRORMAILS=world_in@b2bbp.org”

• Extension “CONTRL_DEADLINE_CCMAILS” enthält die CC Mailaddressen, z.B.:

  “CONTRL_DEADLINE_CCMAILS=ccmail@b2bbp.org”

In der Extension mit dem Emailtext kann der Platzhalter ${responseDeadline} verwendet werden. An dieser Stelle wird das in der Zukunft liegendes Datum eingefügt, bis wann der Partner auf diese Email antworten soll. Die Frist in Werktagen wird über die Service Property B3P_WORKDAYS_BEFORE_RESPONSE_DEADLINE konfiguriert. Zum Beispiel: “Wir bitten um eine Rückmeldung bis zum ${responseDeadline}.” wird in der Email zu “Wir bitten um eine Rückmeldung bis zum 05.01.2016.” Der Platzhalter wird nur ausgewertet, wenn die erweiterten Informationen geschickt werden (B3P_EXTENDED_MAIL_INFO = true)

Der Platzhalter <ref> kennzeichnet die Stelle im Email-Text, wo die bemängelten Nachrichten aufgelistet werden.

Weiterhin können Service-Eigenschaften gesetzt werden, welche die Bezeichnungen der obigen Extensions überschreiben:

• Service Property B3P_OVERRIDE_EMAILTEXT_EXTENSION setzt die Extension, für die CONTRL_DEADLINE_EMAIL_TEXT zuständig war, neu.
• Service Property B3P_OVERRIDE_EMAILADDRESS_EXTENSION setzt die Extension, für die CONTRL_DEADLINE_EMAILS zuständig war, neu.
• Service Property B3P_OVERRIDE_ERRORMAILTEXT_EXTENSION setzt die Extension, für die CONTRL_DEADLINE_ERRORMAIL_TEXT zuständig war, neu.
• Service Property B3P_OVERRIDE_ERRORMAILADDRESS_EXTENSION setzt die Extension, für die CONTRL_DEADLINE_ERRORMAILS zuständig war, neu.
  Die Extension-Proptery in der Extension muss gleich dem Namen der Extension sein. Zum Beispiel, wenn die Service-Property B3P_OVERRIDE_ERRORMAILADDRESS_EXTENSION = REMINDER_FEHLERMAIL_ADRESSEN heißt, muss in der Extension REMINDER_FEHLERMAIL_ADRESSEN folgendes stehen:
  “REMINDER_FEHLERMAIL_ADRESSEN = world_in@b2bbp.org”
• Service Property B3P_OVERRIDE_CCADDRESS_EXTENSION setzt die Extension, für die CONTRL_DEADLINE_CCMAILS zuständig war, neu.
  Die Extension-Proptery in der Extension muss gleich dem Namen der Extension sein. Zum Beispiel, wenn die Service-Property B3P_OVERRIDE_CCADDRESS_EXTENSION = REMINDER_CC_ADRESSEN heißt, muss in der Extension REMINDER_CC_ADRESSEN folgendes stehen:
  “REMINDER_CC_ADRESSEN = ccmail@b2bbp.org”

Konfiguration des Nachrichtenmonitors für den Bestätigungsstatus “SEN”

Wenn eine Nachforderungs-E-Mail verschickt wurde, ändert sich der Bestätigungsstatus der Nachricht von “SEN” in “ACK”. Um solche Nachrichten filtern zu können, muss die Extension EXT_MESSAGE_ICONS angelegt oder erweitert werden:

SEN.type=ACK
SEN.description=Benachricht. versandt

Danach wird der Filter “Bestätigungsstatus” um den Punkt “Benachricht. versandt” erweitert.

Einrichtung mehrerer Mahnstufen

Der Job kann so konfiguriert werden, dass die Benachrichtigungs-E-Mails erneut versendet werden. Auf diese Weise können mehrere Mahnstufen eingerichtet werden.

Ein Beispiel für die erste Benachrichtungung nach einem Tag und erneute Benachrichtigungen nach drei Tagen: Es werden zwei ContrlDeadlineReminderJobs mit überwiegend gleichen Einstellungen eingerichtet, jedoch mit folgenden Besonderheiten:

Der erste Job läuft jede Stunde und prüft die Nachrichten von gestern und heute, verschickt die erste Benachrichtigungs-E-Mail und setzt den Bestätiguntsstatus der Nachricht auf “SEN”

CHECK_DAYS_FROM = 1
CHECK_DAYS_TO = 0
CHECK_DAYS_WITH_FACTORY_CALENDAR = false
RESEND_ON_ACKNOWLEDGEMENT_SEN_ONLY = false
B3P_SCHEDULER_TYPE = CRON
B3P_CRON_MINUTES = 00

Der zweite Job läuft jeden Tag um 6:00 Uhr und verschickt die zweite E-Mail für Nachrichten, die drei Tage vor dem aktuellen Datum eingegangen sind und weiterhin den Status “SEN” haben. Der Status bleibt dabei auf “SEN”.

CHECK_DAYS_FROM = 3
CHECK_DAYS_TO = 3
CHECK_DAYS_WITH_FACTORY_CALENDAR = false
RESEND_ON_ACKNOWLEDGEMENT_SEN_ONLY = true
B3P_SCHEDULER_TYPE = CRON
B3P_CRON_HOURS = 6
B3P_CRON_MINUTES = 00