La herramienta de migración puede ejecutarse desde la línea de comandos. En el directorio EJBServer, ejecute lo siguiente:
build migrateiegscript -Dscriptfilename=myscript.sx
-Dinputdir=C:\midir -Doutputdir C:\midir\output
Los tres parámetros siguientes son obligatorios:
- scriptfilename: el nombre del archivo de definición del script IEG reemplazado que se va a migrar, sin especificar su ubicación.
- inputdir: la vía de acceso completa al directorio donde están ubicados los artefactos IEG reemplazados a migrar. Contendrá la definición de script especificada en scriptfilename, y todos los grupos de preguntas y subscripts a los que hace referencia.
- outputdir: la vía de acceso completa al directorio donde se va a crear la nueva definición de artefactos. Si se ejecuta la herramienta varias veces, debería suprimirse el contenido para evitar sorpresas.
Los artefactos generados serán como se muestra a continuación:
- La nueva definición de script estará ubicada en el directorio clob, bajo outputdir. Se nombrará scriptID.xml utilizando el ID original del script. Los subscripts se encontrarán en la misma ubicación.
- El esquema de almacén de datos estará ubicado en el directorio clob, bajo outputdir. Se llamará scriptID.xsd.
- Todos los textos de los scripts originales se insertarán en nuevos archivos de propiedades ubicados en el directorio blob, bajo outputdir. Se generarán un archivo por script más un archivo por página. Asimismo, se añadirá un archivo por página de subscript. El nombre del archivo será IDscriptID_versión_tipo.properties o IDscript_versión_tipo_IDpágina.properties.
- Se crearán distintos archivos DMX de modo que los artefactos generados puedan insertarse fácilmente en una base de datos. Se crean los siguientes archivos:
- APPRESOURCE.dmx
- Este archivo DMX insertará en la tabla AppResource una fila por cada archivo de propiedades contenido en el directorio blob. Cada fila tiene un ID de recurso. Dicho ID empieza en 0 y debe ser exclusivo, ya que es clave de una tabla. Si la tabla ya contiene registros, es posible que tenga que cambiar los identificadores manualmente antes de ejecutar el gestor de datos a fin de que los identificadores sigan siendo exclusivos. Las propiedades serán para el entorno local predeterminado (vacío).
- IEGSCRIPTINFO.dmx
- Este archivo DMX insertará el script y las definiciones de subscripts contenidas en el directorio clob en la tabla IEGScriptInfo. El nombre de script será el mismo que el ID de script.
- IEGSCRIPTRELS.dmx
- Este archivo DMX insertará en la tabla IEGScriptRels las relaciones existentes entre el script y sus subscripts. Si no se ha producido ningún subscript, este archivo no contendrá ninguna fila.
- DATASTORESCHEMA.dmx
- Este archivo DMX insertará el esquema de almacén de datos contenido en el directorio clob en la tabla DatastoreSchema.
- Un archivo de anotaciones generado por el sistema denominado migration-log.txt contiene la información, los avisos y los errores generados durante el proceso de migración. Este archivo debería revisarse tras ejecutar la herramienta. Estos son los posibles contenidos de este archivo:
- INFO: proporciona información relativa a los pasos realizados por la herramienta, qué scripts y subscripts se han migrado, qué archivos se han creado.
- AVISO: puede que haya que completar algunos pasos manualmente para terminar la migración del script, o que parte del contenido del script antiguo no pueda introducirse en el nuevo script.
- GRAVE: si se produce algún suceso inesperado durante la migración, aquí podría encontrarse alguna información relativa al problema.