CCM Installation AV

Installation von CCM Basis / Arbeitsvorräten

CCM teilt sich in verschiedene Komponenten auf, die separat installiert werden müssen. Dies sind:

  • Eine Backendkomponente,
  • Die Komponenten für die Oberfläche und den spezifischen Content

Installation des Backend

Die Backendkomponente von CCM, die Dienste zur Verfügung stellt und die Korrelation bewerkstelligt, ist in die Auslieferung der B2B Engine integriert.

Datenbankänderungen

Folgende Datenbank-Tabellen bilden die Datenbasis von CCM 1.1 und müssen angelegt werden, falls sie noch nicht existieren.

Tabelle Beschreibung
B2BBP_CCM_RESULT Gespeicherte Suchergebnisse
B2BBP_CCM_INDEX_SYNC Puffertabelle für Änderungen am Index
B2BBP_CCM_UPDATE_BACKUP Puffertabelle, die Überholer auffängt

Weitere Komponenten

Die Auslieferung der folgenden Module und Komponenten erfolgt in einem gepackten Archiv, welches alle benötigten Dateien enthält. Die folgenden Schritte innerhalb dieses Kapitels sind für jedes System gleich und können auch über ein Customizing automatisch gesetzt werden.

Indexverzeichnis erstellen und konfigurieren

Legen Sie zuerst ein Verzeichnis für den CCM 1.1 Index an. Das Verzeichnis darf nicht identisch zu dem des Standard Index sein.

Konfigurieren Sie dann den Pfad in der Extension SEARCH_LAYER_CONFIGURATION wie hier beschrieben: SearchLayer.

Global Property B3P_INBOX_MONITORING_PROVIDERS definieren

Damit die CCM Arbeitsvorräte überhaupt angezeigt werden können, muss folgendes Global Property zum Registrieren der CCM Arbeitsvorräte angepasst werden:

Eigenschaft

Wert

B3P_INBOX_MONITORING_PROVIDERS

$BISHERIGER_WERT,

processMonitorViewLinkButton

Vorsicht: Hierbei den vorhandenen Inhalt erweitern um „processMonitorViewLinkButton“.

Die Werte in diesem Schlüssel werden mit Komma getrennt ohne Leerzeichen oder Zeilenumbruch angegeben.

Global Property B3P_CCM_CHECK_USING_UPDATE_TBL

Attribute Value Description
B3P_CCM_CHECK_USING_UPDATE_TBL true Check if the update table exists

Extension CLEARING_CODES_PM definieren

Beinhaltet alle möglichen CCM Clearing Codes, die zu vergeben sind, mit ihrer jeweiligen Beschreibung.

Feld Wert
Typ CLEARING_CODES_PM
Provider <leer>
Version <leer>
Inhalt Systemspezifisch, beispielhafter Inhalt in Auslieferung.

Extension CLEARING_CODES_PM_STATUS definieren

Beinhaltet das Mapping zwischen CCM Clearing Code und dem resultierenden Status der Nachricht.

Feld Wert
Typ CLEARING_CODES_PM_STATUS
Provider <leer>
Version <leer>
Inhalt Systemspezifisch, beispielhafter Inhalt in Auslieferung.

Registrieren des Attributs für CCM Arbeitsvorräte in der Benutzerverwaltung

Um die Arbeitsvorräte des CCM verwenden zu können, muss eine Verbindung des Moduls zum Benutzermanagement hergestellt werden. Dies geschieht über folgendes Attribut für die Ansicht der Oberfläche Arbeitsvorräte.

Attribute für die Arbeitsvorräte definieren

Für jeden benötigten Arbeitsvorrat muss nun eine entsprechende Variant in der Extension FLEXIBLE_INDEX_UImit einer Arbeitsvorratsansicht (InboxViewDefinition)verknüpft werden. Dabei ist im Attribut id der InboxViewDefinition ein eindeutiger Bezeichner zu vergeben, im Attribut title der Name des Arbeitsvorrats, wie er in der Oberfläche erscheinen soll, und in den Parametern (Attribut ‘params’ unter dem Schlüssel VARIANT der Name der Variant, wie er in der Extension flexible_index_ui erscheint.

Beispiel: aus folgendem Eintrag in der Extension flexible_index_ui:

#VARIANT-START INVOIC-REMADV Abgleich über Partner $PRE

Wird folgendes Attribut:

Feld Wert
Attribute ID INBOX_PROCMON11_INVOIC_REMADV
Wert InboxViewDefinition={type=Inbox_PROC_MON,id=PROCMON_INVOIC_PARTNER,title=Invoic Abgleich über Partner,params=[VARIANT:’INVOIC-REMADV Abgleich über Partner $PRE’]}

Attribute zu Nutzerrolle zuweisen

Die definierten Attribute müssen den gewünschten Rollen zugeordnet werden.

Jedes oben definierte Attribut muss nun der Rolle ccm, bzw. den gewünschten Rollen zugefügt werden. Der Prozess wird hier für die Rolle „ccm“ und das Attribut „INBOX_PROCMON11_INVOIC_REMADV“ exemplarisch durchgeführt.

Dazu wechseln Sie in den Bereich „Rollen“ der Benutzerverwaltung.

Klicken Sie auf „Hinzufügen“.

Feld Wert
Rollen ID ccm
Attribute ID INBOX_PROCMON11_INVOIC_REMADV
Beschreibung <optional>

Systemspezifische Anpassungen

Anpassungen in Extension B3P_INDEX_MANAGEMENT

Erweitern Sie die Extension “B3P_INDEX_MANAGEMENT” wie im Screenshot:

  1. Zu ‘indexes’ den Wert B3P_FLEXIBLE_INDEX_CORR_DIRECTORY hinzufügen. Die Liste ist mit Semikolons getrennt.
  2. Ergänzen Sie die folgende Konfiguration für den Index:

B3P_INDEX_MANAGEMENT

...
...
B3P_FLEXIBLE_INDEX_CORR_DIRECTORY.reindexer=com.nextlevel.ccm.indexing.precorrelate.FlexibleReIndexerPreCorrelate
B3P_FLEXIBLE_INDEX_CORR_DIRECTORY.syncField=B3P.MessageId
B3P_FLEXIBLE_INDEX_CORR_DIRECTORY.syncType=flexibleCorr

Falls bestimmte Channels aus der Re-Indizierungsanzeige ausgeschlossen werden sollen, kann dies im unteren Teil der Konfiguration angegeben werden:

excluded.B3P_FLEXIBLE_INDEX_CORR_DIRECTORY=INBOUND_CONTRL;OUTBOUND_CONTRL

Extension B3P_CCM_CHANNELS definieren

Erstellen Sie eine Textdatei mit allen Channels, in der die zu indizierenden Nachrichten eingehen. Das sind normalerweise fast alle Channels außer den SPLIT Channels.

Wenn alle Split Channel entsprechend benannt sind, kann die Liste der Channels mithilfe des folgenden SQL-Statements ermittelt werden:

select distinct(ac.CHANNELID)

from B2BBP_ADM_CHANNEL ac

where ac.CHANNELID not like ‘%SPLIT%’;

Erstellen Sie aus dem Ergebnis der Abfrage eine Textdatei.

Definieren Sie eine neue Extension “B3P_CCM_CHANNELS” und laden Sie die Textdatei:

Feld Wert
Typ B3P_CCM_CHANNELS
Provider <leer>
Version <leer>
Inhalt Wie oben erzeugte systemspezifische Textdatei

Nutzerrolle den Benutzern zuweisen

Die oben definierten Rolle bzw. Rollen müssen nun den Benutzerkonten zugewiesen werden, die die CCM Arbeitsvorräte nutzen sollen.

Dazu wechseln Sie in den Bereich „Rollenzuordnung“ der Benutzerverwaltung.

Klicken Sie auf „Hinzufügen“.

Feld Wert
Benutzer ID <wählen SIe einen Benutzer>
Rollen ID ccm
Beschreibung <optional>

Services definieren

CCM Index Service definieren

Definieren Sie einen neuen Service Task unter “Administration -> Services” wie folgt:

Field Value
ID ccm_index_pre (eindeutige ID)
Name CCM Index Service
Typ INDEX
Klasse com.nextlevel.ccm.indexing.service.IndexServiceCCM
Channel <keine Auswahl>
Richtung Engine nach Business Partner
Status STP
Erstellt von b2bbp
Startup Yes (check box)

Service-Attribute für den IndexServiceCCM

Fügen Sie die folgenden Service-Attribute hinzu:

Eigenschaft Wert Beschreibung
B3P_POLL_INTERVAL Positive Ganzzahl Periode für Neustart des Service, in Sekunden
B3P_SEARCH_INDEX_TYPE B3P_FLEXIBLE_INDEX_CORR_DIRECTORY Bezeichner des zu lesenden Index
B3P_MAX_FILES 100 (Positive Ganzzahl) Anzahl der Nachrichten, die bei Aufruf des Service “in einem Rutsch“ verarbeitet werden. 100 ist empfohlen. Bei zu großen Werten steigt der Speicherverbrauch stark an.
B3P_ENABLE_SERVICE_PAUSE_STATE true / false Einstellung zur Pausierung des IndexService für Sicherung.
B3P_OPT_TIMESTAMP_UPDATE true Optimierte Version des Timestampverfahrens wählen. (Ab Version 1.7)

Knotenzuordnung

Ordnen Sie einem Knoten den Service zu. Der Service darf maximal auf einem Knoten laufen. Die Liste der Services pro Knoten ist mit Komma getrennt:

Extension zum Pausieren des CCM Index Service

Definieren Sie eine Extension service_pause_interval_ccm_index_pre.

Feld

Wert

Typ

service_pause_interval_ccm_index_pre

Provider

<leer>

Version

<leer>

Inhalt

Für eine Pause zwei mal in der Woche

repeatInterval Weekly
daysOfWeek Wednesday; Sunday
startTime 20:30
endTime 21:30

Oder für eine Pause jeden Tag

repeatInterval Daily
startTime 20:30
endTime 21:30

Der angegebene Inhalt der Extension verursacht eine Pausierung des ccm Index Service am Mittwoch und Sonntag zwischen 20:30h und 21:30h, (oder alternativ täglich) innerhalb derer der Index gesichert werden kann.

Updatebackup Service anlegen

Der Update Backup Service wird wie folgt angelegt:

Field Value
ID Choose an unique id (z.B ccm_update)
Name z.B. CCM Update Service
Typ INDEX
Klasse com.nextlevel.ccm.indexing.service.UpdateBackupIndexServiceCCM
Channel No selection
Richtung Engine nach Business Partner
Status STP
Erstellt von b2bbp
Startup Yes (check box)

Attribute Value Description
B3P_POLL_INTERVAL Positive full number Period the service runs in seconds
B3P_MAX_FILES Positive full number Messages to process per execution of service

Den Service einem Knoten zuordnen:

Konfiguration des Scheduler Service

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

Field Value
ID Choose an unique id (z.B CCM_SCHEDULER)
Name z.B. CCM Suchen im Hintergrund ausführen
Typ SCHEDULER
Klasse org.b2bbp.service.inbound.scheduled.SchedulerRegisterService
Channel No selection
Richtung Engine nach Business Partner
Status STP
Erstellt von b2bbp
Startup Yes (check box)

Folgende Attribute müssen hinzugefügt werden

Attribute Value Description
B3P_SCHEDULER_NAME CCM_Scheduler Name of the scheduler service
B3P_SCHEDULER_TYPE DELAY  
B3P_SCHEDULER_REGISTER_CLASSNAME com.nextlevel.ccm.indexing.precorrelate.scheduler.ScheduledBackgroundJob Messages to process per execution of service
B3P_DELAY_MINUTES 1 Minutes per repeat
B3P_DELAY_REPEAT true Set repeat on

Wenn automatisierte Mails bei Status Rot verschickt werden sollen, werden die folgenden Parameter benötigt:

Attribute Value Description
B3P_MAIL_FROM <Mail From> Mail From address
B3P_SMTP_HOST <SMTP host> Hostname of the SMTP server
B3P_SMTP_PORT <SMPT port> Port of the SMTP server
B3P_SMTP_USER <SMTP User>, optional User account for the SMTP server (only set if SMTP authentication is enabled)
B3P_SMTP_PASSWD <SMTP Pass>, optional Password for the SMTP server (only set if SMTP authentication is enabled)

Der soeben definierte Service muss danach noch einem Knoten zugewiesen werden.

Neustart

Als Letztes müssen alle tomcat Knoten nach der Installation und Einrichtungen einmal neu gestartet werden, damit die neuen Einstellungen aktiviert werden.

View Me   Edit Me