Herramientas de Portal - Notas de release


1.0 Software soportado y especificaciones
2.0 Limitaciones
   2.1 Los portlets de JSR 168 deben tener atributo ID
   2.2 Registros relacionales y Portal V5.1
   2.3 *Limitación de portlet cooperativo
   2.4 *Limitación del código person
   2.5 *Limitaciones de herramientas EIS
   2.6 Configurar SAP JCo en un servidor WebSphere Portal
   2.7 Los mensajes de aviso de enlace roto se muestran en la vista Problemas
   2.8 Soporte de código en Portal Designer
   2.9 *No se puede establecer un URL interno
   2.10 *No seleccionar temas Admin como valores predeterminados
3.0 Problemas conocidos
   3.1 (Instalación) Anomalía al instalar el Entorno de prueba de WebSphere Portal
   3.2 (Crear portlets) Errores de compilación con el último WebSphere Portal
   3.3 (Crear portlets) Icono de portlet inesperado visualizado al habilitar Pulsar para accionar
   3.4 *(Crear portlets) Error de referencia de servlet incorrecto al crear un portlet en un proyecto de portlet API de IBM existente
   3.5 (Depurar y probar portlets) No se puede iniciar el Entorno de prueba de WebSphere Portal
   3.6 (Depurar y probar portlets) No se pueden instalar portlets utilizando el portlet de administración en el entorno de prueba
   3.7 (Depurar y probar portlets) Se produce un error si una aplicación de portlet utiliza una base de datos que no sea Cloudscape
   3.8 (Descriptor de despliegue de portlet) Editar con el editor de Descriptor de despliegue de portlet JSR 168
   3.9 (Ejecutar y depurar) El navegador interno no muestra el proyecto de portlet o de portal actualizado
   3.10 Cuando se utiliza <f:subview> en lugar de <f:view>, los portlets Faces no funcionan correctamente.
   3.11 *Pulsar para accionar no funciona en un portlet Faces maximizado.
   3.12 (Migrar portlets) La migración de los portlets de Portal V4.2 a V5.0 falla
   3.13 *3.6 (Importar, exportar y desplegar) No se puede crear el servidor de importación, exportación y despliegue destinado a "localhost".
   3.14 *(Importar portal) La cancelación de la operación de portal implica la no disponibilidad del proyecto portal nuevo
   3.15 (Importar portal) Los errores relacionados con WSRP se muestran en la vista Problemas de un proyecto de portal importado
   3.16 (Personalizar portales) No se pueden abrir los archivos license.html ni privacy.html en un proyecto de portal importado
   3.17 *(Ejecutar y depurar proyecto de Portal) No puede iniciar el Entorno de prueba de WebSphere Portal 5.0 con un proyecto de portal
   3.18 El grupo de noticias (fórum) para Rational Application Developer

1.0 Software soportado y especificaciones

Los proyectos de Portal soportan WebSphere Portal v5.0.2.2.

2.0 Limitaciones

2.1 Los portlets de JSR 168 deben tener atributo ID

Cuando crea los portlets JSR 168 utilizando el asistente de portlet nuevo, Rational Developer asigna automáticamente un atributo ID. El atributo ID debe incluirse en el elemento <portlet-app/> del archivo portlet.xml para identificar el portlet de forma exclusiva frente al servidor. (Este atributo corresponde al atributo UID utilizado por los portlets de la API de portlets de IBM.)

Si tiene portlets JSR 168 que no tienen un atributo ID en el elemento <portlet-app/> de portlet.xml, añada el atributo ID con el valor exclusivo correspondiente inmediatamente después de importar el portlet en el área de trabajo. Para añadir el atributo ID, abra el descriptor de despliegue del portlet y edítelo utilizando la vista Fuente. No cambie el valor del ID después de desplegar el portlet JSR 168 a un servidor de portal o después utilizar el proyecto de portlet JSR 168 en un proyecto de portal.

Hay limitaciones sobre un portlet JSR 168 sin un atributo ID:

2.2 Registros relacionales y Portal V5.1

Al ejecutar un portlet que contenga una lista de registros relacionales o un registro relacional (SDO), verá el error siguiente en las anotaciones del servidor:

[04/10/07 17:57:27:172 JST] 4942fbd0 SystemOut O java.lang.LinkageError: La clase org/eclipse/emf/ecore/EClass viola las restricciones del cargador: discrepancia de definición entre los cargadores padre e hijo
Puede pasar por alto este error.

2.3 *Limitación de portlet cooperativo

Cuando crea un portlet de origen cooperativo debe añadir manualmente los atributos actionNameParameter y name al archivo WSDL. Por ejemplo:

<portlet:action type="standard" name="myActionName" actionNameParameter="ACTION_NAME"/>

En este, la herramienta de portal no genera el atributo caption en el archivo WSDL. Cuando utilice la conexión con WebSphere Portal v5.1, deberá especificar manualmente el atributo caption en el archivo WSDL y el valor caption en el archivo de recursos. Por ejemplo:

<portlet:param name="orderId" partname="order_id" caption="order.id" />
Para obtener más información, consulte el tema "Desarrollar portlets para la cooperación" en el centro informativo de WebSphere Portal.

Nota: esto se ha arreglado en V6.0.0.1.

2.4 *Limitación del código person

Cuando utilice el código person en un portlet básico API de IBM en WebSphere Portal v5.1, debe especificarlo con la sintaxis siguiente:

<pa:person value="CN=John Smith,OU=SALES,O=ACME" valueType="LDAPDN" displayName="John Smith" />

Cuando utilice el código person en un portlet Faces API de IBM en WebSphere Portal v5.1, debe especificarlo con la sintaxis siguiente:
Nota: esto se ha arreglado en V6.0.0.1. Utilice la misma sintaxis descrita más arriba para el portlet básico.

<pa:person value="CN=John Smith,OU=SALES,O=ACME" />John Smith<pa:person>

El código person no está soportado para los portlets JSR 168.

2.5 *Limitaciones de herramientas EIS

Limitación del asistente SAP BAPI y RFM SDO: si va más allá de la página de funciones principal y pre/post e intenta volver a ella después de seleccionar una función principal distinta, la página Correlaciones pre/post no funcionará correctamente.

Solución: si necesita establecer correlaciones de función pre y post nuevas, debe reiniciar el asistente.

Nota: esto se ha arreglado en V6.0.0.1.

2.6 Configurar SAP JCo en un servidor WebSphere Portal

Antes de probar los portlets que contienen SAP SDO en un servidor Portal, debe configurar el adaptador SAP JCo en el servidor WebSphere Portal 5.1:

  1. Descargue el directorio del adaptador JCo de SAP en SAP Service Marketplace.
  2. Pulse Descargar software > Descargar > Conector SAP > Conector Java SAP. Seleccione descargar el archivo adecuado para su sistema operativo. Extraiga el contenido del archivo ZIP en un directorio local.
  3. Complete los pasos siguientes según corresponda a su sistema operativo. Nota: <wps_51> hace referencia al directorio de instalación del servidor WebSphere Portal 5.1; por ejemplo, C:\WebSphere\PortalServer51TE.
      Para Windows:
    1. Copie sapjco.jar y sapjcorfc.dll en <wps_51>\shared\app.
    2. Copie librfc32.dll en c:\windows\system32\.
    3. Debe reiniciar el servidor WebSphere Portal 5.1.

      Para Linux:
    1. Copie sapjco.jar y libsapjcorfc.so en <wps_51>\shared\app.
    2. Añada la carpeta que contiene el archivo librfccm.so a la variable de entorno LD_LIBRARY_PATH.
    3. Debe reiniciar el servidor WebSphere Portal 5.1.

2.7 Los mensajes de aviso de enlace roto se muestran en la vista Problemas

Al crear un proyecto de portal utilizando el asistente Proyecto de portal nuevo o importando un proyecto de portal de ejemplo de la Galería de ejemplos, aparecen mensajes de aviso de enlace roto en la vista Problemas.

2.8 Soporte de código en Portal Designer

En esta versión de Rational Developer, Portal Designer solo visualiza HTML, cHTML y WML como códigos soportados. Si ha especificado otros códigos soportados para una página o una etiqueta en un proyecto a importar, estos se mantienen en Rational Developer; sin embargo, no puede cambiar los códigos y no se visualizarán en la vista Propiedades.

2.9 *No se puede establecer un URL interno

En esta versión de Rational Developer, solo puede establecer URL externos en Portal Designer. Si tiene URL internos en el servidor de portal, se mantendrán en un proyecto importado, pero no puede cambiarlos. Solo puede desplegar los URL internos en el servidor de portal original.

Nota: esto se ha arreglado en V6.0.0.1.

2.10 *No seleccionar temas Admin como valores predeterminados

En este release de Portal Designer, los temas Admin y AdminLeftNavigation se mostrarán en la vista Esquema. Sin embargo, estos temas son solo a efectos de la Administración de Portal y no deben seleccionarse como tema predeterminado para un proyecto de portal.

Nota: esto se ha arreglado en V6.0.0.1.

3.0 Problemas conocidos

3.1 (Instalación) Anomalía al instalar el Entorno de prueba de WebSphere Portal

Problema: la instalación de Rational Developer falla al instalar el Entorno de prueba de WebSphere Portal Test Environment.

Solución: compruebe las anotaciones de instalación y saque las medidas adecuadas para rectificar el problema.

Entorno de prueba de WebSphere Portal 5.0 dir_instal_RD\runtimes\portal_v50\log\wpsinstalllog.txt donde dir_instal_RD es el directorio de instalación en el que instaló Rational Developer.

Entorno de prueba de WebSphere Portal 5.1 dir_instal_WP51TE\PortalServer\log\wpsinstalllog.txt donde dir_instal_WP51TE es el directorio en el que instaló el Entorno de prueba de WebSphere Portal v5.1.

Si no puede identificar el problema a partir de los archivos de anotaciones, intente desinstalar manualmente el Entorno de prueba de WebSphere Portal. A continuación, reinstálelo. Para obtener información acerca de cómo realizar la desinstalación manualmente, consulte la Guía de instalación de Rational Developer.

3.2 (Crear portlets) Errores de compilación con el último WebSphere Portal

Problema: puede construir portlets para WebSphere Portal V5.0 utilizando Rational Developer. Si aplica un servicio WebSphere Portal al servidor de portal, puede recibir errores de compilación al construir los portlets. En este caso, debe actualizar manualmente los archivos necesarios para la compilación.

Solución: para compilar los portlets correctamente, siga estos pasos:

WebSphere Portal v5.0.2.x

Nota: debe restaurar estos archivos a su estado original para poder desinstalar el Entorno de prueba de WebSphere Portal. Si no hace esto, no se podrá suprimir la carpeta "portal_v50_stub" y deberá suprimirla manualmente.

WebSphere Portal v5.1

Nota: debe restaurar estos archivos a su estado original para poder desinstalar el Entorno de prueba de WebSphere Portal. Si no hace esto, no se podrá suprimir la carpeta "portal_v51_stub" y deberá suprimirla manualmente.

3.3 (Crear portlets) Icono de portlet inesperado visualizado al habilitar Pulsar para accionar

El editor de descriptores de despliegue de portlets y la vista Explorador de proyectos muestra los iconos de portlet y su nombre. Los iconos indican el estado de los portlets. El estado de los portlets puede ser normal, habilitado para origen, habilitado para destino y habilitado para origen y para destino.

Problema: al convertir un portlet en un portlet origen Pulsar para accionar, solo debe cambiarse el icono de portlet convertido. Sin embargo, hay casos en los que se cambia más de un icono de portlet, como por ejemplo cuando varios portlets están asociados a un solo servlet. En estos casos, se visualizan incorrectamente iconos de portlets distintos al icono de portlet Pulsar para accionar. La misma situación se produce cuando convierte un portlet en un portlet destino Pulsar para accionar.

Solución: se cambia más de un icono de portlet; sin embargo, solo cambia un portlet. La conversión es satisfactoria y el proyecto de portlet no resulta dañado.

3.4 *(Crear portlets) Error de referencia de servlet incorrecto al crear un portlet en un proyecto de portlet API de IBM existente

Problema: cuando crea un portlet nuevo en un proyecto de portlet de API de IBM, se visualizarán los mensajes de error siguientes, seleccione las opciones Añadir ejemplo de portlet de remitente Pulsar para accionar o Añadir ejemplo de portlet de remitente de mensaje en la página Manejo de eventos:

Solución: debe volver a abrir el proyecto de portlet utilizando el método siguiente:

  1. Pulse con el botón derecho sobre el proyecto de portlet y seleccione Cerrar proyecto en el menú emergente.
  2. Pulse con el botón derecho sobre el proyecto de portlet y seleccione Abrir proyecto en el menú emergente.
  3. Pulse con el botón derecho sobre el proyecto de portlet y seleccione Ejecutar validación en el menú emergente.

Nota: esto se ha arreglado en V6.0.0.1.

3.5 (Depurar y probar portlets) No se puede iniciar el Entorno de prueba de WebSphere Portal

Problema: el Entorno de prueba de WebSphere Portal no puede iniciarse.

Solución:

3.6 (Depurar y probar portlets) No se pueden instalar portlets utilizando el portlet de administración en el entorno de prueba

Problema: en el servidor Entorno de prueba de WebSphere Portal, la instalación de portlets mediante el portlet de administración falla.

Solución en el servidor del Entorno de prueba de WebSphere Portal, la instalación de portlets mediante el portlet de administración no está soportada. Para desplegar portlets en el Entorno de prueba de WebSphere Portal debe utilizar la función "Publicar" en Rational Developer. Para utilizar la función "Publicar", pulse con el botón derecho del ratón sobre el proyecto de aplicación de portlet y seleccione Ejecutar > Ejecutar en servidor o pulse con el botón derecho sobre el servidor en la vista de servidores y seleccione Publicar.

3.7 (Depurar y probar portlets) Se produce un error si una aplicación de portlet utiliza una base de datos que no sea Cloudscape

Problema: puede producirse un error si la aplicación de portlet utiliza una base de datos que no sea Cloudscape.

Solución: debe añadir el controlador JDBC a las vías de clase específicas de WebSphere del Entorno de prueba de WebSphere Portal. Siga estos pasos:

  1. En la vista Servidores, efectúe una doble pulsación sobre el servidor Entorno de prueba de WebSphere Portal. Se abre el editor del servidor.
  2. En la parte inferior del editor, pulse la pestaña Entorno.
  3. En la sección ws.ext.dirs, añada el controlador JDBC. Por ejemplo, añada el archivo SQLLIB\java12\db2java.zip para DB2, donde SQLLIB es el directorio en el que instaló DB2.
  4. Pulse Ctrl+S para guardar los cambios.

3.8 (Descriptor de despliegue de portlet) Editar con el editor de Descriptor de despliegue de portlet JSR 168

Problema: en el Descriptor de despliegue de portlet JSR 168 no puede editar un nombre de portlet en el área Colecciones de portlet.

Solución: Edite el nombre del portlet en la página Fuente.

3.9 (Ejecutar y depurar) El navegador interno no muestra el proyecto de portlet o de portal actualizado

Problema: en algunas configuraciones que utilizan WebSphere Portal v5.0, los cambios realizados en un proyecto de portal o portlet no se muestran automáticamente en el navegador al ejecutar o depurar el proyecto utilizando un servidor de conexión de servidor remota.

Solución: hay dos formas de tratar este asunto:

  1. Finalice la sesión de WebSphere Portal explícitamente utilizando el navegador y vuelva a iniciar la sesión. Tras el inicio de sesión se mostrarán los cambios. Tenga en cuenta que el cierre de la ventana del navegador no funcionará y que esto tendrá que realizarse cada vez que se publique un proyecto de portal actualizado.
  2. También puede configurar Rational Developer para utilizar un navegador externo. Para hacerlo, seleccione Preferencias... en el menú Ventana. Expanda el nodo Internet situado a la izquierda y seleccione Navegador Web. En la sección principal, seleccione cualquier navegador que no sea el Navegador Web interno.
    A continuación, antes de cada ejecución o depuración en servidor, deberá cerrar el navegador externo antes de realizar la operación.

3.10 Cuando se utiliza <f:subview> en lugar de <f:view>, los portlets Faces no funcionan correctamente.

Problema: si suprime el código <f:view> de un archivo JSP Faces generado por el asistente e inserta los componentes Faces en el archivo, se inserta un código <f:subview> en lugar de un código <f:view>. Con este tipo de archivo JSP, el portlet Faces no se ejecutará correctamente. Las entradas del navegador se pierden en el proceso del lado del servidor.

Problema: para solucionar este problema, sustituya el código <f:subview> por el código <f:view> en el archivo JSP.

3.11 *Pulsar para accionar no funciona en un portlet Faces maximizado.

Si maximiza un portlet Faces que contenga códigos Pulsar para accionar, el contenido del portlet no se muestra.

Nota: esto se ha arreglado en V6.0.0.1.

3.12 (Migrar portlets) La migración de los portlets de Portal V4.2 a V5.0 falla

Problema: el cambio de nivel de la API de Portlet falla si la vía de acceso de clases es larga.

Solución: debe corregir la vía de acceso de construcción Java de los proyectos de portlet migrados. Para la vía de acceso de construcción Java, puede hacer referencia a un proyecto de portlet básico generado por el asistente Proyecto de portlet nuevo. Añada los archivos JAR faltantes necesarios a la vía de acceso de construcción Java del proyecto de portlet migrado.

3.13 *(Importar, exportar y desplegar) No se puede crear el servidor de importación, exportación y despliegue destinado a "localhost"

Problema: si el UTE de Portal no está instalado, no puede crear un servidor de importación, exportación y despliegue de portal destinado a "localhost" o "127.0.0.1".

Solución: si necesita crear un servidor así, utilice el nombre totalmente calificado del sistema en lugar de "localhost" (ejemplo: myhost.mydomain).

Nota: esto se ha arreglado en V6.0.0.1.

3.14 *(Importar portal) La cancelación de la operación de portal implica la no disponibilidad del proyecto portal nuevo

Problema: si cancela la importación de un proyecto de portal nuevo antes de completarlo, el proyecto de portal incompleto no se elimina y no estará disponible.

Solución: necesita importar la configuración y los archivos del portal utilizando la opción Suprimir al sobreescribir en el asistente Importar portal.

Nota: esto se ha arreglado en V6.0.0.1.

3.15 (Importar portal) Los errores relacionados con WSRP se muestran en la vista Problemas de un proyecto de portal importado

Problema: al importar un sitio de portal existente de WebSphere Portal a Rational Developer, los errores de validación relacionados con WSRP se muestran en la vista Problemas frente al proyecto de portal importado.

Solución: aplique el APAR PQ95638 a WebSphere Portal antes de importar a Rational Developer.

Nota: esto se ha arreglado para WP5.1, pero no para WP5.0.

3.16 (Personalizar portales) No se pueden abrir los archivos license.html ni privacy.html en un proyecto de portal importado

Problema: no se pueden abrir los archivos license.html o privacy.html en un proyecto de portal importado utilizando Page Designer debido a una codificación incorrecta.

Solución: Aplique el APAR PQ93681 al servidor Portal y vuelva a importar el proyecto del servidor Portal.

Nota: esto se ha arreglado para WP5.1, pero no para WP5.0.

3.17 *(Ejecutar y depurar proyecto de Portal) No puede iniciar el Entorno de prueba de WebSphere Portal 5.0 con un proyecto de portal

Problema: el Entorno de prueba de WebSphere Portal 5.0 no puede iniciarse cuando se intenta hacer lo siguiente:

Solución: debe volver a configurar el Entorno de prueba de WebSphere Portal 5.0.

  1. En la vista Servidores, pulse con el botón derecho del ratón sobre el servidor y seleccione "Añadir y eliminar proyectos...".
  2. Elimine el proyecto "wps" de "Proyectos configurados".
  3. Pulse con el botón derecho del ratón sobre el proyecto de portal y seleccione Ejecutar > Ejecutar en servidor.
Ahora debería poder ejecutar el proyecto de portal y los proyectos de portlet recién asociados en el entorno de prueba.

Nota: esto se ha arreglado en V6.0.0.1.

3.18 El grupo de noticias (fórum) para Rational Application Developer

"Añadir tiempo de ejecución de SDO" hace referencia a los grupos de noticias de Rational Application Developer. El fórum para Rational Application Developer está disponible en el sitio IBM developerWorks (www.ibm.com/developerworks/forums/dw_forum.jsp?forum=430&cat=24&hideBody=true).

Volver al archivo readme principal