Das Migrationstool kann in der Befehlszeile ausgeführt werden. Führen Sie im Verzeichnis "EJBServer" Folgendes aus:
build migrateiegscript -Dscriptfilename=myscript.sx
-Dinputdir=C:\mydir -Doutputdir C:\mydir\output
Die drei folgenden Parameter sind obligatorisch:
- scriptfilename: Der Name der veralteten IEG-Scriptdefinitionsdatei, die migriert werden soll, ohne dabei den Speicherort anzugeben.
- inputdir: Der vollständige Pfad zu dem Verzeichnis, in dem sich die veralteten IEG-Artefakte befinden, die migriert werden sollen. In diesem Verzeichnis sind die im Scriptdateinamen angegebene Scriptdefinition sowie alle Fragengruppen und untergeordneten Scripts enthalten, auf die verwiesen wird.
- outputdir: Der vollständige Pfad zu dem Verzeichnis, in dem die neuen Definitionsartefakte erstellt werden. Wenn das Tool mehrere Male ausgeführt wird, sollte der Inhalt gelöscht werden, um negative Überraschungen zu vermeiden.
Die generierten Artefakte lauten folgendermaßen:
- Die neue Scriptdefinition befindet sich im Verzeichnis clob unter outputdir. Der Name lautet unter Zuhilfenahme der Original-Script-ID scriptID.xml. Untergeordnete Scripts befinden sich am selben Speicherort.
- Das Datenspeicherschema befindet sich im Verzeichnis clob unter outputdir. Der Name lautet scriptID.xsd.
- Jeder Text aus den Original-Scripts wird in die neuen Eigenschaftendateien eingefügt, die sich im Verzeichnis blob unter outputdir befinden. Es werden eine Datei pro Script sowie eine Datei pro Seite generiert. Darüber hinaus wird eine Datei pro untergeordneter Seite hinzugefügt. Die Dateinamen lauten scriptID_version_type.properties oder scriptID_version_type_pageID.properties.
- Es werden unterschiedliche DMX-Dateien automatisch erstellt, sodass die generierten Artefakte einfach in die Datenbank eingefügt werden können. Die folgenden Dateien werden erstellt:
- APPRESOURCE.dmx
- Mit dieser DMX-Datei wird eine Zeile pro Eigenschaftendatei, die im Verzeichnis blob enthalten ist, in die Tabelle "AppResource" eingefügt. Jede Zeile besitzt eine Ressourcen-ID. Diese ID beginnt bei 0, sollte aber eindeutig sein, da sie ein Schlüssel zur Tabelle ist. Wenn Ihre Tabelle bereits Datensätze enthält, müssen Sie möglicherweise diese IDs manuell ändern, bevor Sie den Datenmanager ausführen können. So bleiben die IDs eindeutig. Die Eigenschaften gelten für die (leere) Standardländereinstellung.
- IEGSCRIPTINFO.dmx
- Mit dieser DMX-Datei werden das Script und die Definitionen der untergeordneten Scripts, die im Verzeichnis clob enthalten sind, in die Tabelle "IEGScriptInfo" eingefügt. Der Scriptname ist derselbe wie die Script-ID.
- IEGSCRIPTRELS.dmx
- Mit dieser DMX-Datei werden die Beziehungen zwischen den Scripts und den untergeordneten Scripts in die Tabelle "IEGScriptRels" eingefügt. Wenn kein untergeordnetes Script generiert wurde, enthält diese Datei keine Zeilen.
- DATASTORESCHEMA.dmx
- Mit dieser DMX-Datei wird das Datenspeicherschema, das im Verzeichnis clob enthalten ist, in die Tabelle "DatastoreSchema" eingefügt.
- Die vom System generierte Protokolldatei migration-log.txt enthält Informationen, Warnungen und Fehler, die beim Migrationsprozess aufgetreten sind. Diese Datei sollte nach dem Ausführen des Tools geprüft werden. Die Datei enthält unter anderem folgende Inhalte:
- INFO: Enthält Informationen zu den mit dem Tool durchgeführten Schritten, z. B. welche Scripts und untergeordneten Scripts migriert wurden, welche Dateien erstellt wurden usw.
- WARNING: Möglicherweise sind einige weitere manuelle Schritte notwendig, um die Scriptmigration abzuschließen oder einige Inhalte des alten Scripts können nicht in das neue Script eingefügt werden.
- SEVERE: Wenn während der Migration ein nicht vorhergesehenes Ereignis auftritt, finden Sie weitere Informationen zu diesem Problem hier.