BAM Logging: Migration

Für den BAM Logging Adapter aus X4 BPMS-Versionen 6.x ist keine Migration erforderlich.

Für die Migration des BAM Log Adapters (Versionen 1.0.0 und 1.1.0) auf Version 2.1.1 ist eine Änderung der Datenbankstruktur erforderlich.

Austausch des Adapters

1. Löschen Sie das Modul <Serververzeichnis>\wildfly\modules\de\softproject\x4\adapter\BamLogAdapter und den dazugehörigen Eintrag aus der Datei <Serververzeichnis>\wildfly\modules\de\softproject\x4\extensions\main\module.xml.

2. Speichern Sie das neue Modul bamlog im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\x4\adapter.

3. Fügen Sie den Adapter in der Datei <Serververzeichnis>\wildfly\modules\de\softproject\extensions\main\module.xml: 

   1. Öffnen Sie die Datei module.xml im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\extensions\main.

   2. Kopieren Sie den Adapter-Namen in den Tag <dependencies>:

      <module name="de.softproject.x4.adapter.bamlog" export="true"/>

4. Starten Sie den X4 Server neu.
   Der BAM Log Adapter 2.1.1 ist nun im Designer verfügbar.

Austausch des Adapters in der Sicht Projects

Hinweis:

Wenn jeweils der gleiche Name für die Adapter-Definitionsdatei gewählt wurde, muss in den Prozessen nichts angepasst werden.

1. Löschen Sie nach dem Neustart des X4 Servers im X4 Designer die bisherige Adapter-Definition des BAM Adapters (.fa-Datei).

2. Legen Sie den Adapter neu an. 

Austausch des impliziten BAM Loggings in Prozessen

Hinweis:

Wenn in Prozessen noch ein implizites BAM Logging (auf Transitionen) genutzt wird, muss der Adapter im Prozess getauscht werden.

1. Öffnen Sie den betroffenen Prozess mit einem XML-Editor.

2. Ersetzen Sie in allen XML-Elementen vom Typ Action[@type='BAM'] den Eintrag de.softproject.integration.nativeadapter.NativeAdapter durch de.softproject.integration.adapter.bam.BAMAdapter im folgenden Abschnitt:

   XML

   <Parameter id="2"
              type="UserDefined">
   	<name>Adapter</name>
   	<value>de.softproject.integration.nativeadapter.NativeAdapter</value>
   </Parameter> 

   XML-Element nach Austausch des Adapternamens:

   XML

   <Parameter id="2"
              type="UserDefined">
   	<name>Adapter</name>
   	<value>de.softproject.integration.adapter.bam.BAMAdapter</value>
   </Parameter> 

Austausch der Datenbanktabellen

In den Tabellen x4data, x4message, x4status wurden Optimierungen vorgenommen. Zur Anpassung daran ist es am einfachsten, die bisherigen Tabellen umzubenennen oder zu löschen, falls die Daten nicht benötigt werden. Beim Start des X4 Servers werden diese automatisch erneut angelegt.