Herramientas Web: notas de release

1.0 Introducción
2.0 Cambios realizados desde el release anterior
3.0 Limitaciones
   3.1 Casos en los que una plantilla de página no se aplicará a una página Web
4.0 Problemas conocidos
   4.1 El validador JSP no compila automáticamente cuando hay cambios Java dependientes
   4.2 Sugerencia relacionada con el rendimiento: cerrar los proyectos inactivos
   4.3 Sugerencia relacionada con el rendimiento: inhabilitar la validación automática
   4.4 Habilitar e inhabilitar Page Designer Classic
   4.5 Limitación de la personalización del menú de barra de herramientas de Page Designer
   4.6 Aviso de enlaces rotos en los applets
   4.7 Insertar applets en archivos HTML y JSP con Page Designer
   4.8 Al obtener una vista previa de un archivo HTML que incluya Shockwave, puede suceder que WebSphere Studio finalice bruscamente
   4.9 Problemas al visualizar algunos caracteres GB18030 en Windows 2000/XP
   4.10 Problema de BiDi para WebArt Designer, Animated GIF Designer y PageDesigner Classic
   4.11 Consideraciones sobre la conversión de tipos en la opción Creado por Código con el asistente Páginas Web de base de datos
   4.12 Los archivos JSP deben utilizar sentencias de importación explícitas
   4.13 Soporte de lenguaje bidireccional para Page Designer Classic
   4.14 Migrar datos relacionales de los proyectos Web 4.0.3
   4.15 Se necesita un fragmento de código adicional para los archivos JSP y los servlets Java diseñados en un entorno DBCS para un nivel J2EE 1.3 en el servidor WebSphere 5
   4.16 Arrastrar y soltar elementos en la vista Edición rápida
   4.17 Utilizar elementos de la vista de fragmentos de código con acciones simples en la vista Edición rápida
   4.18 Soporte de lenguaje móvil para Page Designer
   4.19 Soporte de plantilla de página para Page Designer
   4.20 Notas para utilizar componentes de sitio con el diseñador de sitios Web
   4.21 Cambiar los valores de colores y fonts del sistema
   4.22 Anotaciones de búsqueda sobre archivos no guardados en los editores
   4.23 Restricciones de ClearCase al utilizar Web Site Designer o plantillas de página
   4.24 Problema al someter formulario Javascript en los JSP generados por el asistente de páginas Web de base de datos

1.0 Introducción

El entorno de desarrollo Web de WebSphere Studio proporciona las herramientas necesarias para desarrollar aplicaciones Web. Las aplicaciones Web incluyen páginas Web estáticas, archivos JavaServer Pages (JSP), servlets Java, un descriptor de despliegue XML (web.xml) y otros recursos Web.Este archivo readme describe los problemas conocidos, las limitaciones y los métodos alternativos asociados a las herramientas utilizadas en el entorno de desarrollo Web.

2.0 Cambios realizados desde el release anterior

Ahora se pueden configurar los nombres de las carpetas Web Content y Java Source de un proyecto Web. Los nombres por omisión son WebContent y JavaSource; sin embargo, para los nuevos proyectos Web, los nombres por omisión se pueden cambiar en la página de preferencias de Herramientas Web->Proyecto nuevo. Las carpetas de los proyectos existentes se pueden redenominar con la vista Navegador.
NOTA: los nombres de carpetas distintos de los que se toman por omisión no son compatibles con WebSphere Studio Versión 5.0.0. No debe cambiar los nombres por omisión si debe mantener la compatibilidad del área de trabajo con la versión 5.0.0.

Se han añadido dos vistas nuevas a la perspectiva Web para facilitar la edición de páginas HTML/JSP. La vista Paleta contiene un conjunto de elementos que pueden arrastrarse y soltarse en una página Web de Page Designer. La vista Edición rápida permite a los usuarios añadir/editar scripts y señalar con códigos los scripts de eventos en Page Designer. Encontrará más detalles en el sistema de ayuda.

3.0 Limitaciones

3.1 Casos en los que una plantilla de página no se aplicará a una página Web

Al utilizar cualquiera de los asistentes de plantillas de página, resulta que una plantilla no se aplica a una página Web cuando se dan las circunstancias siguientes:

4.0 Problemas conocidos

4.1 El validador JSP no compila automáticamente cuando hay cambios Java dependientes

El validador JSP no revalidará automáticamente un archivo JSP cuando se cambia una clase Java a la que hace referencia. El validador JSP puede volver a ejecutarse en el archivo seleccionándolo en el Navegador de proyectos y eligiendo Ejecutar validación en el menú contextual.

4.2 Sugerencia relacionada con el rendimiento: cerrar los proyectos inactivos

Para mejorar el rendimiento, le recomendamos que cierre los proyectos en los que no esté trabajando activamente. Cuando se lleva a cabo la acción Reconstruir todo, solo se reconstruyen los proyectos abiertos.

4.3 Sugerencia relacionada con el rendimiento: inhabilitar la validación automática

Por omisión, los validadores se ejecutan automáticamente cuando se guardan recursos en un proyecto Web. Si no desea que los validadores se ejecuten automáticamente al guardar estos recursos, abra el diálogo Propiedades del proyecto Web desde el menú de contexto en la vista Navegador J2EE. A continuación, habilite la opción Alterar temporalmente preferencias de validación e inhabilite la opción Ejecutar validación automáticamente al guardar cambios de recursos desde la página Validación. También puede inhabilitar la validación automática (y las construcciones) para todos los proyectos seleccionando Ventana > Preferencias e inhabilitando Realizar construcción automáticamente al modificar recursos desde la página Entorno de trabajo. Si inhabilita las construcciones automáticas, puede ejecutar manualmente una construcción (y una validación) seleccionando Proyecto > Reconstruir proyecto.

4.4 Habilitar e inhabilitar Page Designer Classic

La versión de Page Designer de WebSphere Studio V4 (ahora conocida como Page Designer Classic) ha sufrido cambios de diseño en la Versión 5. El nuevo Page Designer (al que se hace referencia como Page Designer dentro de la interfaz de usuario y la documentación del producto) es la versión recomendada. También es la versión por omisión. Page Designer Classic no está disponible como característica instalable, pero puede habilitarse utilizando las instrucciones que se ofrecen más adelante.

Page Designer proporciona capacidad de uso y características ampliadas, tales como la edición de atributos basada en vistas y el soporte de biblioteca de códigos simplificados.

Algunas de las características de Page Designer Classic no se incorporan en esta versión. Entre ellas:

A menos que necesite soporte específico para las características incluidas en Page Designer Classic, utilice el Page Designer por omisión. Si desea habilitar Page Designer Classic, haga lo siguiente:

Instalar Page Designer Classic:

  1. Salga de WebSphere Studio antes de empezar la instalación.
  2. En el Explorador de Windows, abra el directorio DIR INSTALACIÓN WSAD/bin y pulse dos veces en pdclassic.exe.
  3. Al reiniciar WebSphere Studio, aparecerá el diálogo Actualizaciones. Pulse el botón .
    Nota: si es la primera vez que utiliza el entorno de trabajo, este paso y los siguientes no se llevarán a cabo.
  4. En el diálogo Cambios de configuración, marque el recuadro de selección que hay en el área Cambios detectados. A continuación, pulse el botón Finalizar.
  5. En el diálogo Instalar/Actualizar, pulse el botón . El entorno de trabajo se reiniciará para que los cambios entren en vigor.

Correlacionar Page Designer Classic como editor Web por omisión:

Tras instalar Page Designer Classic, se correlacionarán por omisión las asociaciones de archivos entre este editor y varios tipos de archivos HTML y JSP (incluidos los tipos *.htm, *.html, *.jsp, *.jhtml, *.shtml, *.shtm y *.html-ss); así, para abrir un archivo seleccionado en Page Designer Classic, podrá utilizar Abrir con > Page Designer Classic en el menú de contexto de la vista Navegador J2EE. Sin embargo, si desea hacer que Page Designer Classic sea el editor por omisión para los tipos de archivo HTML y JSP, haga lo siguiente:

  1. Seleccione Ventana > Preferencias.
  2. Expanda los valores de Entorno de trabajo y abra la página Asociaciones de archivos.
  3. Seleccione los tipos de archivo aplicables (de uno en uno) en el cuadro de lista Tipos de archivo.
  4. Seleccione Page Designer Classic en el diálogo Selección de editor y pulse el botón Valor por omisión.
  5. Repita los pasos 3 y 4 para cada tipo de archivo aplicable.

Nota: si más adelante inhabilita Page Designer Classic y luego vuelve a habilitarlo, también se reincorporarán las asociaciones de archivos. Sin embargo, el editor por omisión para el tipo de archivo correlacionado pasará a ser el nuevo Page Designer.

Opcionalmente, puede realizar actualizaciones en las preferencias de edición de Page Designer Classic. Seleccione Ventana > Preferencias y, a continuación, expanda los valores de Herramientas Web. Expanda Page Designer (Classic) para realizar las actualizaciones que desee.

Inhabilitar Page Designer Classic

Para inhabilitar esta característica (incluida la ayuda) y reanudar el uso del Page Designer por omisión, lleve a cabo estos pasos:

  1. Seleccione Ayuda > Actualizaciones de software > Gestor de actualizaciones.
  2. En la vista Configuración de instalación, expanda Configuración actual para localizar Page Designer Classic 5.1.0 y selecciónelo.
  3. Pulse el botón Inhabilitar en el ángulo inferior derecho del panel Vista previa.
  4. En el diálogo Instalación de características, pulse el botón Finalizar.
  5. En el diálogo Instalar/Actualizar, pulse el botón . El entorno de trabajo se reiniciará para que los cambios entren en vigor.

Habilitar Page Designer Classic (una vez inhabilitado)

Para habilitar otra vez Page Designer Classic, no vuelva a ejecutar pdclassic.exe. En vez de ello, lleve a cabo estos pasos:

  1. Seleccione Ayuda > Actualizaciones de software > Gestor de actualizaciones.
  2. En la vista Configuración de instalación, pulse el botón Mostrar características inhabilitadas de la barra de herramientas.
  3. Expanda Configuración actual para localizar Page Designer Classic 5.1.0 y selecciónelo.
  4. Pulse el botón Habilitar en el ángulo inferior derecho del panel Vista previa.
  5. En el diálogo Instalación de características, pulse el botón Finalizar.
  6. En el diálogo Instalar/Actualizar, pulse el botón . El entorno de trabajo se reiniciará para que los cambios entren en vigor.

4.5 Limitación de la personalización del menú de barra de herramientas de Page Designer

Tras personalizar la barra de herramientas utilizando el diálogo Personalizar perspectiva (al que se accede seleccionando Ventana > Personalizar perspectiva), no puede utilizarse el menú Barra de herramientas de Page Designer para una personalización más amplia de la barra de herramientas. En este caso, debe utilizar el diálogo Personalizar perspectiva para decidir qué elementos de la barra de herramientas se visualizan.

4.6 Aviso de enlaces rotos en los applets

LinksBuilder podría señalar incorrectamente como enlace no válido el valor del atributo code de un applet si se utiliza un nombre de clase Java totalmente calificado:

<applet code="aaa.bbb.AnApplet" codebase="MyApplets">
Este aviso puede pasarse por alto sin problemas porque no afecta al comportamiento del applet cuando se ejecuta en el servidor.

Este aviso puede evitarse utilizando el separador de vía de acceso ('/') en lugar del separador ('.') y asegurándose de que la extensión .class está indicada de forma explícita. Por ejemplo:

<applet code="aaa/bbb/AnApplet.class" codebase="MyApplets">

4.7 Insertar applets en archivos HTML y JSP con Page Designer

La carpeta fuente Java (cuyo nombre por omisión es JavaSource) de un proyecto Web es para las clases del lado del servidor, por lo que no puede colocarse en ella el código fuente de los applets. Por consiguiente, cuando desarrolle applets, le recomendamos que:

  1. Cree un proyecto Java para los applets y luego cree las clases de applet en el proyecto.
  2. Copie los archivos de clase de applet en la carpeta de contenido Web (cuyo nombre por omisión es WebContent) de un proyecto Web. No los copie en la carpeta WEB-INF, porque esa carpeta es solamente para las clases del lado del servidor. Para ver los archivos de clase, tendrá que cambiar los filtros de la vista Navegador de proyectos seleccionando Filtros en la lista desplegable del botón Menú de la vista.
  3. Inserte un applet en una página Web seleccionando Insertar > Otros > Applet Java en Page Designer. En ese momento debe definir los atributos code y codebase adecuados.

    Por ejemplo, si la clase de applet es aaa.bbb.AnApplet y la estructura de archivos es como la siguiente:

     WebContent/index.html
    WebContent/MyApplets/aaa/bbb/AnApplet.class
    code is "aaa.bbb.AnApplet"

    entonces, en el archivo index.html, el código de applet debe contener:

    codebase is "MyApplets"

4.8 Al obtener una vista previa de un archivo HTML que incluya Shockwave puede suceder que WebSphere Studio finalice bruscamente

No se conoce ninguna manera de salir al paso de este problema.

4.9 Existe un problema para visualizar algunos caracteres GB18030 en Windows 2000/XP

GB18030 es un estándar de juego de caracteres de la República Popular China que especifica una página de códigos ampliada y una tabla para correlacionar con Unicode. WebArt Designer y Animated GIF Designer no pueden mostrar correctamente los caracteres GB18030 comprendidos entre 0xA840 y 0xA9A0 si está instalado el entorno local chino simplificado y el paquete de soporte GB18030 de Microsoft.

En WebArt Designer este problema se produce en los campos de texto de la vista Galería WebArt, los campos de texto del diálogo Asistente Logotipo (Especificar texto 1/4), los campos de texto del diálogo Editar favoritos y los elementos del menú Favoritos.

En Animated GIF Designer este problema se produce en el campo Comentario del diálogo Propiedades de marco (Marco Comentarios), en el marco Comentarios de la vista Miniatura de marco y en los campos de texto del diálogo Crear rótulo animado.

Por ejemplo, si entra el carácter '0xA877' GB18030 (en Unicode, U+2573 Box Drawings Light Diagonal Cross), se mostrará como '0xA876' GB18030 (en Unicode, U+2572 Box Drawings Light Diagonal Upper Left To Lower Right).

4.10 Problema de BiDi para WebArt Designer, Animated GIF Designer y PageDesigner Classic

WebArt Designer y Page Designer Classic a veces no permiten crear la imagen de logotipo del idioma bidireccional en Windows XP. Si especifica un espaciado de caracteres al crear una imagen de logotipo con caracteres de derecha a izquierda, los caracteres del logotipo no se volverán a ordenar. Es preciso especificar el valor cero como espaciado de caracteres para tener una imagen de logotipo correcta de caracteres bidireccionales en Windows XP.

El rótulo animado de AnimatedGif Designer tiene la misma restricción.

4.11 Consideraciones sobre la conversión de tipos en la opción Creado por Código con el asistente Páginas Web de base de datos

En el asistente Páginas Web de base de datos utilizando IBM Data Access Beans - Patrón de detalles maestro, algunas bases de datos tienen problemas al realizar la conversión interna de datos de tipo String a datos de los tipos que corresponda. Por ejemplo, Oracle 8.17i no hará la conversión de datos de tipo serie a numérico.

Para solucionar este problema en el archivo $Prefix$ViewBean.java generado para cada consulta de DataAccess, tendrá que hacer un cambio en el método prepareStatement().

Si el código es:
//Añadir descripciones de parámetros a metadatos.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.lang.String.class);

// Establecer parámetros.
getDBSelect().setParameter(PARAM1_NAME, inSAL);

Tendrá que cambiarlo para que sea:
//Añadir descripciones de parámetros a metadatos.
DBParameterMetaData metaData = getDBSelect().getParameterMetaData();
metaData.setParameter(1, PARAM1_NAME, DatabaseMetaData.procedureColumnIn,
java.sql.Types.DECIMAL,
java.math.BigDecimal.class);

// Establecer parámetros.
getDBSelect().setParameterFromString(PARAM1_NAME, inSAL);
Tiene que indicar a los metadatos de parámetro (ParameterMetaData) qué tipo de objeto Java está esperando su base de datos. Luego utilice el método setParmeterFromString en lugar del método setParameter en la instancia de DBSelect. Esto indicará al objeto DBSelect que haga la conversión de tipo, en lugar de hacerla su base de datos.

4.12 Los archivos JSP deben utilizar sentencias de importación explícitas

Los archivos JSP deben utilizar el atributo 'import' de la directiva page para describir los tipos que están disponibles en el entorno de scripts de esa página. Algunos tipos pueden haberse importado de manera implícita en los archivos JSP contenidos en los proyectos J2EE1.2, pero mostrarán errores si se emplean en un proyecto J2EE1.3. Para evitar que se produzca este problema, hay que importar siempre los tipos de manera explícita en la página JSP (a menos que el tipo esté incluido en la lista de importación por omisión: java.lang.*, javax.servlet.*, javax.servlet.jsp.* y javax.servlet.http.*).

4.13 Soporte de lenguaje bidireccional para Page Designer Classic

Puede habilitar el soporte bidireccional para Page Designer Classic estableciendo que el entorno local por omisión del sistema y el entorno local por omisión del usuario correspondan al árabe o al hebreo en Windows.

4.14 Migrar datos relacionales de los proyectos Web 4.0.3

Para migrar datos relacionales de los proyectos de WebSphere Studio 4.0.3, tendrá que seguir estos pasos.

  1. En un área de trabajo 4.0.3, genere archivos DDL para cada base de datos disponible.
  2. Elimine la base de datos de la carpeta source/databases del proyecto Web (por medio de la vista Definición de datos).
  3. Abra el área de trabajo 4.0.3 con WebSphere Studio Versión 5.
  4. Migre los proyectos Web cuyos datos relacionales desea restaurar.
  5. Pulse Archivo > Importar > Sistema de archivos y especifique los archivos DDL (uno o varios) del área de trabajo 4.0.3.
  6. En la vista Definición de datos de la perspectiva Datos, seleccione Ejecutar para local y especifique el proyecto Web destino.

Los artefactos de datos relacionales se restaurarán.

4.15 Se necesita un fragmento de código adicional para los archivos JSP y los servlets Java diseñados en un entorno DBCS para un nivel J2EE 1.3 en el servidor WebSphere

Esta entrada atañe a los archivos JSP y servlets Java diseñados en un entorno DBCS para un nivel J2EE 1.3 en el servidor WebSphere. Antes de acceder a parámetros o atributos de petición, hay que incluir en el fuente el siguiente fragmento de código:

  if(request.getCharacterEncoding() == null){  
request.setCharacterEncoding(<encoding>); // normalmente, esta sería la codificación del JSP o servlet
}
//...código normal de jsp o servlet que accede a objetos petición como
// <%=request.getParameter("message")%>

Si no se incluye este fragmento de código y no hay información de codificación en la petición, todos los parámetros de petición se analizarían en ISO-8859-1 y, por lo tanto, los caracteres DBCS que hubiera en los parámetros de entrada se verían incorrectamente.

4.16 Arrastrar y soltar elementos en la vista Edición rápida

Antes de arrastrar elementos o texto de la vista de fragmentos de código o paleta y soltarlos en la vista Edición rápida, hay que asegurarse de que la instrucción "Insertar una acción/fragmento de código" está deseleccionada en la vista Edición rápida.

4.17 Utilizar elementos de la vista de fragmentos de código con acciones simples en la vista Edición rápida

Por cada elemento de la vista de fragmentos de código JavaScript, hay una acción simple correspondiente en la vista Edición rápida. En la vista Edición rápida, le recomendamos que no combine la utilización de acciones simples con los elementos de la vista de fragmentos de código en el mismo script de evento. Si es necesario combinar los elementos, tenga cuidado de dónde se coloca el elemento de fragmento de código. Si se arrastran elementos de la vista de fragmentos de código para soltarlos en la vista Edición rápida cuando ya hay acciones simples en el editor, el elemento de fragmento de código podría insertarse en un lugar inadecuado. En tal caso, suprima la acción simple y vuelva a insertarla.

4.18 Soporte de lenguaje móvil para Page Designer

Los atributos no soportados en los lenguajes móviles, como cHTML o WML, se pueden insertar desde el diálogo Insertar o desde la vista Atributos.
Sin embargo, puede comprobar la validez del código utilizando Herramientas > Validar sintaxis de HTML, en el caso de un documento cHTML, o utilizando Herramientas > Validar sintaxis de WML, cuando se trate de un documento WML.

4.19 Soporte de plantilla de página para Page Designer

Las plantillas de página solo están soportadas en Page Designer, no en Page Designer Classic. Puede utilizar Page Designer para editar una página HTML/JSP utilizando la función de plantilla de página.

4.20 Notas para utilizar componentes de sitio con el diseñador de sitios Web

4.21 Cambiar los valores de colores y fonts del sistema

Cuando cambia los valores de colores y fonts del sistema, debe reiniciar WebSphere Studio para que los nuevos valores se apliquen a la página Diseño de Page Designer y a la vista Paleta.

4.22 Anotaciones de búsqueda sobre archivos no guardados en los editores

En el editor del fuente y en la página Fuente de los editores multipágina, como el editor XML, la función de búsqueda se lleva a cabo desde el recurso guardado en el sistema de archivos, en lugar de hacerlo desde el contenido del editor. Las anotaciones de búsqueda de un editor que no se haya guardado podrían no ser fiables. Para evitar este problema, guarde el archivo antes de realizar una búsqueda.

4.23 Restricciones de ClearCase al utilizar Web Site Designer o plantillas de página

Si utiliza Web Site Designer para trabajar en un proyecto Web, primero debe asegurarse de que los archivos de proyecto, como por ejemplo los archivos html o jsp y los archivos relacionados se reservan en el depósito de ClearCase.

Asimismo, si utiliza plantillas de página en el proyecto Web, primero debe reservar los archivos adecuados de ClearCase.

4.24 Problema al someter formulario Javascript en los JSP generados por el asistente de páginas Web de base de datos

En algunos JSP generados por el asistente de páginas Web de base de datos, especialmente uno titulado '***MasterView.jsp',

puede que los enlaces de la página titulados 'Back', 'Refresh' y otros no funcionen en todos los navegadores. Se han observado problemas en algunos navegadores, especialmente Mozilla y Konqueror.

Para solucionar el problema en la mayoría de navegadores, cambie el código Javascript para la función denominada 'submitForm' en el JSP.

Cambie la variable 'document.<formName>.elements.action' del método por 'document.<formName>.action'.

Por ejemplo, function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.elements.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.elements.action = "/Web3/SCHEMA_TABLEDetailsView"; }

se convierte en

function submitForm(nav){ if(nav == 'SCHEMA_TABLEInputForm'){ document.myForm.action = "/Web3/SCHEMA_TABLEInputForm.html"; } else if(nav == 'SCHEMA_TABLEMasterView'){ document.myForm.action = "/Web3/SCHEMA_TABLEMasterView"; } else{ document.myForm.action = "/Web3/SCHEMA_TABLEDetailsView"; }

Volver al archivo readme principal