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 ignorar 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 apartado "Desarrollo de portlets para la cooperación" en el centro de información de WebSphere Portal.
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:
<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 "Seleccionar 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.
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.
Los portlets cooperativos no están soportados por el navegador interno de Rational Developer para RedHat Enterprise Linux 3.0. Si necesita utilizar los portlets cooperativos en RedHat Enterprise Linux 3.0, utilice Netscape Communicator.
Para utilizar Netscape Communicator como el navegador por omisión, configure Rational Developer para utilizar un navegador externo. Para hacerlo, seleccione Ventana > Preferencias en la barra de menús. Expanda el nodo Internet situado a la izquierda y seleccione Navegador Web. En la sección principal, seleccione cualquier navegador menos Navegador Web interno.
Para obtener más información, consulte el tema "Restricciones y problemas conocidos con portlets cooperativos" en el centro informativo de WebSphere Portal.
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.
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.
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.
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 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: 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.
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).
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.
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.
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.
En "Add SDO runtime" se hace referencia a los grupos de noticias de Rational Software Architect. El sitio de soporte de Rational Software Architect (www.ibm.com/software/awdtools/developer/application/support) se actualizará para incluir el enlace con los grupos de noticias.
Volver al archivo readme principal