IBM WebSphere Development Studio Client para iSeries, Versión 6.0.1, Guía de migración

Contenido

iSeries: Preparación de la migración

Esta información describe cómo migrar los proyectos a WebSphere Development Studio Client para iSeries Versión 6.0.1 y WebSphere Development Studio Client Advanced Edition para iSeries Versión 6.0.1 desde versiones anteriores de IBM WebSphere Development Studio Client para iSeries. El producto da soporte a la migración desde las versiones 5.1 y 5.1.2. Esta guía también ofrece consejos acerca de la migración desde versiones anteriores.

La migración es necesaria en la mayoría de los casos debido a un cambio en la tecnología subyacente de un release a otro. Por ejemplo, nuevos estándares en la estructura de directorios de las aplicaciones Web pueden requerir la reorganización de los proyectos de un release a otro.

En general, la migración es fluida y transparente. Lo único que debe hacer es utilizar el área de trabajo existente y seguir trabajando con los proyectos en la nueva versión o nivel del producto. En casos raros, la migración es necesaria después de la aplicación de un paquete de servicio.

En algunos casos especiales relacionados con las herramientas Java, las herramientas Web y la personalización de proyectos WebFacing, puede que sea necesario utilizar una herramienta de migración o realizar tareas manuales adicionales.

En todos los casos, un mensaje le indicará cuándo es necesaria la migración.

La versión más reciente de este documento está disponible en la Web (ftp://ftp.software.ibm.com/as400/products/ad/wdt400/v601/migr/migrenu.html).

Tabla 1.

El archivo Readme contiene información sobre los prerrequisitos y las limitaciones del producto, así como información no incluida en la documentación. Para obtener información acerca de la instalación de WebSphere Development Studio Client para iSeries, consulte la guía de instalación.

Mantener más de una versión del producto

El proceso de instalación no desinstala automáticamente la versión 5.0, 5.1 o 5.1.2, sino que permite la coexistencia de las dos versiones en un solo sistema.

Antes de desinstalar Development Studio Client para iSeries Versión 5.0, 5.1 o 5.1.2, es aconsejable anotar la ubicación del área de trabajo de la Versión 5 y efectuar una copia de seguridad de ella. Si no realiza una copia de seguridad del área de trabajo, puede perder los proyectos de la Versión 5. (Por omisión, estos proyectos no se desinstalan ni suprimen).

En algunos casos, como por ejemplo en WebFacing, a partir de la versión 6.0.1, la migración de los proyectos de la versión 4.0 y 5.0 no está soportada, ya que pueden haberse añadido características adicionales a Development Studio Client. Consulte el apartado Migrar proyectos WebFacing para obtener más detalles.

Localizar el área de trabajo

Localizar el área de trabajo en la versión 5.1.2

Para buscar el área de trabajo de la versión 5.1.2:

Si aceptó la ubicación por omisión cuando instaló la Versión 5.1.2, el área de trabajo estará en el directorio X:\Documents & Settings\su_ID_usuario\Mis Documentos\IBM\wdsc\workspace, siendo X la unidad en la que se encuentra el directorio de instalación de Windows.
De lo contrario, busque un directorio denominado .metadata. Cada directorio workspace contiene un directorio metadata; en el directorio en el que aparece .metadata es generalmente el área de trabajo.
Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
1. En el entorno de trabajo de la versión 5.1.2 o 5.1, pase a la vista Navegador: pulse Ventana > Mostrar vista > Otras. Expanda Básico y seleccione Navegador. Pulse Aceptar.
2. Pulse el nombre del recurso con el botón derecho del ratón y seleccione Propiedades.
3. En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.

Localizar el área de trabajo en la versión 5.1

Para buscar el área de trabajo de la versión 5.1:

Si aceptó la ubicación por omisión cuando instaló la Versión 5.1, el área de trabajo estará en el directorio X:\Documents & Settings\su_ID_usuario\Mis Documentos\IBM\wdsc\workspace, siendo X la unidad en la que se encuentra el directorio de instalación de Windows.
De lo contrario, busque un directorio denominado .metadata. Cada directorio workspace contiene un directorio metadata; en el directorio en el que aparece .metadata es generalmente el área de trabajo.
Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
1. En el entorno de trabajo de la versión 5.1, pase a la vista Navegador: pulse Ventana > Mostrar vista > Otras. Expanda Básico y seleccione Navegador. Pulse Aceptar.
2. Pulse el nombre del recurso con el botón derecho del ratón y seleccione Propiedades.
3. En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.

Localizar el área de trabajo en la versión 5

Para buscar el área de trabajo de la versión 5:

Si aceptó la ubicación por omisión cuando instaló la Versión 5, el área de trabajo estará en el directorio X:\Documents & Settings\su_ID_usuario\Mis Documentos\IBM\wdsc\workspace, siendo X la unidad en la que se encuentra el directorio de instalación de Windows.
De lo contrario, busque un directorio denominado .metadata. Cada directorio workspace contiene un directorio metadata; en el directorio en el que aparece .metadata es generalmente el área de trabajo.
Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
1. En el entorno de trabajo de la versión 5, pase a la vista Navegador: pulse Ventana > Mostrar vista > Otras. Expanda Básico y seleccione Navegador. Pulse Aceptar.
2. Pulse el nombre del recurso con el botón derecho del ratón y seleccione Propiedades.
3. En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.

Localizar el área de trabajo en la versión 4

Para buscar el área de trabajo de la versión 4:

Si aceptó la ubicación por omisión cuando instaló la versión 4.0, el área de trabajo estará en el directorio X:\WDSC\WSSD\workspace, siendo X la unidad en la que ha instalado el producto.
Si no es así, busque (desde el menú Inicio) un directorio llamado .metadata; en cada directorio workspace hay un directorio metadata. Una vez localizado un directorio .metadata, compruebe el directorio en el que aparece; ese directorio puede ser su área de trabajo.
Para buscar la ubicación de un recurso individual, como por ejemplo un proyecto (en esta guía obtendrá más información acerca de la migración de diferentes tipos de proyectos):
1. En el entorno de trabajo de la versión 4.0, pase a la vista Navegador: pulse Perspectiva > Mostrar vista > Otras. Expanda Básico y seleccione Navegador. Pulse Aceptar.
2. Pulse el nombre del recurso con el botón derecho del ratón y seleccione Propiedades.
3. En el panel de la izquierda, pulse Información.
La ubicación del recurso aparece en el panel de la derecha.

Especificar el área de trabajo postinstalación

Cuando inicia el producto Versión 6.0 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abre una ventana de Workspace Launcher en la que debe especificar el directorio que hay que utilizar para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 5.1 o 5.1.2.
Cuando se le pida que confirme que desea convertir al formato del área de trabajo nueva, pulse Aceptar.

Buscar otra información importante

Si desea información específica sobre cómo puede verse afectada el área de trabajo o los proyectos actuales debido a la migración a Versión 6.0, lea los apartados pertinentes de la guía de migración suministrada junto con el producto base Rational Software Developer Platform. La ubicación de la guía depende de qué edición de WebSphere Development Studio Client para iSeries tenga en el sistema.

Si tiene la edición avanzada, la Guía de migración de Rational Application Developer es migrate.html o migrate.pdf en el directorio rad del CD 1.
Si tiene la edición estándar, la Guía de migración de Rational Web Developer es migrate.html o migrate.pdf en el directorio rwd del CD 1.

Suponiendo que haya instalado el producto en su ubicación por omisión, la guía también estará disponible después de la instalación en, por ejemplo:

C:\Program Files\IBM\Rational\SDP\6.0\radi_prod\migrate.html
C:\Program Files\IBM\Rational\SDP\6.0\rwdi_prod\migrate.html

También puede encontrar información nueva adicional y documentos de soporte técnico acerca de la migración de proyectos de WebSphere Development Studio Client para iSeries en la Web.

iSeries: Migrar tipos de proyectos específicos

Cuando esté preparado para migrar el área de trabajo V5.1.x, inicie WebSphere Development Studio Client para iSeries con el área de trabajo antigua. Un indicador de progreso confirmará que los proyectos se estén migrando automáticamente.

Notas: Durante la migración del área de trabajo, se abrirá un diálogo de problemas con el mensaje No se ha podido restaurar el diseño del entorno de trabajo. Razón: Se han producido problemas al restaurar el entorno de trabajo. Los mensajes de error no tienen ninguna influencia sobre la migración satisfactoria del área de trabajo. Observe el nombre de la perspectiva que no ha podido restaurarse pulsando el botón Detalles del recuadro de diálogo de errores y luego pulse Aceptar para cerrarlo.

Para restaurar la perspectiva:

Cierre la perspectiva seleccionando Ventana -> Cerrar perspectiva.
Vuelva a abrir la perspectiva seleccionando Ventana -> Abrir perspectiva.

Las secciones que siguen describen los pasos necesarios para solucionar los problemas de migración correspondientes a los diferentes tipos de proyectos de WebSphere Development Studio Client para iSeries.

Migrar proyectos con archivos generados por los asistentes Páginas Web de base de datos y Páginas Web de bean Java

Los archivos generados requieren un paquete Java para el JDK 1.4.

Debe especificar un paquete Java al trabajar con proyectos que contienen páginas y archivos .java que se han generado con los asistentes Páginas Web de base de datos y Páginas Web de bean Java sin especificar un paquete durante la creación. Con respecto al código generado anteriormente, mueva los archivos .java a un paquete. A continuación, actualice los archivos JSP, actualice las sentencias de importación y la información de clases. En el archivo web.xml del proyecto, actualice la entrada de clase de servlet.

Migrar beans de llamada a programa

Migrar beans de llamada a programa de proyectos Java y Web de iSeries desde la Versión 5.1 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.1 o 5.1.2.

En Versión 6.0.1, el asistente Llamada a programa coloca el archivo PCML de un bean de llamada a programa en el paquete de beans. Esto representa un cambio con respecto a las versiones anteriores. Si vuelve a crear un bean de llamada a programa a partir de un archivo PCML existente que no se encuentra en el paquete de beans, puede suprimir este archivo PCML una vez que el asistente haya finalizado la recreación del bean de llamada a programa.

Nota:

En la versión 6.0.1, puede crear un servicio Web de programa iSeries fuera del código fuente ILE RPG o COBOL o de los archivos PCML utilizando directamente el asistente Servicio Web. No es necesario ejecutar el asistente Llamada a programa y el asistente Servicio Web.

Migrar beans de llamada a programa de un proyecto Java

Cuando inicia el producto Versión 6.0.1 ( Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abre una ventana de Workspace Launcher en la que debe especificar el directorio que hay que utilizar para la sesión. Especifique la ubicación del directorio del área de trabajo de la versión 5.x.
Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
2. En el panel de la izquierda, seleccione Vía de construcción Java.
3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:
```
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.1.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.1.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.1.3/xercesImpl.jar/
j2ee.jar
```
4. Vuelva a ejecutar el asistente Llamada a programa en todos los archivos PCML. Si está utilizando un paquete por omisión, debe especificar un nombre de paquete en la versión 6.0.1. Los beans Java y el archivo PCML que acaba de generar se encontrarán en el paquete especificado; puede suprimir los beans Java y el archivo PCML antiguos del paquete por omisión.

Migrar beans de llamada a programa de un proyecto Web

Si usted es usuario de un bean de servicio de llamada a programa, debe saber que en Versión 6.0.1 el asistente Llamada a programa siempre genera un archivo .config. Puede tratarse de un archivo especificado por usuario o del archivo por omisión, defaultPCW.config. Debe dejar de utilizar el asistente Configuración de entorno de ejecución. Para los proyectos Web anteriores a la Versión 6.0.1, el paso de migración de proyectos de herramientas Web indicado más delante obtendrá información del archivo web.xml del proyecto y creará automáticamente un archivo defaultPCW.config si aún no existe. A partir de ese punto, la configuración de entorno de ejecución de la llamada a programa se basará en los datos del archivo .config, en lugar de en el archivo web.xml.

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 5.1 o 5.1.2.
Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
(Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
Suprima iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib.
Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML. El bean de servicio nuevo y los archivos PCML se crearán en el paquete especificado. Suprima los archivos PCML antiguos del proyecto Web.
Vuelva a ejecutar el asistente Servicio Web en el bean de servicio.

El código generado por el asistente Servicios Web requiere migración y limpieza manuales. Esta migración sólo se aplica a los propios beans de servicio Web. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.

Migrar beans de llamada a programa de proyectos Java y Web de iSeries de la Versión 5.0 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.0.

Nota:

Migrar beans de llamada a programa de un proyecto Java

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 5.0.
Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
2. En el panel de la izquierda, seleccione Vía de construcción Java.
3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:
```
WDSC_HOME/plugins/com.ibm.etools.iseries.toolbox_5.0.0/runtime/jt400.jar
WDSC_HOME/plugins/com.ibm.etools.iseries.webtools_5.0.0/lib/iwdtrt.jar
WDSC_ECLIPSE_HOME/plugins/org.apache.xerces_4.0.7/xercesImpl.jar/
j2ee.jar
```
4. Vuelva a ejecutar el asistente Llamada a programa en todos los archivos PCML. En la página Configurar autenticación del asistente, deseleccione la opción Generar archivo de configuración.

Migrar beans de llamada a programa de un proyecto Web

Las secciones que siguen describen cómo migrar el contenido de la carpeta de contenido Web, el código fuente Java y las carpetas del proyecto Web.

Para migrar el contenido de la carpeta de contenido Web:

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
Pase a la perspectiva Recursos.
Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 5.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 5.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión Web Content) del proyecto Web 5.0 existente. Pulse Aceptar.
Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 5.0.

Para migrar el contenido de la carpeta de código fuente Java:

Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: Java Source) del proyecto Web 5.0 existente. Pulse Aceptar.
Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 5.0.

Para migrar el contenido de la carpeta de proyecto Web:

Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 5.0 existente.
Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 5.0.

(Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
Suprima iwdtrt.jar y jt400.jar de la carpeta WEB-INF\lib.
Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.

Esta migración sólo se aplica a los propios beans de servicio. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.

Migrar beans de llamada a programa de proyectos Java y Web de iSeries de la Versión 4.0 a Versión 6.0.1

Esta sección describe cómo migrar a Versión 6.0.1 beans de llamada a programa creados en Development Studio Client para iSeries Versión 4.0.

Nota:

Migrar beans de llamada a programa de un proyecto Java

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá una ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana, especifique la ubicación del directorio del área de trabajo de la Versión 4.0.
Cuando se le solicite que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
Elimine los archivos .jar de tiempo de ejecución cambiando la vía de construcción Java del proyecto:
1. Pulse el proyecto Java con el botón derecho del ratón y seleccione Propiedades.
2. En el panel de la izquierda, seleccione Vía de construcción Java.
3. Seleccione la pestaña Bibliotecas; luego seleccione los siguientes archivos JAR y pulse Eliminar para eliminarlos de la vía de acceso de clases:
```
   ECLIPSE_HOME/plugins/com.ibm.etools.iseries.toolbox/runtime/jt400.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.iseries.webtools/lib/wdt400rt.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/j2ee.jar
   ECLIPSE_HOME/plugins/com.ibm.etools.websphere.runtime/lib/xerces.jar
```
Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML. En la página Configurar autenticación del asistente, deseleccione la opción Generar archivo de configuración.

Esta migración sólo se aplica a los propios beans de llamada a programa. El código generado por el asistente Llamada a programa requiere migración y limpieza manuales.

Migrar beans de llamada a programa de un proyecto Web

Para migrar el contenido de la carpeta de contenido Web:

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
Pase a la perspectiva Recursos.
Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 4.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 4.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión webApplication) del proyecto Web 4.0 existente. Pulse Aceptar.
Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 4. 0.

Para migrar el contenido de la carpeta de código fuente Java:

Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: source) del proyecto Web 4.0 existente. Pulse Aceptar.
Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 4.0.

Para migrar el contenido de la carpeta de proyecto Web:

Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 4.0 existente.
Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 4.0.

(Paso opcional: utilice el asistente Migración J2EE para migrar desde el nivel de J2EE 1.2 a un nivel superior de J2EE).
Suprima wdt400rt.jar y wdt400tb.jar de la carpeta WEB-INF\lib.
Vuelva a ejecutar el asistente de llamada a programa en todos los archivos PCML.
Esta migración sólo se aplica a los propios beans de servicio.

A partir de la Versión 5.1, los beans deben generarse en un paquete con nombre antes de invocar el asistente Servicios Web. El código generado por el asistente Servicios Web requiere migración y limpieza manuales.

Esta migración sólo se aplica a los propios beans de servicio Web. Consulte las secciones de servicios Web de la guía de migración suministrada con el producto base Rational Software Developer Platform (consulte Buscar otra información importante para obtener enlaces a esta guía) para obtener información acerca de la migración de los servicios Web.

Migrar proyectos WebFacing

La versión 6.0.1 de IBM WebFacing Tool ofrece extensiones para la interoperabilidad con aplicaciones 5250 que no se hayan habilitado para la Web. Estas aplicaciones 5250 se ejecutan en un navegador, pero están obligadas a utilizar sólo dos conexiones de entorno de ejecución a efectos de prueba. Para desplegar aplicaciones interoperativas en producción, debe adquirir IBM WebFacing Deployment Tool para WebSphere Development Studio versión 6.0.1 (5725-N52).

Importante:

A partir de WebSphere Development Studio Client para iSeries Versión 6.0.1, la migración de proyectos WebFacing 4.0 y 5.0 ya no está soportada. Consulte Utilizar el asistente de importación de WebFacing y los documentos de soporte técnico de IBM para obtener información acerca de la migración de proyectos a la versión 6.0.1.

Si tiene un área de trabajo que se haya creado mediante versiones 5.1 o posteriores, puede abrirla utilizando la versión 6.0.1, y los proyectos WebFacing pueden ejecutarse tal cual. Sin embargo, la visualización del proyecto puede ser incompleta. Por ejemplo, los archivos JSP de registro y algunos archivos de estilo de algunos releases anteriores no aparecen en una vista de árbol de Versión 6.0.1 hasta que se reconvierten los proyectos. La primera vez que convierta un archivo DDS, la estructura de proyectos se actualizará para reflejar el nuevo diseño que se ha establecido en la versión 5.1.2. Por ejemplo, se importan los nuevos archivos de plantilla y archivos jar de entorno de ejecución. Esta operación se produce de la misma forma que si se importara el proyecto mediante el asistente Importar.

Utilizar el asistente de importación de WebFacing

Si tiene proyectos WebFacing de WebSphere Development Studio Client Versión 5.1.x o posterior, puede migrarlos a WebSphere Development Studio Client para iSeries Versión 6.0.1 mediante el asistente de importación. Siga estos pasos:

Seleccione Archivo > Importar.
Elija Proyectos WebFacing. Pulse Siguiente.
Pulse Examinar para ir a la carpeta que contiene los proyectos WebFacing que desea migrar a Versión 6.0.1. Pulse Siguiente.
Nota:
Cuando actualiza a Versión 6.0.1, los proyectos WebFacing siguen estando disponibles en el directorio workspace original.
- Si migra desde Development Studio Client 5.1 o 5.1.2, consulte las secciones referentes a la localización del área de trabajo contenidas en el apartado Mantener más de una versión del producto.
Los proyectos WebFacing que encuentre el asistente figurarán en el panel Proyectos WebFacing encontrados. Seleccione los proyectos que desea importar. El asistente creará un archivo EAR del proyecto. Los archivos EAR son archivos de archivado de aplicación de empresa J2EE. Por omisión, el archivo EAR utiliza el nombre del proyecto WebFacing y añade el sufijo _EAR al nombre. Si desea utilizar un nombre distinto o si se propone consolidar varios proyectos en un solo archivo EAR, puede cambiar el nombre en el campo Proyecto de aplicación de empresa.
Pulse Finalizar para migrar el proyecto al área de trabajo de Versión 6.0.1.
Para ver el proyecto en la perspectiva WebFacing, seleccione Ventana > Abrir perspectiva > WebFacing.

Pasos manuales si el proyecto tiene archivos personalizados

Los archivos originales tienen nombres nuevos con el siguiente formato: nombre_archivo +_601_bak.

Si ha personalizado el proyecto WebFacing, puede que sea necesario fusionar las personalizaciones de los archivos originales en los siguiente archivos:

PageBuilder.jsp
CmdKeys.jsp
logon.jsp
index.html
Si el proyecto anterior estaba habilitado para Struts, deben actualizarse los archivos de configuración de Struts (struts-config.xml).
Si el proyecto anterior utilizaba Web Site Designer, deben actualizarse los siguientes archivos:
- \WebContent\index.jsp
- \WebContent\INV1.jsp
- \WebContent\INV2.jsp
- \WebContent\theme\WFB_blue.jtpl

Migrar los proyectos Web de iSeries

Para migrar proyectos Web de iSeries pueden utilizarse los siguientes métodos:

Migrar proyectos Web de iSeries utilizando un área de trabajo existente de WebSphere Development Studio Client Versión 5.1.x
Esta migración implica la utilización del área de trabajo existente en el entorno de trabajo de Versión 6.0.1 y la ejecución de la rutina de migración de las herramientas Web de iSeries.
Migrar proyectos Web de iSeries utilizando un proyecto existente de WebSphere Development Studio Client Versión 5.0
Esta migración implica la importación de contenido del proyecto del sistema de archivos y, a continuación, la ejecución de la rutina de migración de herramientas Web de iSeries.
Migrar proyectos Web de iSeries utilizando un proyecto existente de WebSphere Development Studio Client Versión 4.0
Esta migración implica la importación de contenido del proyecto del sistema de archivos y, a continuación, la ejecución de la rutina de migración de herramientas Web de iSeries.

Importante:

Asegúrese de que todas las instancias de servidor se hayan detenido antes de proceder a la migración.

Migrar proyectos Web de iSeries de la Versión 5.1.x a Versión 6.0.1

La información que sigue describe cómo migrar proyectos Web de iSeries desde Development Studio Client para iSeries Versión 5.1.x a WebSphere Development Studio Client para iSeries Versión 6.0.1.

Las actividades de migración constan de las siguientes etapas:

Migrar los proyectos utilizando un área de trabajo existente en 5.1.x
Migrar el contenido del proyecto Web de iSeries
Resolver los errores y los avisos generados a causa de la migración

Paso 1: Migrar los proyectos utilizando un área de trabajo existente 5.1.x

En Versión 6.0.1, los nombres por omisión de las carpetas de contenido Web y de código fuente Java para nuevos proyectos Web pueden configurarse por medio de una página de preferencias. Los nombres por omisión son ahora WebContent y JavaSource. Estos nombres por omisión se utilizarán sólo para nuevos proyectos Web. Los proyectos Web creados en versiones anteriores a Versión 6.0.1 seguirán utilizando los nombres antiguos.

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana Rational Software Developer Platform, en la que especificará el directorio que debe utilizarse para la sesión. En esta ventana especifique la ubicación del directorio del área de trabajo de la versión 5.1.x.
Si se le solicita que confirme que desea convertir al formato de la nueva interfaz de usuario, pulse Aceptar.
Opcional: En el menú principal, pulse Ventana > Preferencias. En el panel de la izquierda, expanda Herramientas Web y seleccione Proyecto J2EE nuevo. En el panel derecho, establezca las preferencias de los nombres de carpeta por omisión.

Puede cambiar manualmente los nombres de carpeta fuente de los proyectos 5.1.x en Versión 6.0.1 pulsando el nombre de carpeta con el botón derecho del ratón en la vista Explorador de proyectos, seleccionando Propagar y pulsando Redenominar. La acción Redenominar cambia los nombres de carpeta y arregla la vía de acceso de construcción Java de los proyectos Web 5.1.x. Si opta por redenominar los nombres de las carpetas JavaSource y WebContent en Versión 6.0.1, deberá actualizar manualmente los scripts de construcción automatizada con los nombres de carpeta nuevos.

Opcional: Convertir proyectos Web a Struts 1.1

Si ha creado proyectos Web Struts 1.1 Beta 2 en IBM WebSphere Studio Application Developer Versión 5, puede convertirlos a Struts 1.1, aunque no es necesario, ya que Struts 1.1 Beta 2 sigue estando soportado.

Si tiene proyectos Web Struts 1.1 Beta 2 que desea convertir a Struts 1.1:

Cree un proyecto Web Struts 1.1 denominado Struts11. Esto suministrará un acceso adecuado a los artefactos de Struts 1.1 que serán necesarios al convertir los proyectos reales. Puede suprimir este proyecto cuando haya terminado.
Para cada proyecto Struts 1.1 Beta 2 que desee convertir a Struts 1.1, haga lo siguiente:
1. Suprima los siguientes archivos .jar del directorio Web Content/WEB-INF/lib del proyecto: commons-*.jar y struts.jar.
2. Copie los siguientes archivos .jar del directorio Struts11/WebContent/WEB-INF/lib en el directorio Web Content/WEB-INF/lib del proyecto: commons-*.jar y struts.jar.
3. Suprima los siguientes archivos .tld del directorio Web Content/WEB-INF del proyecto: struts-*.tld.
4. Copie los siguientes archivos .tld del directorio Struts11/WebContent/WEB-INF en el directorio Web Content/WEB-INF del proyecto: struts-*.tld.

Paso 2: Migrar el contenido del proyecto Web de iSeries

Para migrar el contenido del proyecto de herramientas Web de iSeries:

Pulse el nombre del proyecto con el botón derecho del ratón en la vista Navegador de proyectos de la perspectiva Web y seleccione Propiedades. Seleccione Características de proyecto Web en el panel izquierdo. En la lista Características de proyecto Web disponibles, seleccione Struts si aún no está seleccionado. Pulse Aceptar. Pulse Finalizar en la ventana Características de proyecto Web para aceptar la versión de Struts por omisión (1.1).
Nota:

Si se salta este paso, aparecerá una ventana que solicita la adición del soporte de Struts.
Importante: en este momento, cierre el proyecto y vuelva a abrirlo para evitar que se produzca una excepción relacionada con la supresión de recursos y para asegurarse de que el proyecto no se esté ejecutando en ningún servidor.
Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva Web y seleccione Migrar > Proyecto de herramientas Web de iSeries. La ventana Confirmar migración indica que se migrará la estructura y el contenido del proyecto.
Para seguir realizando el proceso, pulse Aceptar. La ventana Información de progreso muestra el progreso de la migración.
Cuando la migración haya finalizado, un mensaje indicará el resultado.
Si el proceso de migración se ha llevado a cabo satisfactoriamente, no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con errores o avisos, continúe en el apartado Paso 3: Resolver los errores y avisos generados como resultado de la migración.
El proceso de migración lleva a cabo las acciones siguientes:
- Actualiza los componentes Web de iSeries, las bibliotecas de códigos y los archivos JavaScript (actualizando todos los archivos JSP de acuerdo con ello).
- Vuelve a generar los archivos relacionados con interacciones Web basándose en la infraestructura de Struts desde los archivos .wit, y actualiza los archivos de ejecución de las interacciones Web.
- Añade soporte para la nueva función de herramientas Web de iSeries disponible en Versión 6.0.1.

Paso 3: Resolver los errores y avisos generados como resultado de la migración

Si surgen problemas en el proceso de migración, se abre una ventana que indica que se han producido errores o avisos. También se abre el archivo de anotaciones de migración que describe los problemas, nombreProyecto_MigrationDetails.txt, que se encuentra bajo el nombre del proyecto en la perspectiva Web.

La sección de resultados de la migración situada en la parte superior del archivo de anotaciones de migración indica el estado global de la migración y hace referencia a una versión en línea de la tabla de avisos y errores que figura más adelante, con descripciones y acciones correctivas. Consulte Mensajes de aviso y error para la migración de proyectos Web.

Migrar proyectos Web de iSeries de la Versión 5.0 a Versión 6.0.1

La información que sigue describe cómo migrar proyectos Web de iSeries desde Development Studio Client para iSeries Versión 5.0 a WebSphere Development Studio Client para iSeries Versión 6.0.1.

Las actividades de migración constan de las siguientes etapas:

Migrar proyectos mediante un proyecto Web 5.0 existente en el sistema de archivos
Migrar el contenido del proyecto Web de iSeries
Resolver los errores y los avisos generados a causa de la migración

Paso 1: Migrar un proyecto 5.0 existente en el sistema de archivos a la versión 6.0.1

Para migrar el contenido de la carpeta de contenido Web:

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
Pase a la perspectiva Recursos.
Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 5.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 5.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión: Web Content) del proyecto Web 5.0 existente. Pulse Aceptar.
Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:
- \WebContent\WEB-INF\struts-*.tld
- \WebContent\WEB-INF\lib\struts.jar
- \WebContent\WEB-INF\lib\commons-*.jar
- \WebContent\WEB-INF\lib\jdbc2_0-stdext.jar
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 5.0.

Para migrar el contenido de la carpeta de código fuente Java:

Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: Java Source) del proyecto Web 5.0 existente. Pulse Aceptar.
Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 5.0.

Para migrar el contenido de la carpeta de proyecto Web:

Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 5.0 existente.
Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 5.0.

Eliminar artefactos Struts de nivel antiguo

Pulse WebContent/WEB-INF/web.xml con el botón derecho del ratón. Seleccione Abrir con > Editor del descriptor de despliegue.
Vaya a la pestaña Servlets.
Elimine la entrada Servlet que se correlaciona con la clase de servlet org.apache.struts.action ActionServlet, nombre por omisión action.

Paso 2: Migrar el contenido del proyecto Web de iSeries

Para migrar el contenido del proyecto de herramientas Web de iSeries:

Pulse el nombre del proyecto con el botón derecho del ratón en la vista Navegador de proyectos de la perspectiva Web y seleccione Propiedades. Seleccione Características de proyecto Web en el panel izquierdo. En la lista Características de proyecto Web disponibles, seleccione Struts si aún no está seleccionado. Pulse Aceptar. Pulse Finalizar en la ventana Características de proyecto Web para aceptar la versión de Struts por omisión (1.1).
Nota:

Si se salta este paso, aparecerá una ventana que solicita la adición del soporte de Struts.
Importante: en este momento, cierre el proyecto y vuelva a abrirlo para evitar que se produzca una excepción relacionada con la supresión de recursos y para asegurarse de que el proyecto no se esté ejecutando en ningún servidor.
Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva Web y seleccione Migrar > Proyecto de herramientas Web de iSeries. La ventana Confirmar migración indica que se migrará la estructura y el contenido del proyecto.
Para seguir realizando el proceso, pulse Aceptar. La ventana Información de progreso muestra el progreso de la migración.
Cuando la migración haya finalizado, un mensaje indicará el resultado.
Si el proceso de migración se ha llevado a cabo satisfactoriamente, no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con errores o avisos, continúe en el apartado Paso 3: Resolver los errores y avisos generados como resultado de la migración.
El proceso de migración lleva a cabo las acciones siguientes:
- Actualiza los componentes Web de iSeries, las bibliotecas de códigos y los archivos JavaScript (actualizando todos los archivos JSP de acuerdo con ello).
- Vuelve a generar los archivos relacionados con interacciones Web basándose en la infraestructura de Struts desde los archivos .wit, y actualiza los archivos de ejecución de las interacciones Web.
- Añade soporte para la nueva función de herramientas Web de iSeries disponible en Versión 6.0.

Paso 3: Resolver los errores y avisos generados como resultado de la migración

Sólo para la migración de 5.0.x, además de los avisos de migración que aparecen en el archivo de anotaciones, debe tener en cuenta que el atributo de longitud máxima (maxLength) ya no está soportado para el componente Web de entrada de texto. Esto puede afectar al aspecto visual de las páginas Web.

Migrar proyectos Web de iSeries de la versión 4.0 a Versión 6.0.1

La información que sigue describe cómo migrar proyectos Web de iSeries desde Development Studio Client para iSeries Versión 4.0 a WebSphere Development Studio Client para iSeries Versión 6.0.1.

Las actividades de migración constan de las siguientes etapas:

Migrar proyectos mediante un proyecto Web 4.0 existente en el sistema de archivos
Migrar el contenido del proyecto Web de iSeries
Resolver los errores y los avisos generados a causa de la migración

Paso 1: Migrar un proyecto 4.0 existente en el sistema de archivos a la versión 6.0.1

Para migrar el contenido de la carpeta de contenido Web:

Cuando inicie el producto Versión 6.0.1 (Inicio > Programas > IBM Rational > WebSphere Development Studio Client para iSeries), se abrirá la ventana de lanzador de área de trabajo (Workspace Launcher) en la que especificará el directorio que debe utilizarse para la sesión. Utilice la ubicación por omisión como área de trabajo.
Pase a la perspectiva Recursos.
Cree un proyecto Web dinámico con el mismo nombre y versión de servlet que el proyecto Web 4.0 existente. Para encontrar la versión de servlet, busque en el archivo .websettings del proyecto 4.0 existente y busque el código jsp-level. Si el nivel de jsp es 1.2, establezca la versión de servlet en 2.3; de lo contrario, establézcala en 2.2. Pulse Finalizar. No cambie a la perspectiva Web cuando se le solicite.
Seleccione la carpeta de contenido Web del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de contenido Web (nombre por omisión webApplication) del proyecto Web 4.0 existente. Pulse Aceptar.
Seleccione la carpeta de contenido Web, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de contenido Web, pero no la carpeta de contenido Web en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de contenido Web del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de contenido Web 4. 0.

Para migrar el contenido de la carpeta de código fuente Java:

Seleccione la carpeta de código fuente Java del proyecto recién creado, púlsela con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione la carpeta de código fuente Java (nombre por omisión: source) del proyecto Web 4.0 existente. Pulse Aceptar.
Seleccione la carpeta de código fuente Java, pero no marque el recuadro. Pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de código fuente Java, pero no la carpeta de código fuente Java en sí.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de código fuente Java del proyecto recién creado debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de código fuente Java 4.0.

Para migrar el contenido de la carpeta de proyecto Web:

Ahora seleccione el proyecto recién creado, púlselo con el botón derecho del ratón y seleccione Importar en el menú de contexto.
Elija Sistema de archivos como origen de importación y pulse Siguiente. Pulse el botón Examinar y seleccione el proyecto Web 4.0 existente.
Seleccione la carpeta de proyecto en el panel izquierdo y pulse Seleccionar todo. En el panel derecho, deseleccione uno de los archivos y luego vuelva a seleccionarlo. En el panel izquierdo, deseleccione las carpetas de contenido Web y de código fuente Java. Esto hará que se importen todos los elementos que se encuentran bajo la carpeta de proyecto Web, excepto las carpetas de contenido Web y de código fuente Java y la carpeta de proyecto Web en sí.
En el panel derecho, deseleccione los siguientes archivos si aparecen en la lista:
- \WebContent\.classpath
- \WebContent\.project
- \WebContent\.websettings
- \WebContent\.serverPreference
Estos archivos contienen información acerca del proyecto, que es necesaria durante el diseño. La información no puede migrarse a la Versión 6.0.1, por lo que los archivos volverán a crearse cuando sea necesario.
Seleccione las opciones Crear sólo carpetas seleccionadas y Sobreescribir recursos existentes sin avisar y pulse Finalizar. La carpeta de proyecto Web recién creada debe contener ahora unos recursos y una estructura de carpetas similares a los de la carpeta de proyecto Web 4.0.

Paso 2: Migrar el contenido del proyecto Web de iSeries

Para migrar el contenido del proyecto de herramientas Web de iSeries:

Pulse el nombre del proyecto con el botón derecho del ratón en la vista Navegador de proyectos de la perspectiva Web y seleccione Propiedades. Seleccione Características de proyecto Web en el panel izquierdo. En la lista Características de proyecto Web disponibles, seleccione Struts si aún no está seleccionado. Pulse Aceptar. Pulse Finalizar en la ventana Características de proyecto Web para aceptar la versión de Struts por omisión (1.1).
Nota:

Si se salta este paso, aparecerá una ventana que solicita la adición del soporte de Struts.
Importante: en este momento, cierre el proyecto y vuelva a abrirlo para evitar que se produzca una excepción relacionada con la supresión de recursos y para asegurarse de que el proyecto no se esté ejecutando en ningún servidor.
Pulse el nombre del proyecto con el botón derecho del ratón en la perspectiva Web y seleccione Migrar > Proyecto de herramientas Web de iSeries. La ventana Confirmar migración indica que se migrará la estructura y el contenido del proyecto.
Para seguir realizando el proceso, pulse Aceptar. La ventana Información de progreso muestra el progreso de la migración.
Cuando la migración haya finalizado, un mensaje indicará el resultado.
Si el proceso de migración se ha llevado a cabo satisfactoriamente, no hay que hacer nada más. Si el proceso de migración se ha llevado a cabo con errores o avisos, continúe en el apartado Paso 3: Resolver los errores y avisos generados como resultado de la migración.
El proceso de migración lleva a cabo las acciones siguientes:
- Actualiza los componentes Web de iSeries, las bibliotecas de códigos y los archivos JavaScript (actualizando todos los archivos JSP de acuerdo con ello).
- Vuelve a generar los archivos relacionados con interacciones Web basándose en la infraestructura de Struts desde los archivos .wit, y actualiza los archivos de ejecución de las interacciones Web.
- Añade soporte para la nueva función de herramientas Web de iSeries disponible en Versión 6.0.

Paso 3: Resolver los errores y avisos generados como resultado de la migración

Consideraciones adicionales acerca de la migración

Además de los errores de migración que aparecen en el archivo de anotaciones descrito anteriormente, es necesario tener en cuenta los siguientes aspectos, cuando proceda:

Asegúrese de restaurar una versión nueva del programa de servicio de subarchivo QDTSSFL en el sistema principal iSeries. Este programa de servicio es necesario para manipular el espacio de usuarios de subarchivo con las API de subarchivo. Para obtener instrucciones acerca de cómo restaurar el programa de servicio, consulte el tema "Programa de servicio de subarchivo QDTSSFL" de la ayuda. Pulse Ayuda > Contenido de la ayuda y luego pulse Consulta > Consulta de interfaces de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > API de subarchivo.
La matriz de formato de datos devuelta desde un programa de sistema principal para un componente Web de tipo recuadro combinado puede expresarse ahora en dos formatos. Como resultado, puede que sea necesario cambiar el programa a fin de obtener el resultado de formato de datos deseado en el recuadro combinado. Para obtener más información acerca de los formatos de datos, consulte la sección "Pestaña Datos" de la ayuda en línea, que se encuentra en Consulta > Consulta de interfaces de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > Componente Web de recuadro combinado.

Además de los avisos de migración que aparecen en el archivo de anotaciones descrito en el Paso 4, es necesario tener en cuenta los siguientes cambios, que pueden afectar al aspecto visual de las páginas Web:

Las siguientes propiedades de control de tiempo de diseño (DTC) de tabla ya no están soportadas en el componente Web de tabla equivalente:
- Relleno de celdas
- Espaciado de celdas
- Tamaño de borde
- Alineación
- Anchura de tabla
- Altura de tabla
Las propiedades Color de primer plano de casilla y Color de fondo de casilla de un DTC de tabla no se aplican individualmente a los colores de columna de un componente Web de tabla. El color utilizado para todas las columnas es el que se ha definido para la primera columna de la tabla.
Las propiedades Anchura visible, Bloqueo de mayúsculas y Sólo lectura asociadas con una columna Campo de entrada en un DTC de tabla no están soportadas en la columna equivalente Entrada de texto de un componente Web de tabla.
Los botones Retroceso página, Avance página y Columna de selección del DTC de subarchivo no están soportados en el componente Web de tabla equivalente.
Los valores de nombre de campo especificados en los DTC se migran a los valores de nombre de los componentes Web equivalentes. Todos los puntos (el carácter .) se sustituyen por subrayados (el carácter _) en el valor Nombre. Asimismo, el primer carácter del nombre de campo de un DTC puede convertirse a minúsculas en el valor de nombre del componente Web equivalente.
Ya no es posible cambiar un atributo de componente Web durante la ejecución cuando se produce una condición especificada. Si ha utilizado la pestaña de atributos de tiempo de ejecución de DTC para definir una condición que, cuando se cumple, cambia un atributo de DTC durante la ejecución (por ejemplo, un cambio del cuerpo de font), el atributo de componente Web correspondiente ya no cambia cuando se produce esta condición.

Mensajes de aviso y error para la migración de proyectos Web

Código de error	Descripción	Acción
E100	Se ha producido un error indeterminado durante la migración del archivo JSP.	Resuelva todos los demás errores o avisos del archivo de anotaciones de migración y ejecute de nuevo la herramienta de migración.
E101	Un componente Web de iSeries del archivo JSP contiene un error.	Resuelva el error del componente Web de iSeries.
E200	El proceso del archivo .wit ha provocado un error indeterminado.	Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. Pase por todas las páginas del asistente y efectúe los cambios necesarios. Pulse Finalizar.
E201	Uno o varios de los nombres de componente Web definidos en las páginas utilizadas en esta interacción no son válidos.	Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. Se abrirá una ventana que indicará que los nombres de componentes Web no son válidos y le solicitará si desea cambiarlos. Pulse Sí. Efectúe los cambios necesarios. Para los componentes Web que tengan parámetros de entrada o salida de cambios, complete las opciones Nombre en sesión, Guardar en sesión y Enlace. Pase por todas las páginas del asistente y efectúe los cambios necesarios. Pulse Finalizar.
E202	Un parámetro de salida definido en esta interacción tiene el valor de "Indicador de mensajes" establecido en true. El manejo avanzado de mensajes ha cambiado significativamente en este release. Debe redefinir las opciones de Manejo de mensajes.	Efectúe una doble pulsación en el archivo .wit que ha provocado el error para invocar el asistente Interacción Web. En la página "Correlacionar y enlazar los parámetros de salida con los campos de salida", establezca el valor de Controlador de mensajes en true: seleccione el valor "true". Ahora podrá ver el botón; púlselo y defina las especificaciones de control de mensajes.
E300	Se ha producido un error indeterminado al procesar el control de diseño (DTC) y/o el componente Web de iSeries resultante.	Resuelva todos los demás errores o avisos del archivo de anotaciones de migración. Redenomine el archivo de anotaciones de migración y ejecute de nuevo la herramienta de migración.
E301-E302	La propiedad de control de diseño para los pulsadores Siguiente/Anterior ya no está soportada. El atributo Button type (tipo de botón) del componente Web de botón se definirá como Submit (someter).	Utilice el asistente Interacción Web para crear una interacción a fin de especificar la página que contenía el botón Next/Previous (Siguiente/Anterior) como página de entrada JSP y para especificar la página destino del botón Next (Siguiente) como página de salida JSP. En la versión 4.0, el botón Next/Previous se utilizaba con varias páginas de entrada. Pulse Ayuda > Contenido de la ayuda para abrir el sistema de ayuda, y luego pulse Consulta > Consulta de interfaces de usuario > Aplicaciones Web de iSeries > Varias páginas de entrada y salida.
E400	Se ha producido un error indeterminado durante la migración del archivo de plantilla de generación de código.	Asegúrese de que las plantillas de generación de código no sean de sólo lectura. Resuelva todos los demás errores o avisos del archivo de anotaciones de migración y ejecute de nuevo la herramienta de migración.
E401	El archivo de plantilla de generación de código se ha personalizado. Utilice la versión más reciente de la plantilla.	Asegúrese de que las personalizaciones realizadas en la versión antigua de la plantilla se han realizado también en la versión más reciente de la misma. Por ejemplo, el contenido personalizado de `<ubicación_área_trabajo>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction. template.bak` debe insertarse correctamente en `<ubicación_área_trabajo>\metadata\ plugins\com.ibm.etools.iseries. webtools\iseriesPgmCallAction. template`

Código de aviso	Descripción	Acción
W100	Un componente Web de iSeries de la página JSP contiene un aviso.	Solucione el aviso del componente Web de iSeries.
W300	Un recuadro de lista o un recuadro combinado contenían más de un carácter para la propiedad delimiter. El primer carácter encontrado en la propiedad delimiter se utilizará para el atributo delimitador del componente Web de iSeries correspondiente.	Asegúrese de que todas las opciones del componente Web de recuadro de selección o de recuadro combinado tienen correctamente definidos los atributos name y value.
W301-W302	Un recuadro de lista o un recuadro combinado contenían el carácter de preselección *, en una propiedad Data [key] o [value].	Asegúrese de que todas las opciones del componente Web de recuadro de selección o de recuadro combinado tienen correctamente definidos los atributos name y value.
W303	Todos los controles de diseño de botón de selección de un archivo JSP que tienen la misma propiedad Group name aparecen ahora como opción de un componente Web de grupo de botones de selección. Las propiedades definidas en las pestañas Font y Color del primer botón de selección encontrado en la página JSP se utilizarán como atributos de Color y Font del grupo de botones de selección. Es decir, las propiedades Color tab y Font tab se perderán en los botones de selección subsiguientes del mismo grupo.	Asegúrese de que el grupo de botones de selección aparezca visualmente según lo deseado dentro de la página JSP seleccionando el archivo JSP asociado y ejecutando el archivo en el servidor. Asegúrese de que los atributos Font y Color del grupo de botones de selección aparezcan visualmente según lo deseado seleccionando el archivo JSP asociado y ejecutando el archivo en el servidor.
W304	La propiedad Label de Pushbutton ya no está soportado. La propiedad Value de Pushbutton se ha correlacionado con el atributo Label del componente Web de botón correspondiente. El texto que aparece en el componente Web de botón es diferente del del control de diseño de Pushbutton.	Cambie el valor del atributo Label si el texto mostrado en el componente Web de botón no es adecuado.
W305	El control de diseño Subfile o Table aparece ahora fuera del código HTML FORM. Un componente Web de tabla no puede aparecer dentro de un código HTML FORM. Si el tipo control de diseño era Subfile, el componente Web de iSeries correspondiente es el componente Web de tabla.	Asegúrese de que el componente Web de tabla aparezca visualmente según lo deseado en la página JSP.
W306-W320	Una propiedad de evento de control de diseño ya no está soportada. W306 - OnDblClick W307 - OnMouseDown W308 - OnMouseOut W309 - OnMouseOver W310 - OnSelect W312 - OnChange para botones de selección W313 - OnChange para recuadros de selección W314 - OnMouseUp W315 - OnKeyDown para botones de selección W316 - OnKeyPress para o¡botones de selección W317 - OnKeyUp para botones de selección W318 - OnKeyDown para pulsadores W319 - OnKeyPress para pulsadores W320 - OnKeyUp para pulsadores	Si es necesario, defina la acción asociada con un evento diferente.
W321	El componente Web tenía definido un atributo que ya no está soportado debido a que 1) el atributo CSS asociado ya no está soportado en la mayoría de navegadores 2) el atributo HTML asociado ya está obsoleto en HTML 4.0 y no está soportado en la mayoría de navegadores	Ninguna.

Avisos

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Esta información se ha desarrollado para productos y servicios que se ofrecen en los EE.UU. Es posible que IBM no ofrezca en otros países los productos, servicios o características que se describen en esta documentación. Consulte al representante local de IBM para obtener información sobre los productos y servicios que están disponibles actualmente en su área. Las referencias a un producto, programa o servicio IBM no significan ni implican que sólo pueda utilizarse este producto, programa o servicio de IBM. En su lugar se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no vulnere ningún derecho de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM.

IBM puede tener patentes o solicitudes de patentes en tramitación que afecten a temas tratados en este documento. La posesión de esta documentación no le otorga ninguna licencia sobre dichas patentes. Puede enviar las consultas sobre licencias, por escrito, a la siguiente dirección:

IBM Director of Licensing
 IBM Corporation 
North Castle Drive
Armonk, NY 10504-1785 
U.S.A.

Para consultas sobre licencias sobre información de doble byte (DBCS), póngase en contacto con el Departamento de Propiedad Intelectual de IBM de su país o envíe las consultas, por escrito, a:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

El párrafo que sigue no se aplica al Reino Unido ni a ningún otro país en el que tales disposiciones sean incompatibles con las leyes locales:

INTERNATIONAL BUSINESS MACHINES CORPORATION SUMINISTRA ESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍAS DE NINGUNA CLASE, YA SEAN EXPLÍCITAS O IMPLÍCITAS, INCLUIDAS LAS GARANTÍAS O CONDICIONES IMPLÍCITAS DE NO VULNERACIÓN, COMERCIALIZACIÓN O ADECUACIÓN A UN PROPÓSITO DETERMINADO, PERO SIN LIMITARSE A ELLAS. Algunos estados no permiten la declaración de exención de responsabilidad con respecto a las garantías explícitas o implícitas en determinadas transacciones; por tanto, esta declaración puede no ser aplicable en su caso.

Esta documentación podría incluir inexactitudes técnicas o errores tipográficos. La información que incluye está sujeta a cambios periódicos; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar en cualquier momento y sin previo aviso, mejoras y/o cambios en los productos y/o programas que se describen en esta publicación.

Las referencias hechas en esta información a sitios Web que no son de IBM se proporciona únicamente para su comodidad y no debe considerarse en modo alguno como promoción de dichos sitios Web. La información contenida en estos sitios Web no forma parte de la información de este producto IBM y el usuario es responsable de la utilización de estos sitios Web.

IBM puede utilizar o distribuir cualquier información que le proporcione del modo en que IBM crea apropiado, sin contraer ninguna obligación con el remitente de la información.

Los licenciatarios de este programa que deseen obtener información acerca del mismo con el fin de: (i) intercambiar la información entre programas creados independientemente y otros programas (incluyendo éste) y (ii) utilizar mutuamente la información que se ha intercambiado, deben ponerse en contacto con:

Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

Esta información puede estar disponible, sujeta a los términos y condiciones adecuados, incluyendo en algunos casos el pago de una tarifa.

IBM proporciona el programa bajo licencia descrito en esta documentación y todo el material bajo licencia disponible asociado a él según los términos del Acuerdo de Cliente de IBM, el Acuerdo Internacional para Programas bajo Licencia IBM o cualquier acuerdo equivalente entre las partes.

La información concerniente a productos no IBM se ha obtenido de los distribuidores de dichos productos, de sus anuncios publicados o de otras fuentes disponibles públicamente. IBM no ha comprobado estos productos y no puede confirmar con precisión su rendimiento, compatibilidad o cualquier otra reclamación relacionada con productos que no son de IBM. Las preguntas relativas a las posibilidades de productos no IBM deben dirigirse a los distribuidores de los mismos.

Esta información contiene ejemplos de datos e informes utilizados en las operaciones comerciales diarias. Para ilustrarlas de la forma más completa posible, los ejemplos pueden incluir los nombres de personas, empresas, marcas y productos. Estos nombres son ficticios y cualquier parecido con los nombres y direcciones utilizados por empresas reales es pura coincidencia.

LICENCIA DE COPYRIGHT

Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustran las técnicas de programación en diversas plataformas operativas. Puede copiar, modificar y distribuir estos programas de ejemplo de la forma que desee, sin pago alguno a IBM, con la intención de desarrollar, utilizar, comercializar o distribuir programas de aplicaciones de acuerdo con la interfaz de programación de aplicaciones correspondiente a la plataforma operativa para la que están escritos los programas de ejemplo. Los ejemplos no se han probado exhaustivamente bajo todas las condiciones. Por tanto, IBM no puede asegurar ni implicar la fiabilidad, utilidad o función de estos programas. Puede copiar, modificar y distribuir estos programas de ejemplo de la forma que desee, sin pago alguno a IBM, con la intención de desarrollar, utilizar, comercializar o distribuir programas de aplicaciones de acuerdo con las interfaces de programación de aplicaciones de IBM.

Cada copia o cada parte de los programas de ejemplo o de los trabajos que se deriven de ellos debe incluir un aviso de copyright como se indica a continuación:

(C) (el nombre de su empresa) (el año). Partes de este código se derivan de IBM Corp. (C) Copyright IBM Corp. 2000, 2005. Reservados todos los derechos.

Información acerca de las interfaces de programación

La información sobre interfaces de programación está destinada a facilitarle la creación de software de aplicación mediante este programa.

Las interfaces de programación de utilización general le permiten escribir software de aplicaciones que obtiene los servicios de las herramientas de este programa.

Sin embargo, esta información también puede contener información de diagnóstico, modificación y ajuste. La información de diagnóstico, modificación y ajuste se proporciona para ayudarle a depurar el software de aplicaciones.

Aviso: No utilice esta información de diagnóstico, modificación y ajuste como interfaz de programación porque está sujeta a cambios.

Marcas registradas y marcas de servicio

Los términos siguientes son marcas registradas de International Business Machines Corporation en los Estados Unidos y/o en otros países:

iSeries
IBM
WebSphere

Java y todas las marcas registradas y logotipos basados en Java son marcas registradas o marcas comerciales de Sun Microsystems, Inc. en los Estados Unidos y/o en otros países.

Rational es una marca registrada de International Business Machines Corporation y Rational Software Corporation, en los Estados Unidos y/o en otros países.

Otros nombres de empresas, productos y servicios pueden ser marcas registradas o marcas de servicio de otras empresas.