Konfiguration des CCM Schedulers, der eingeplante Suchen ausführt

Konfiguration des CCM Schedulers

Falls Auswertungen im Hintergrund erfolgen sollen, muss ein neuer Scheduler eingerichtet werden:

Feld Wert
ID CCM_SCHEDULER
Name CCM Suchen im Hintergrund ausführen
Typ SCHEDULER
Klasse org.b2bbp.service.inbound.scheduled.SchedulerRegisterService
Channel <keinen auswählen>
Richtung Engine nach Business Partner
Status STP
Erstellt von b2bbp
Optionen Startup auswählen

Der Scheduler benötigt folgende Eigenschaften (Service Properties):

ServiceProperty Wert Bedeutung
B3P_SCHEDULER_NAME CCM_Scheduler  
B3P_SCHEDULER_TYPE DELAY  
B3P_SCHEDULER_REGISTER_CLASSNAME com.nextlevel.ccm.indexing.
precorrelate.scheduler.
ScheduledBackgroundJob
 
B3P_DELAY_MINUTES 1 Wenn der Scheduler gestartet ist, prüft er einmal pro Minute, ob in der Extension B3P_CCM_SCHEDULE eine eingeplante Auswertung zu diesem Zeitpunkt zur Ausführung ansteht und führt diese dann aus.
B3P_DELAY_REPEAT true  
B3P_MAIL_TEXTURE_PROVIDER org.b2bbp.administration.process.
monitoring.autoprocess.
MailTextureProviderCVS [sic!]
Stellt die Funktionalität für den Versand von NFMs mit csv-formatiertem Anhang zur Verfügung. Wird kein Anhang gewünscht (nicht empfohlen), kann der MailTextureProviderStandard verwendet werden
PERFORMANCE_PROTOCOL_LEVEL INFO Einschalten der Performance Protokollierung in den Technischen Details; mögliche Werte:
NONE: Es wird kein Protokoll geschrieben
INFO: [Default] Protokolllevel INFO wird angezeigt
DEBUG: Protokollevels INFO und DEBUG werden angezeigt
ALL: Alle Protokolllevels werden angezeigt.
B3P_MAIL_EXTENSION B3P_MAIL_MAP @deprecated: Extension für Empfänger-Kontakt-Mailadressen; nur verwendet von MailNotifierOnRed

Performance Protokoll

Wenn die ServiceProperty PERFORMANCE_PROTOCOL_LEVEL einen der Werte INFO, DEBUG oder ALL hat oder ganz fehlt (Default: INFO), wird bei der Ausführung jeder eingeplanten Suche ein Performance Protokoll angelegt. Das heißt, bei verschiedenen Arbeitsschritten werden Ausführungszeiten gemessen und in ms angezeigt. Das Performanc Protokoll findet sich im Nachrichtenmonitor an der Nachricht zur Jobausführung unter den Technischen Details.

 

Das Protokoll ist als csv formatiert. Wenn der Inhalt kopiert und in eine Textdatei mit Endung .csv kopiert wird, kann er mit Excel formatiert angezeigt und weiter ausgewertet werden (Summenbildung etc.)

Die Werte aus der Spalte Dauer [ms] INFO geben in Summe die Gesamtdsauer der Jobausführung wieder.

Die Werte in der Spalte Dauer [ms] DEBUG geben noch detailliertere Zeitmessungen, die aber bereits in der Spalte INFO berücksichtigt sind.

Die Spalte Phase gibt einen Titel für die gemessene Phase der Jobausführung.

  • Vorbereitung der Suchanfrage
  • Eigentliche Suche
  • Additional: Ausführung zusätzlicher Features der Arbeitsvorräte wie AdditionalSearch
  • Korrelation: Suche nach korrelierten Nachrichten, wie z.B. Antworten
  • Hinzufügen zusätzlicher Ergebniszeilen durch Addender
  • Sortierung der Suchergebnisse
  • Speichern DB: Abspeichern der Ergebnisse in der Datenbank

Die Spalte Block gibt die Blocknummer bei paginierten Suchanfragen an. Wenn eine Suche mehr als 2000 Ergebnisse liefert, werden die Suchergebnisse in Blöcken zu 2000 Stück abgeholt, verarbeitet und abgespeichert.

Die Spalte Ergebnisse gibt an, wieviele Ergebnisse die Suche im entsprechenden Bllock geliefert hat.

Das Protokoll ist so programmiert, dass bei Abbruch einer Suche mit einer Exception, das bisher geschriebene Protokoll trotzdem gespeichert wird. Aus den fehlenden Einträgen lässt sich dann schließen, in welchem Schritt die Ausführung abgebrochen ist.

Für den Fall, dass Suchen endlos laufen und nicht abbrechen, kann durch Eintragen eines Klassen-Loglevels

com.nextlevel.ccm.indexing.precorrelate.search.PagingFlexibleSearchHandler=DEBUG

in der Extension LOG_LEVELS ein DEBUG-Logging für jeden einzelnen Schritt eingeschaltet werden. Wenn die Suche hängenbleibt, gibt der zuletzt geschriebene Eintrag einen Hinweis auf die Stelle, an der der Job hängt:

PERFORMANCE_PROTOCOL: Variant 'Fehlende Contrl 201504 $PRE'; Phase 'Start'
PERFORMANCE_PROTOCOL; Variant 'Fehlende Contrl 201504 $PRE'; Phase 'Vorbereitung'; 0 ms
PERFORMANCE_PROTOCOL; Variant 'Fehlende Contrl 201504 $PRE'; Phase 'Suche'; 115 ms
...

Einstellungen für Nachforderungsmails

Wenn Nachforderungsmails verschickt werden sollen (Einstellung “Erinnerung bei Status Rot (Neuer Standard)” -> Nachforderungsmails einrichten), werden folgende weitere Parameter benötigt:

ServiceProperty Wert Bedeutung
[B3P_MAIL_TO] z.B. e2w@b2bbp.org (optional) Empfängeradresse an die in den Nachforderungsmails angegeben werden soll.
ACHTUNG!!! Wird dieser Wert gesetzt, überschreibt er die Werte aus den Extensions vom Typ B3B_CCM_CONFIG
[B3P_MAIL_FROM] z.B. clearing@b2bbp.org (optional) Absenderadresse die in den Nachforderungsmails angegeben werden soll.
ACHTUNG!!! Wird dieser Wert gesetzt, überschreibt er die Werte aus den Extensions vom Typ B3B_CCM_CONFIG
B3P_SMTP_HOST z.B. Hostname des SMTP-Servers, über den die Nachforderungsmails versendet werden sollen (IP-Adresse oder localhost)
B3P_SMTP_PORT z.B. 8025 Port des SMTP-Servers
[B3P_SMTP_USER] (wenn benötigt) Username des Accounts auf dem SMTP-Server
[B3P_SMTP_PASSWD] (wenn benötigt) Passwort  des Accounts (wenn benötigt)
B3P_CONTENT_TYPE text/html MIME-Typ der Nachforderungsmails
[B3P_MAIL_TEXTURE_PROVIDER] org.b2bbp.administration.process.monitoring.autoprocess.
MailTextureProviderCVS
(optional) Wird diese Extension gesetzt, so werden Informationen über die Nachrichten, für die Nachforderungen bestehen, als CSV-Datei an die Email angehängt. Ob dieser Mailanhang die Endung .csv oder .txt haben soll, wird in den Extensions vom Typ B3B_CCM_CONFIG mit der Property
[B3P_MAIL_EXTENSION] <Nicht mehr verwenden> Alte Einstellung, gilt nur für die veraltete "automatische Folgeaktion" "Erinnerungsmail bei Status rot". Überschrieb dort vermutlich die Extension, aus der die Empfängeradressen für die NFM gezogen wurden.

 

 

 

 

View Me   Edit Me