Los proyectos de Portal soportan WebSphere Portal v5.0.2.2.
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:
- Si utiliza un portlet JSR 168 sin un atributo ID en un proyecto de portal, el proyecto de portal no podrá ejecutarse en un Entorno de prueba.
- Si asocia dos o más portlets JSR168 sin un atributo ID al Entorno de prueba de WebSphere Portal 5.1, el Entorno de prueba no podrá iniciarse.
- No debe cambiar el nombre del proyecto después de desplegar el portlet JSR 168 en un servidor de portal o después de utilizar el proyecto de portlet JSR 168 en un proyecto de portal.
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 hijoPuede pasar por alto este error.
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.
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.
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.
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:
- Descargue el directorio del adaptador JCo de SAP en SAP Service Marketplace.
- 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.
- 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:
- Copie sapjco.jar y sapjcorfc.dll en <wps_51>\shared\app.
- Copie librfc32.dll en c:\windows\system32\.
- Debe reiniciar el servidor WebSphere Portal 5.1.
Para Linux:
- Copie sapjco.jar y libsapjcorfc.so en <wps_51>\shared\app.
- Añada la carpeta que contiene el archivo librfccm.so a la variable de entorno LD_LIBRARY_PATH.
- Debe reiniciar el servidor WebSphere Portal 5.1.
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.
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.
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.
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.
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.
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.
- Actualice todos los archivos bajo el directorio siguiente copiando las últimas versiones del directorio PortalServer\*.* de WebSphere Portal 5.0.2.x.
- dir_instal_WS\runtimes\portal_v50_stub\*.* donde dir_instal_WS es el directorio en el que instaló Rational Developer.
- Para depurar los portlets, asegúrese de aplicar también el servicio al Entorno de prueba de WebSphere Portal. Debe aplicar el servicio al directorio dir_instal_WS\runtimes\portal_v50 de WebSphere Portal V5.0.2.x.
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.
- Aplique el servicio al Entorno de prueba de WebSphere Portal v5.1 siguiendo las instrucciones del servicio.
- Actualice todos los archivos bajo el directorio siguiente copiando las últimas versiones del directorio PortalServer\*.* del Entorno de prueba de WebSphere Portal 5.1.
- dir_instal_RD\runtimes\portal_v51_stub\*.* donde dir_instal_RD es el directorio en el que instaló Rational Developer.
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.
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:
- IWAL0008E Referencia de servlet incorrecta para el portlet. (portlet.xml)
- CHKJ4014W: Entrada vacía de nombre de servlet de tipo. (web.xml)
Solución: debe volver a abrir el proyecto de portlet utilizando el método siguiente:
- Pulse con el botón derecho sobre el proyecto de portlet y seleccione Cerrar proyecto en el menú emergente.
- Pulse con el botón derecho sobre el proyecto de portlet y seleccione Abrir proyecto en el menú emergente.
- 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.
Problema: el Entorno de prueba de WebSphere Portal no puede iniciarse.
Solución:
- Verifique que la instalación haya sido satisfactoria: este problema puede producirse debido a una anomalía durante la instalación. Revise los problemas surgidos durante la instalación del Entorno de prueba de WebSphere Portal y soluciónelos como corresponda.
- Elimine los nombres de archivo excesivamente largos: es posible que no pueda iniciarse el servidor porque el proyecto de portlet tenga archivos con nombres de archivo excesivamente largos. Para resolver este problema, acorte el nombre del proyecto, el prefijo del paquete y/o el prefijo de la clase de forma que la longitud del nombre de archivo generado sea aceptable. Los nombres de archivo individuales también pueden acortarse a una longitud aceptable. Además, si se utiliza el directorio predeterminado como área de trabajo, también será efectivo utilizar un área de trabajo distinta con un nombre de directorio más corto. Puede especificar el directorio del área de trabajo lanzando Rational Developer y cambiando el nombre en el recuadro de diálogo proporcionado. Si el recuadro de diálogo para especificar el área de trabajo no aparece, vaya al indicador de mandatos y teclee -data [nombre_área_de_trabajo] después de teclear el mandato de ejecución de Rational Developer.
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.
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:
- 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.
- En la parte inferior del editor, pulse la pestaña Entorno.
- 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.
- Pulse Ctrl+S para guardar los cambios.
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.
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:
- 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.
- 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.
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.
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.
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.
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.
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.
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.
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.
Problema: el Entorno de prueba de WebSphere Portal 5.0 no puede iniciarse cuando se intenta hacer lo siguiente:
- iniciar el entorno de prueba con un proyecto de portal que no tenga proyectos de portlet asociados y después
- añadir proyectos de portlet al proyecto al proyecto de portal e intentar volver a ejecutar ese proyecto de portal en el entorno de prueba.
Solución: debe volver a configurar el Entorno de prueba de WebSphere Portal 5.0.
Ahora debería poder ejecutar el proyecto de portal y los proyectos de portlet recién asociados en el entorno de prueba.
- En la vista Servidores, pulse con el botón derecho del ratón sobre el servidor y seleccione "Añadir y eliminar proyectos...".
- Elimine el proyecto "wps" de "Proyectos configurados".
- Pulse con el botón derecho del ratón sobre el proyecto de portal y seleccione Ejecutar > Ejecutar en servidor.
Nota: esto se ha arreglado en V6.0.0.1.
"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