Arbeitsvorräte: Konfiguration des CCM Schedulers

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