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

Acerca de esta información

Esta información describe cómo migrar los proyectos de IBM WebSphere Development Studio Client para iSeries Versión 4.0, 5.0 o 5.1.

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 del producto.

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.

Antes de empezar

Importante: si tiene actualmente Development Studio Client para iSeries Versión 4.0 o Versión 5.0 o 5.1 y desea instalar WebSphere Development Studio Client Versión 5.1.2, el proceso de instalación desinstalará la versión anterior del producto. Antes de desinstalar Development Studio Client para iSeries Versión 4.0, 5.1 o 5.1, es aconsejable anotar la ubicación del área de trabajo de la Versión 4.0, 5.0 o 5.1 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 4.0, 5.0 o 5.1. (Por omisión, estos proyectos no se desinstalan ni suprimen).

Para averiguar dónde se encuentra el área de trabajo de la Versión 5.0 o 5.1:

• Si aceptó la ubicación por omisión cuando instaló la Versión 5.0, 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 ha instalado el producto.
• 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 IDE de la Versión 5.0 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.

Para averiguar dónde se encuentra el área de trabajo de la Versión 4.0:

• 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 IDE 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.

Migración desde la Versión 5.0 o 5.1 a la Versión 5.1.2

Esta guía contiene otra información que debe leer antes de instalar la Versión 5.1.2. Sin embargo, si ya la ha instalado, puede encontrar la guía, por ejemplo, en X:\WDSC\install\help\migrate.htm.

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

• Si tiene WebSphere Development Studio Client Advanced Edition para iSeries Versión 5.1.2, la guía de migración es el archivo migrate.html o migrate.pdf del directorio wsad del CD 1.
• De lo contrario, la guía de migración es migrate.html o migrate.pdf del directorio wssd del CD 1.

La guía también está disponible después de la instalación, por ejemplo, en:

• C:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1\migrate.html
• C:\Program Files\IBM\WebSphere Studio\Site Developer\v5.1\migrate.html

Pasos prerrequisito de la migración

La generación del asistente requiere un paquete Java para el JDK 1.4

Debido a un cambio en el JDK 1.4, debe especificar un paquete ^(TM) al utilizar los asistentes Páginas Web de base de datos y Páginas Web de bean Java para generar páginas que deben ejecutarse en la versión 5.1.x. Este problema se produce si se utiliza la plantilla Bean de vista para el asistente Páginas Web de bean Java o el Patrón de detalles de beans maestros Java de acceso a base de datos de IBM^(R). Esto también se aplica a los proyectos que contienen páginas y archivos .java generados anteriormente con estos asistentes que no especifiquen 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 la Versión 5.1.2

Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.0.

Para beans de llamada a programa de un proyecto Java:

Para beans de llamada a programa de un proyecto Web:

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

Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a programa creados en Development Studio Client para iSeries Versión 5.0.

Para beans de llamada a programa de un proyecto Java:

Para beans de llamada a programa de un proyecto Web:

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

Este apartado describe cómo migrar a la Versión 5.1.2 los beans de llamada a programa creados en Development Studio Client para iSeries Versión 4.0.

Para beans de llamada a programa de un proyecto Java:

Para beans de llamada a programa de un proyecto Web:

Migrar valores del Explorador de sistemas remotos

Migrar desde la Versión 4.0 a la Versión 5.1.2

Migrar los proyectos WebFacing

Si tiene proyectos existentes de la Versión 4.0, 5.0.x o 5.1.x, puede especificar el área de trabajo antigua al iniciar el entorno de trabajo 5.1.2 y los proyectos 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 releases anteriores no aparecen en una vista de árbol de la versión 5.1.2.

La primera vez que convierta un archivo DDS, la estructura de proyectos se actualizará para reflejar el nuevo diseño de 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 seleccionara específicamente el asistente Importar.

Utilizar el asistente de importación de WebFacing

Si tiene proyectos WebFacing de WebSphere Development Studio Client Versión 4.0, 5.0 o 5.1, puede migrarlos a Development Studio Client Versión 5.1.2 mediante el asistente de importación. Siga estos pasos:

Pasos manuales si ha personalizado archivos del proyecto

Los archivos originales tienen nombres nuevos con el siguiente formato: nombre-archivo +_512_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.0.x o Versión 5.1

  Esta migración implica la utilización del área de trabajo existente en el IDE de la Versión 5.1.2 y la ejecución de la rutina de migración de las herramientas Web de iSeries.

• Migrar proyectos Web de iSeries utilizando un área de trabajo existente de WebSphere Development Studio Client Versión 4.0

  Esta migración implica la utilización del área de trabajo existente en el IDE de la Versión 5.1.2 y la ejecución de la rutina de migración de las herramientas Web de iSeries. La rutina convierte el proyecto Web al nivel más reciente de J2EE.

Migrar proyectos Web de iSeries de las Versiones 5.0.x y 5.1 a la Versión 5.1.2

Esta sección describe cómo migrar proyectos Web de iSeries de Development Studio Client para iSeries Versión 5.0.x y 5.1 a Development Studio Client para iSeries Versión 5.1.2.

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

1. Migrar los proyectos utilizando un área de trabajo existente en 5.0.x o 5.1
2. Migrar el contenido del proyecto de de iSeries
3. Resolver los errores y los avisos generados como resultado de la migración

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

En la Versión 5.1.2, 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 JavaResources y WebContent. Estos nombres por omisión se utilizarán sólo para nuevos proyectos Web. Los proyectos Web creados en versiones anteriores a la Versión 5.1.2 seguirán utilizando los nombres antiguos. Lo mismo ocurre en los proyectos Web estáticos.

Puede cambiar manualmente los nombres de carpeta fuente de los proyectos 5.0.x o 5.1 en la Versión 5.1.2 pulsando el nombre de carpeta con el botón derecho del ratón en la vista Navegador 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.0.x o 5.1. Si opta por redenominar los nombres de las carpetas JavaResources y WebContent en la Versión 5.1.2, deberá actualizar manualmente los scripts de construcción automatizada con los nombres de carpeta nuevos.

Paso 2: Migrar el contenido del proyecto Web de iSeries

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

1. 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 Añadir soporte de 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.
2. 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.
3. 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.
4. Para seguir realizando el proceso, pulse Aceptar. La ventana Información de progreso muestra el progreso de la migración.
5. Cuando la migración haya finalizado, un mensaje indicará el resultado.
6. 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 Paso 3: Resolver los errores y avisos generados como resultado de la migración.
7. 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 la Versión 5.1.2.

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 y que están en el archivo de anotaciones de migración que se llama nombreProyecto_MigrationDetails.txt, 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 un archivo de la información en línea que describe los errores y avisos, y proporciona la acción correctora. Consulte el apartado Mensajes de aviso y error para la migración de proyectos Web

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 la versión 5.1.2

Esta sección describe cómo migrar proyectos Web de iSeries de Development Studio Client para iSeries Versión 4.0. a Development Studio Client para iSeries Versión 5.1.2.

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

1. Migrar los proyectos utilizando un área de trabajo existente en V4.0.x
2. Migrar la estructura de proyectos Web y, opcionalmente, la versión J2EE del proyecto
   Nota:
   La migración del proyecto Web a J2EE 1.3 es una actividad opcional. Sin embargo, en J2EE 1.2 no está soportada la arquitectura de conectores J2EE (JCA).
3. Migrar el contenido del proyecto de herramientas Web de iSeries
4. Resolver los errores y los avisos generados a causa de la migración

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

Este enfoque está parcialmente soportado y de él se deriva una migración incompleta. Se pierden los valores de la interfaz de usuario, los valores de depuración y la mayoría de las preferencias. Se conservan los nombres de los proyectos, los archivos fuente de los proyectos y la vía de construcción Java (vía de acceso de clases) de los proyectos, pero no hay ninguna garantía de que se conserve lo demás. Solo debe adoptar este enfoque si no se está utilizando ningún sistema de gestión de configuraciones de software (SCM) soportado y si es esencial conservar la información sobre la vía de construcción de los proyectos, que se pierde al importar a la Versión 5.1.2 los proyectos exportados desde la Versión 4.0. Puede utilizar el área de trabajo existente en la Versión 4.0.x siguiendo estos pasos:

Eliminación tras la migración de las referencias a vías de acceso absolutas de los archivos EAR y de configuración de servidor

Los archivos EAR application.xml y los archivos de configuración de servidor de la Versión 4.0 contenían referencias a vías de acceso absolutas. Después de haberlos migrado a la versión 5.1.2, tendrá que abrirlos con el correspondiente editor (que cambia automáticamente las antiguas referencias a vías de acceso absolutas por nuevas referencias relativas).

1. Para cada proyecto EAR, actualice el archivo application.xml.
   1. En una vista Navegador, pulse META-INF/application.xml con el botón derecho del ratón y seleccione Abrir con > Editor de descriptor de despliegue.
   2. Pulse Sí en el mensaje

      El archivo de
      extensiones de IBM contiene vías de acceso absolutas obsoletas. Esto puede corregirse automáticamente... ¿Desea corregirlo automáticamente? 

   3. Guarde y luego cierre la ventana del editor.
2. Para cada configuración de servidor, actualice el archivo de configuración.
   1. En la vista Configuración de servidor de la perspectiva Servidor, pulse el nombre de servidor con el botón derecho del ratón y seleccione Abrir.
   2. Se abre una ventana similar de corrección automática.
   3. Pulse Sí.
   4. Guarde y luego cierre la ventana del editor.

Problemas conocidos y limitaciones

Si intenta migrar abriendo un área de trabajo de la versión 4.0 en el producto de la versión 5.1.2, pueden producirse los problemas que se indican a continuación.

Valor incorrecto en la variable de vía de acceso de clases JRE_LIB

Para restablecer la variable de vía de acceso de clases JRE_LIB en una ubicación válida, siga estos pasos. Sígalos aunque el valor parezca correcto cuando abra por primera vez la ventana Preferencias.

1. Seleccione Ventana > Preferencias > Java > JRE instalados.
2. En la lista, marque el recuadro de selección de la ubicación de JRE por omisión en la que está establecida la variable JRE_LIB.
3. Elija Editar y después pulse Aceptar para cerrar el diálogo Editar JRE.

Si no lo hace, el valor de JRE_LIB podría ser incorrecto, lo que provocaría muchos errores de construcción en los archivos Java.

Como comprobación general, verifique el valor de las demás variables de vía de acceso de clases.

Para los proyectos SCM compartidos anteriormente, el menú Equipo contiene Compartir proyecto

El soporte de equipo ha cambiado notablemente entre Eclipse 1.0 y 2.0. También ha cambiado el método de compartir proyectos con el depósito.

• Si selecciona la opción Equipo > Compartir proyecto, aparecerá un asistente que le orientará en el proceso de migración. Cuando haya terminado, su proyecto estará compartido y se abrirá la vista Sincronizar. En cada archivo aparecerán cambios conflictivos. Ello se debe a los cambios que afectan a cómo se almacena la información de sincronización en Eclipse 1.0 y 2.0.
• Si no tiene cambios salientes (no los tendrá si los comprometió todos antes de actualizar, según las recomendaciones anteriores), basta con que seleccione el proyecto en la vista Sincronizar y luego seleccione Alterar temporalmente y actualizar, lo que cargará el contenido actual desde el servidor.
• Si tiene cambios salientes, despliegue el menú del triángulo en la vista Sincronizar y seleccione Comparar contenido de archivo. Se llevará a cabo un proceso y después en la vista Sincronizar solo figurarán los archivos que realmente presenten diferencias. A continuación, puede utilizar la vista Sincronizar para resolver estos conflictos.

Proyectos creados fuera del directorio workspace

Por omisión, los proyectos se crean en el directorio workspace. Si altera temporalmente el valor por omisión para que los proyectos se creen en otro lugar, abra ahora todos los proyectos antes de cerrar el entorno de trabajo. Esto permite que el archivo .project de ese proyecto se escriba en la ubicación pertinente. Si no se puede abrir un proyecto cerrado cuyo directorio esté fuera del área de trabajo, se obtendrá un proyecto que enmascara el proyecto real, y en él solo existirá un archivo .project.

Paso 2: Migrar la estructura del proyecto Web a la estructura del proyecto J2EE 1.3

Tenga en cuenta que el asistente Migración J2EE puede llevar a cabo dos funciones:

• Migrar la estructura del proyecto Web o la estructura del proyecto J2EE de la versión 4.0 a la versión 5.1.2.
• Migrar, opcionalmente, el nivel 1.2 al nivel 1.3 de J2EE.

Para migrar la estructura del proyecto J2EE:

1. Si todavía no está abierto, abra el IDE de la versión 5.1.2 seleccionando el producto en el menú Inicio > Programas.
2. En el IDE, seleccione Ventana > Abrir perspectiva > Web para abrir la perspectiva Web.
3. 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 Migrar > Asistente de migración J2EE.
4. Siga las instrucciones que figuran en las páginas del asistente. Si se propone utilizar el soporte JCA (arquitectura de conectores J2EE), debe marcar el recuadro de selección Migrar proyecto del nivel de versión J2EE 1.2 a J2EE 1.3.
5. Pulse Finalizar para migrar el proyecto Web seleccionado.

Paso 3: Migrar el contenido de los proyectos de Herramientas Web de iSeries

El siguiente proceso de migración depende de la migración satisfactoria de la estructura del proyecto Web a la estructura del proyecto J2EE, tal como se ha explicado en el apartado anterior.

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

1. 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 Añadir soporte de 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.
2. 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.
3. 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 Migrar > Proyecto de herramientas Web de iSeries.
4. La ventana Confirmar Migración indica que se migrará la estructura y el contenido del proyecto. Para seguir realizando el proceso, pulse Aceptar.
5. Se abre la ventana Información de progreso, que indica que se está realizando la operación de migración y muestra cómo avanza el proceso.
6. Al finalizar el proceso de migración, aparece una ventana con un mensaje de aviso, error o éxito que indica el resultado de la migración.
7. 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 Paso 4: Resolver los errores y avisos generados como resultado de la migración.

El proceso de migración lleva a cabo las acciones siguientes:

• Convierte todos los controles de tiempo de diseño existentes en los archivos JSP en los nuevos campos y controles de componentes Web.
• 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.

Paso 4: 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 y que están en el archivo de anotaciones de migración que se llama nombreProyecto_MigrationDetails.txt, 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 un archivo de la información en línea que describe los errores y avisos, y proporciona la acción correctora. Consulte también la ayuda en línea que figura en Development Studio Client para iSeries > Aplicaciones Web > Desarrollo Web de iSeries > Consulta > Detalles de errores y avisos de 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 en la Etapa 4, 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 las instrucciones destinadas a restaurar el programa de servicio, consulte la sección "Programa de servicio de subarchivo QDTSSFL" que se encuentra en Ayuda > Contenido de la ayuda y, a continuación, en el sistema de ayuda en Consulta > Consulta de interfaz 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 "Datos" de la ayuda en línea, que se encuentra en Consulta > Consulta de interfaz de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > Componente Web de recuadro combinado.
• La matriz de formato de datos devuelta desde un programa de sistema principal para un componente Web de tipo recuadro de selección 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 de selección. Para obtener más información acerca de los formatos de datos, consulte la sección "Datos" de la ayuda en línea, que se encuentra en Consulta > Consulta de interfaz de usuario > Aplicaciones Web de iSeries > Componentes Web de iSeries > Componente Web de recuadro de selección.

Además de los avisos de migración que aparecen en el archivo de anotaciones descrito en la Etapa 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

Migrar proyectos iSeries

Migrar proyectos iSeries de la Versión 5.0 a la Versión 5.1.2:

Si ha dejado abierta la vista Estado de construcción 5.0 en el entorno de trabajo 5.0, se producirá el siguiente error en 5.1.2:

No se ha podido restaurar el diseño del entorno de trabajo

Pulse Aceptar para continuar. Este error está relacionado con la sustitución de la vista Estado de construcción de la perspectiva Proyectos iSeries por la vista Estado de trabajo iSeries de la perspectiva Explorador de sistemas remotos. Las construcciones listadas en la vista original Estado de construcción no aparecen en la vista nueva. Al reconstruir el proyecto iSeries asociado, la construcción nueva aparecerá en la vista Estado de trabajo y la función en ejecución no resultará afectada.

Después de la migración, si obtiene un indicador rojo en un proyecto iSeries, puede deberse al hecho de que la conexión del Explorador de sistemas remotos asociada con el proyecto ya no existe. Para resolverlo:

1. Pulse el proyecto iSeries con el botón derecho del ratón y seleccione Propiedades > Proyecto iSeries.
2. Establezca la conexión que falta y pulse Aceptar.

Migrar proyectos iSeries de la Versión 4.0 a la Versión 5.1.2:

Si aún tiene instalado Development Studio Client para iSeries Versión 4.0:

Antes de desinstalar Development Studio Client Versión 4.0, debe exportar el contenido del proyecto a la máquina de sistema principal. A continuación, instale Development Studio Client Versión 5.1.2. Tras la instalación, es posible volver a crear los proyectos ejecutando una acción desde el Explorador de sistemas remotos.

Si ya ha instalado Development Studio Client para iSeries Versión 5.1.2 y sabe que no ha cargado los proyectos en el sistema principal remoto

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 ofrecidos en los EE.UU. IBM puede no ofrecer los productos, servicios o características tratados en esta documentación en otros países. Póngase en contacto con el representante local de IBM que le informará sobre los productos y servicios disponibles actualmente en su área. Las referencias hechas a productos, programas o servicios de IBM no pretenden afirmar ni dar a entender que únicamente puedan utilizarse dichos productos, programas o servicios de IBM. En su lugar puede utilizarse cualquier otro producto, programa o servicio funcionalmente equivalente que no infrinja ninguno de los derechos 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 patente pendientes de aprobación que cubran alguno de los temas tratados en esta documentación. 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 solicitando información sobre caracteres de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM de su país o envíe directamente 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 mejoras y/o cambios en los productos y/o programas descritos en esta publicación en cualquier momento y sin previo aviso.

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. Los materiales de estos sitios Web no forman parte de los materiales de IBM para este producto y el uso que se haga de estos sitios Web es de la entera responsabilidad del usuario.

IBM puede utilizar o distribuir la información que usted le suministre del modo que IBM considere conveniente sin incurrir por ello en ninguna obligación para con usted.

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 bajo los términos del contrato de cliente IBM, del contrato internacional de programas bajo licencia IBM o cualquier contrato equivalente.

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 los productos y no puede afirmar la exactitud en cuanto a rendimiento, compatibilidad u otras características relativas a productos no 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 cualquier forma sin pagar nada a IBM, bajo el propósito de desarrollo, uso, comercialización o distribución de programas de aplicación de acuerdo con la interfaz de programación de la aplicación para la plataforma operativa para la cual se han escrito los programas de ejemplo. Los ejemplos no se han probado exhaustivamente bajo todas las condiciones. IBM, por lo tanto, no puede garantizar ni implicar la fiabilidad, servicio o funcionalidad de estos programas. Puede copiar, modificar y distribuir estos programas de ejemplo de cualquier forma sin pagar nada a IBM bajo el propósito de desarrollo, uso, comercialización o distribución de programas de aplicación de acuerdo con los 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). Parte de este código se deriva de IBM Corp. Sample Programs. (C) Copyright IBM Corp. 1992, 2002. 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:

* AIX	* DB2 Extenders	* Operating System/400
* AIX windows	* DB2 Universal Database	* OS/2
* Application System/400	*	* Open Class
* AS/400	* IBM	* OS/390
* AS/400e	* IBMLink	* OS/400
* C Set ++	* Integrated Language Environment	* RPG/400
* COBOL/2	* iSeries	* SQL/400
* COBOL/400	* Language Environment	* VisualAge
* DB2	* MQSeries	* WebSphere

InstallShield es una marca registrada de InstallShield Corporation.

Intel y Pentium son marcas registradas de Intel Corporation en los Estados Unidos y/o en otros países.

Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc., en los Estados Unidos y 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.

ActiveX, Microsoft, SourceSafe, Visual C++, Visual SourceSafe, Windows, Windows NT, Win32, Win32s y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros países.

UNIX es una marca registrada de The Open Group.

Los demás nombres de empresas, productos y servicios pueden ser marcas registradas o de servicio de terceros.