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:
- Zu ‘indexes’ den Wert B3P_FLEXIBLE_INDEX_CORR_DIRECTORY hinzufügen. Die Liste ist mit Semikolons getrennt.
- 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
Oder für eine Pause jeden Tag
|
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