WebSphere Portal
y HATS
IBM® WebSphere Portal le proporciona un único punto de acceso a contenido y aplicaciones Web, personalizado según las necesidades de cada usuario.
La integración de HATS con WebSphere Portal permite que los datos fluyan sin restricciones entre HATS, WebSphere Portal y otras aplicaciones de Portal. Todas las características relevantes de WebSphere Portal también están disponibles para su aprovechamiento en HATS mediante la creación de herramientas integradas o el desarrollo directo de Java™. Al ejecutar HATS en el entorno de WebSphere Portal, se conservan la mayoría de las funciones de HATS. Para más información, consulte Consideraciones y limitaciones de portlets de HATS.
Las aplicaciones de HATS pueden ejecutarse directamente en WebSphere Portal
como portlets, lo que permite que WebSphere Portal y HATS interactúen directamente. Puede desarrollar portlets de HATS que cumplan la API Portlet IBM o el estándar de la API Java Portlet Specification (JSR
168), de aquí en adelante denominado
API Portlet estándar.
Nota:
En todo este documento, los portlets de HATS que cumplan la
API Portlet estándar (JSR 168) serán denominados portlets estándar.
Las clases de lógica empresarial de HATS se pueden utilizar en las API de WebSphere Portal y las JSP de HATS pueden incluir bibliotecas de códigos JSP de WebSphere Portal. Si desea obtener más información sobre la programación de portlets y características avanzadas del portal, consulte la publicación HATS Web Application Programmer's Guide.
Un proyecto de portlet de HATS está pensado para utilizarse en aplicaciones orientadas por transformaciones. Para adaptar las aplicaciones basadas en objetos de integración del Modelo 1 para que e ejecuten en WebSphere Portal,
consulte la publicación HATS Web Application Programmer's Guide. Para convertir las aplicaciones basadas en objetos de integración
Struts a fin de ejecutarlas en WebSphere Portal, consulte el centro de información
de WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp
y busque Struts.
Si desea obtener más información y ayuda sobre las Herramientas de Portal, seleccione el menú
Ayuda en la barra de herramientas de Rational SDP y seleccione Contenido de la ayuda. Pulse Desarrollo de aplicaciones de portal y portlet en la lista de ayuda de la izquierda para acceder a la documentación para desarrolladores de portlets.
Creación de portlets de HATS
Existen dos formas para crear un portlet de HATS:
- Puede crear un nuevo portlet con HATS utilizando el asistente Crear un proyecto y especificando que el Servidor de destino sea uno de los servidores de WebSphere Portal soportados.
- Puede generar un portlet a partir de un proyecto Web existente de HATS. Así se
garantiza que el tiempo dedicado a la creación de la aplicación Web
de HATS no se habrá desaprovechado al moverla a
WebSphere
Portal.
Creación de un nuevo proyecto de portlet de HATS
Para crear un nuevo proyecto de portlet de HATS, inicie el asistente Crear un proyecto mediante una de las acciones siguientes:
- Seleccione HATS > Nuevo > Proyecto en la barra de menús.
- Seleccione Archivo > Nuevo > Proyecto de HATS en la barra de menús.
- Pulse el icono Crear proyecto de HATS en la barra de herramientas.
En el asistente Crear un proyecto, en el panel Proyecto de HATS:
- Escriba el nombre del proyecto de portlet.
- De manera opcional, especifique una descripción.
- Acepte la ubicación por omisión.
- Seleccione Web para indicar que es un proyecto Web.
Nota:
si la opción Despliegue Web está inhabilitada, esto indica que
no se han definido Runtimes de servidor. Para definir Runtimes de servidor, vaya a Ventana > Preferencias > Servidor > Entornos de Runtimes y añada
al menos una definición de Runtime.
- Para el campo Servidor de destino, seleccione uno de los servidores WebSphere Portal
admitidos, WebSphere Portal v6.0 o WebSphere Portal v6.1.
Notas:
- Generalmente, los portlets destinados a WebSphere Portal v6.0 se pueden desplegar y ejecutar en
WebSphere
Portal v6.1. Si desea obtener más información consulte el centro de información de WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp y busque Planificación para la migración.
- Los portlets estándar destinados para WebSphere Portal v6.1 también pueden ejecutarse en WebSphere Application Server v6.1 o v7.0.
- En el campo Proyecto de Enterprise Application, escriba el nombre del proyecto EAR
que se utilizará para probarlo en el entorno de prueba local.
Nota:
los proyectos de portlet estándar e IBM pueden añadirse en el mismo proyecto EAR.
- En el campo API de portlet, seleccione Portlet JSR 168 o Portlet IBM para
indicar con qué API será compatible este portlet.
Nota:
Si selecciona
Portlet de IBM,
verá un aviso indicando que esta API se ha desechado.
- Seleccione si desea incluir los archivos de soporte de la consola administrativa.
Nota:
Esta acción no está soportada para los portlets JSR estándar de HATS.
- Pulse Siguiente y continúe con la creación del proyecto de la forma habitual.
Se generará un solo proyecto de portlet de HATS incluido un proyecto EAR que puede utilizarse para probarlo
con un entorno de prueba local.
Generación de portlets a partir de proyectos Web de HATS
Para convertir un proyecto Web existente de HATS para que se ejecute como un portlet, debe alterarse la estructura y el contenido del proyecto de HATS de modo que satisfaga la especificación de portlet. HATS Toolkit automatiza el proceso de convertir en un portlet un proyecto Web de HATS normal. La característica Herramientas de Portal de Rational SDP es un requisito previo para este proceso de conversión.
Para generar un proyecto de portlet de HATS a partir de un proyecto Web
existente de HATS, en la vista Proyectos de HATS,
pulse con el botón derecho del ratón en el proyecto Web y seleccione Generar proyecto de portlet.
En el asistente Generar proyecto de portlet,
en el panel Opciones de generación de proyecto de portlet:
- Escriba el nombre del proyecto de portlet.
- En el campo Servidor de destino, seleccione el servidor WebSphere Portal
de destino, WebSphere Portal v6.0 o WebSphere Portal v6.1.
Notas:
- Al generar un proyecto de portlet de HATS a partir de un proyecto Web de HATS,
el servidor de destino del proyecto Web determina las opciones del servidor de destino para el proyecto
de portlet. Si el servidor de destino del proyecto Web es WebSphere Application
Server v6.0, las opciones de servidor de destino del proyecto de portlet generado serán WebSphere Portal
v6.0 o v6.1. Si el servidor de destino del proyecto Web es WebSphere Application
Server v6.1, la opción de servidor de destino del portlet generado será WebSphere Portal v6.1. Si el servidor de destino del proyecto Web es WebSphere Application Server v7.0, no hay opción para generar un portlet.
- Generalmente, los portlets destinados a WebSphere Portal v6.0 se pueden desplegar y ejecutar en
WebSphere
Portal v6.1. Si desea obtener más información consulte el centro de información de WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp y busque Planificación para la migración.
- Los portlets estándar destinados para WebSphere Portal v6.0 o v6.1 también pueden ejecutarse en WebSphere Application Server v6.1 o v7.0.
- En el campo Proyecto de Enterprise Application, escriba el nombre del proyecto EAR
que se utilizará para probarlo en el entorno de prueba local.
Nota:
los proyectos de portlet estándar e IBM pueden añadirse en el mismo proyecto EAR.
- En el campo API de portlet, seleccione Portlet JSR 168 o Portlet IBM para
indicar con qué API será compatible este portlet.
Nota:
Si selecciona
Portlet de IBM,
verá un aviso indicando que esta API se ha desechado.
- Seleccione en esta lista los tipos de archivos que se convertirán automáticamente:
- Transformaciones
- Fragmentos de transformación
- Plantillas
- Manejadores de macro
- Hojas de estilos en cascada
- Pulse Finalizar.
Se creará un proyecto de portlet de HATS a partir del proyecto Web seleccionado. Después de crear el portlet, se podrá llevar a cabo una personalización adicional. Si desea obtener más información sobre la modificación de proyectos de HATS, consulte el Modificación de un proyecto de HATS.
Notas:
- Si convierte un proyecto Web de HATS en un proyecto de portlet de HATS,
es posible que tenga que modificar manualmente el archivo de configuración de inicio de sesión Express en Web (WEL) (hatswelcfg.xml) si los plug-ins configurados para el proyecto de Web
no están soportados para el proyecto de portlet. Es aconsejable utilizar
la interfaz de configuración WEL para añadir plug-ins soportados para que el archivo de configuración WEL (hatswelcfg.xml)
se actualice correctamente.
- Después de generar un proyecto de portlet de HATS a partir de un proyecto Web de HATS, los cambios efectuados en un proyecto no se reflejan en el otro. Siempre se podrá generar un nuevo proyecto de portlet de HATS a partir de un proyecto Web de HATS cambiado para reflejar los cambios efectuados en el proyecto Web.
- No puede volver a convertir un proyecto de portlet HATS en un proyecto Web de HATS.
- Si dispone de una aplicación existente de HATS V4, V5, V6, V7.0, o V7.1 debe migrar la aplicación a HATS V7.5.1 antes de generar un proyecto de portlet. Si desea obtener más información sobre la migración a HATS V7.5.1, consulte el Migración a HATS V7.5.1.
Migración de portlets de IBM
a portlets estándar
La migración de un portlet de IBM de HATS a un portlet JSR estándar de HATS debe hacerse manualmente.
Los pasos necesarios son:
- Migración de las facetas del proyecto.
- Migración de los archivos descriptores de despliegue Web y del portlet.
- Migración de las transformaciones, las plantillas y los manejadores de macro.
- Migración de los archivos específicos de HATS.
- Migración de otras funciones de portal (opcional).
Migración de las facetas del proyecto
- Si está incluida, elimine la faceta Struts ya que los portlets JSR estándar de HATS no soportan Struts.
- En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Propiedades.
- En la página Propiedades, pulse Facetas de proyecto.
- Si está seleccionado, anule la selección del recuadro de selección Struts para portlets de IBM.
- Pulse Aceptar.
- Sustituya la faceta de portlets de IBM por la faceta de portlets JSR.
- En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Propiedades.
- En la página Propiedades, pulse Facetas de proyecto.
- Deseleccione el recuadro de selección Portlets de IBM y seleccione el
recuadro Portlets JSR.En la columna Versión, asegúrese de que aparezca 1.0. Si no aparece, pulse el icono desplegable que hay junto al número de versión y cámbielo a 1.0.
- Pulse Aceptar.
Migración de los archivos descriptores de despliegue Web y del portlet
- En la vista Navegador, edite el descriptor de despliegue Web (Contenido Web/WEB-INF/web.xml)
y efectúe los pasos siguientes:
- En la pestaña Servlets, elimine los servlets y las correlaciones yourportlet (su portlet) y HATSAdminServlet
(si existe).
- En la pestaña Variables de la sección Referencias de biblioteca de códigos, elimine la referencia en la biblioteca al código admin.tld, si existe.
- En la pestaña Variables de la sección Referencias de biblioteca de códigos, añada una referencia en la biblioteca al código std-portlet.tld con los valores
siguientes:
URL: http://java.sun.com/portlet
Ubicación: /WEB-INF/tld/std-portlet.tld
- En la vista Navegador, edite el descriptor de despliegue del portlet (Contenido Web/WEB-INF/portlet.xml)
y efectúe los pasos siguientes:
- Migre a un descriptor de despliegue del portlet compatible estándar. Para obtener instrucciones,
consulte Migración de la API de portlet IBM, en el centro de información de WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
- Elimine EntryPortlet (su portlet) y todas sus referencias en el descriptor de despliegue del portlet.
- Añada el Jsr168EntryPortlet al descriptor de despliegue del portlet. Consulte el descriptor de despliegue del portlet
de un ejemplo de portlet JSR 168 portlet168 de HATS.
Migración de las transformaciones, las plantillas y los manejadores de macro
En la vista Proyectos de HATS, edite todos los archivos JSP de
transformaciones, plantillas y manejadores de macro en la pestaña Fuente:
- Añada el código siguiente:
- <%@ taglib uri="http://java.sun.com/portlet" prefix="portletAPI"
%>
- <portletAPI:defineObjects/>
- Convierta response.encodeUrl("...") a renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
- Convierta todas las apariciones de request a renderRequest.
Migración de los archivos específicos de HATS
- Importe todos los archivos desde la carpeta <directorio_instalación_compartido>\plugins\com.ibm.hats_nnn\predefined\projects\portlet\jsr a sus respectivas carpetas en el
proyecto de portlet (donde directorio_instalación_compartido es el
directorio de recursos compartidos donde se ha instalado la oferta de HATS mediante IBM Installation
Manager y nnn es la versión y el nivel de build de HATS).
- En la vista Navegador, suprima los archivos y carpetas siguientes, si existen:
- Los archivos HATSApplet.cab y HATSApplet.jar en la carpeta Contenido Web.
- La carpeta hatsadmin en la carpeta Contenido Web.
- El archivo hatsadmin.tld en la carpeta Contenido Web/WEB-INF/tld.
Migración de otras funciones de portal
- Si utiliza el inicio de sesión Express en Web
(WEL), es posible que tenga que cambiar las clases del plug-in WEL porque algunas clases de
plug-in para portlets IBM y portlets estándar son diferentes.
Por ejemplo, las clases del plug-in
WEL utilizadas en portlets de IBM son:
- Seguridad de red de WebSphere Portal: com.ibm.hats.common.wel.WebSpherePortalNS
- WebSphere Portal Credential
Vault Credential Mapper: com.ibm.eNetwork.security.sso.cms.CredentialVaultCM
Las clases de plug-in WEL utilizadas en portlets estándar son:
- Seguridad de red de WebSphere Portal: com.ibm.hats.common.wel.StandardPortletNS
- WebSphere Portal Credential
Vault Credential Mapper: com.ibm.hats.common.wel.StandardPortletCredentialVaultCM
- Si implementa una cámara de credenciales en la aplicación de portlet, debe migrar el código
que accede al servicio de cámara de credenciales. Si desea obtener más información, consulte
Autenticación de portlets, en el centro de información de WebSphere Portal
en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
- Si realiza una comunicación con el portlet, debe convertir el mecanismo de comunicación utilizado. Si desea obtener más información, consulte Comunicación de portlets.
Trabajo con portlets de HATS
Un proyecto de portlet de HATS sigue siendo un proyecto de HATS, lo que significa que
pueden seguir utilizándose en el proyecto todos los asistentes y editores de HATS. Un proyecto de portlet de HATS es también un proyecto de portlet, lo que también significa que se pueden utilizar todos los editores y la configuración de ejecución de las Herramientas de Portal en el proyecto. Un proyecto de portlet de HATS aparece en el árbol con un icono distinto
.
Alteraciones de parámetros de conexión y de variables globales
Puede permitir que se alteren los parámetros de conexión y las variables globales para sus portlets,
para ello tiene que personalizar los valores del proyecto. Si desea obtener más información, consulte Alteraciones de parámetros de conexión y Alteraciones de variables globales.
Portlets de IBM
En el caso de los portlets de IBM de HATS, si usted permite las alteraciones en los valores del proyecto, se pueden alterar ampliando la clase EntryPortlet y alterando el método doView(). Si desea obtener más información sobre la ampliación de
la clase EntryPortlet consulte la publicación HATS Web Application Programmer's Guide.
Portlets estándar
En el caso de los portlets estándar de HATS , si usted permite las alteraciones en los
valores del proyecto, el usuario puede alterar los parámetros de conexión y las variables globales
conmutando a la modalidad de edición desde la barra de herramientas de portlet. Para WebSphere Portal V6.0 y V6.1, seleccione Personalizar desde
el menú de portlet en la barra de herramientas.
Nota:
HATS no admite la modalidad de edición
de portlet en WebSphere Application Server V6.1 o v7.0. Si despliega el portlet estándar de HATS
para que se ejecute directamente en WebSphere Application Server V6.1 o V7.0, en lugar de utilizar la modalidad de edición de portlet, el usuario puede
alterar temporalmente los parámetros de conexión y las variables globales en el URL utilizado para acceder al portlet.
Una vez en la modalidad de edición de portlet, se muestra al usuario una página de valores.
Esta página permite que el usuario altere los valores de los parámetros de
conexión y de las variables globales. Estas funciones son equivalentes a las funciones de
HATS para las aplicaciones Web que permiten al usuario alterar los valores
utilizando el URL cuando el usuario accede por primera vez a la aplicación.
En la página de valores, en la sección de parámetros de conexión, la lista desplegable de parámetros de conexión
lista los parámetros de sesión de Host On-Demand
que usted ha permitido que se alteren en los valores del proyecto. El usuario establece una
alteración seleccionando un parámetro en la lista desplegable, especificando un valor en el campo
Valor y pulsando Añadir.
Por omisión, el valor de alteración se habilita cuando se añade por
primera vez. Pulse inhabilitarse seleccionando false en la
lista desplegable Habilitado. Se puede suprimir una alteración seleccionando el recuadro de selección situado
junto al nombre del parámetro y pulsando Suprimir.
En la sección de variables globales, el usuario establece una alteración
especificando un nombre y un valor de la variable global y pulsando
Añadir. Después de añadir una alteración, la
variable global puede identificarse como una variable global compartida seleccionando
true en la lista desplegable
Compartida.
Por omisión, el valor de alteración se habilita cuando se añade por
primera vez. Pulse inhabilitarse seleccionando false en la
lista desplegable Habilitado. Se puede suprimir una
alteración seleccionando el recuadro de selección situado junto al nombre de la
variable global y pulsando Suprimir.
Cuando el usuario pulsa Guardar y salir, los valores
se guardan en la preferencias del portlet.
Notas:
- Los valores que ha especificado el usuario no se validan.
- El usuario debe desconectar y reiniciar la aplicación de portlet para que
los nuevos valores tengan efecto.
Además de permitir a los usuarios establecer alteraciones, puede
proporcionar alteraciones mediante programación de los parámetros de conexión
y de las variables globales ampliando el portlet JSR 168 de HATS. Si desea obtener más información, consulte el apartado Extending
the Entry portlet, en la publicación HATS Web Application Programmer's Guide
Nota:
si proporciona alteraciones de los parámetros de
conexión y de la variables globales mediante la clase de portlet ampliada y el usuario
proporciona las mismas alteraciones utilizando la modalidad de edición de
portlet, los valores proporcionados por el usuario en la modalidad de edición alteran
los valores que usted haya proporcionado en la clase de portlet ampliada.
.
Comunicación de portlets
WebSphere Portal admite
numerosos modos para que los portlets intercambien o compartan información. Si desea obtener más
información, consulte la sección, Comunicación de portlets en el centro de información de WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp.
Esta sección describe el soporte de HATS para comunicación de portlets de WebSphere Portal.
Portlets de IBM
Los portlets de IBM de HATS soportan la implementación Pulsar-para-Acción
para proporcionar una solución de comunicación de portlets. Si desea obtener más información, consulte
Cooperative portlets, en la publicación HATS Web Application Programmer's Guide
Portlets estándar
El soporte de portlets estándar (JSR 168) de HATS utiliza el mecanismo de portlets cooperativos de WebSphere Portal para ofrecer una solución de comunicación de portlets.
Los portlets JSR 168 utilizan propiedades para comunicarse entre sí.
Un portlet JSR 168 de HATS soporta la capacidad de enviar y recibir propiedades
desde otros portlets JSR 168, sean de HATS o no.
Los portlets deben estar conectados para poder comunicarse.
Envío de una propiedad desde un portlet JSR 168 de HATS
- Crear una variable global que contenga el valor de la propiedad que va a enviarse. Puede hacerlo de varios modos incluyendo: ejecución de una acción Extraer variable global o una acciónEstablecer variable global. Sólo las variables
globales que pueden contener cero o más series (no otro tipo) pueden
ser utilizadas en la comunicación de portlets JSR 168. Las variables globales pueden
considerarse como lugares de almacenamiento de los valores de las propiedades de JSR 168.
- Añada una acción Enviar variable global a un suceso de pantalla de HATS o a una aplicación de pantalla que no coincida para enviar el valor de la variable global como una propiedad. Para obtener información sobre cómo hacerlo, consulte Acción Enviar variable global.
Esta acción puede utilizarse junto con la acción
Extraer variable global para enviar la entrada especificada por el usuario
de un portlet a otro. Por ejemplo, puede añadir una acción Extraer variable global entre la acción
Aplicar transformación y la acción Enviar variable global
para capturar los datos que especifica el usuario y enviarlos a los otros portlets.
- Cuando se ejecuta el proyecto de portlet JSR 168 de HATS y se ejecuta la acción Enviar variable global, el nombre de la propiedad y el contenido de las series de la variable global especificada se pasan a WebSphere Portal
que a su vez notifica a los portlets conectados a este portlet JSR 168 de HATS que deben recibir la propiedad.
Recepción de una propiedad en un portlet JSR 168 de HATS
- Utilice los valores del portlet para definir nombres de propiedades y las variables globales correspondientes para que contengan los valores de las propiedades que pueden ser recibidos por este portlet. Acceda a los valores del portlet desde el editor de valores de proyecto pulsando la pestañaOtros y después Portlet. Para obtener más información sobre cómo hacerlo, consulte Valores del portlet.
- Cuando WebSphere Portal
haya recibido una propiedad de un portlet de origen, se notificará al portlet de destino. El servicio de tiempo de ejecución de portlet JSR 168 de HATS recupera el valor de la propiedad desde WebSphere Portal
y lo almacena en la variable global especificada. De nuevo, con comunicación JSR 168 sólo pueden utilizarse variables globales que contengan una serie (o series).
Comunicación con portlets ajenos a JSR 168 de HATS
Rational SDP proporciona soporte de GUI para implementar los portlets cooperativos. A la hora
de configurar portlets ajenos a JSR 168 de HATS para que se comuniquen con portlets JSR 168 de HATS,
efectúe los pasos siguientes:
- Abra la vista Explorador de proyectos desde la barra de menús de Rational SDP seleccionando Ventana > Mostrar vista > Otras > General > Explorador de proyectos.
- En la vista Explorador de proyectos, pulse con el botón derecho del ratón en el nodo
Descriptor de despliegue del portlet bajo el proyecto de portlet.
- Seleccione Cooperativo > Habilitar este portlet para que
envíe datos (Origen) o Cooperativo > Habilitar este
portlet para que reciba datos (destino) para iniciar el asistente para habilitar el
soporte de portlets cooperativos para el portlet seleccionado.
- Asegúrese de que los valores siguientes son correctos en este asistente:
Edición del URI de tipo de datos
Cuando configura una acción Enviar variable global o el valor de un portlet, HATS
hace, por omisión, que el URI de tipo de datos para la propiedad sea
http://com.ibm.hats.portlet.pb#<nombre_propiedad>Type. Este URI sólo se
utiliza cuando conecta los portlets de origen y de destino. WebSphere Portal precisa que los portlets de origen y de destino utilicen
el mismo URI para enviar y recibir la propiedad. Si por algún motivo, necesita
configurar el URI de forma distinta al valor por omisión, puede modificarlo
para una propiedad siguiendo estos pasos en Portal Toolkit:
- Abra la vista Explorador de proyectos desde la barra de menús de Rational SDP seleccionando Ventana > Mostrar vista > Otras > General > Explorador de proyectos.
- En la vista Explorador de proyectos, amplíe el proyecto hasta que se muestre la
propiedad que desea modificar. Las propiedades pueden encontrarse bajo el nodo
Descriptor de despliegue del portlet.
- Pulse con el botón derecho del ratón en la propiedad y seleccione Editar tipo de datos.
- Modifique el URI de tipo de datos en los asistentes Editar origen
cooperativo o Editar destino cooperativo.
Conexión de portlets para comunicación
Las conexiones de portlets se utilizan para dirigir el flujo de información entre portlets
que se comunican utilizando la API de portlets cooperativos de WebSphere Portal. La conexión de portlets hace referencia a la conexión de dos portlets utilizando la herramienta de conexión del servidor del portal para enviar y recibir una propiedad de un portlet cooperativo. Los portlets sólo se conectan para una única propiedad y
ambos portlets deben dar a esta propiedad el mismo nombre, aunque los nombres de las variables globales asociadas pueden ser diferentes. En otras palabras, si dos portlets van a enviar y recibir dos propiedades, necesitan dos conexiones que los unan, una para cada propiedad. Si no se completa el paso de conexión no se transmiten los datos.
PDT personalizados y tablas personalizadas
Antes de desplegar un proyecto de portlet con una tabla de definiciones de
impresora (PDT) personalizada o tablas personalizadas en un Portal Server, debe copiar
los archivos y carpetas en el directorio \Contenido Web del proyecto de portlet de HATS. A continuación
se muestran los archivos o carpetas para cada tipo de incorporación:
- Tabla de definiciones de impresora (PDT) personalizada: archivos PDT compilados o
las carpetas que contienen los archivos PDT compilados.
- Tabla personalizada: la carpeta personalizable que contiene la definición de las tablas personalizadas.
Web Services for Remote Portlets (WSRP)
Web Services for Remote Portlets (WSRP) es un estándar que los portales pueden utilizar
para proporcionar los portlets, las aplicaciones y el contenido como servicios WSRP, además otros
portales pueden integrar los servicios WSRP como portlets remotos para sus usuarios.
Los portlets estándar y de IBM de HATS pueden proporcionarse como portlets remotos que
pueden ser utilizados por otros portales. Si desea obtener más información consulte el
centro de información de WebSphere
Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp y busque
Utilización de los servicios de WSRP.
Prueba de portlets de HATS
Si un entorno de prueba de WebSphere Portal se configura en Rational SDP,
puede utilizarlo para probar los portlets estándar o de IBM de HATS antes de desplegarlos en un servidor Portal de producción.
Puede probar también los portlets estándar de HATS utilizando el entorno de prueba local de WebSphere Application Server V6.1 o V7.0, según sea necesario, antes de desplegarlos.
Para probar un portlet de HATS, utilice el mismo procedimiento empleado para probar proyectos Web de HATS. Si desea obtener más información, consulte Visión general.
Exportación de portlets de HATS
Si desea exportar un portlet de HATS para desplegarlo, en la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Exportar proyecto.
Especifique el nombre del archivo de destino para el archivo .war exportado en el desplegable Destino y pulse Finalizar. Sólo se exporta el archivo .war.
El archivo .ear se utiliza únicamente para efectuar pruebas en el entorno de prueba local.
Después de exportar el archivo .war del portlet de HATS, se instala en
WebSphere Portal mediante las herramientas de administración de WebSphere Portal.
Si va a instalar un portlet estándar en
WebSphere Application Server V6.1 o V7.0, tiene que utilizar la consola administrativa de WebSphere Application Server y tener en cuenta las instrucciones siguientes:
- Durante la instalación, debe proporcionar un nombre raíz de contexto. Este nombre raíz de contexto es necesario para iniciar el archivo .war del portlet al finalizar la instalación. Durante la instalación, despliegue el archivo .war
al servidor1 a la instancia de servidor web definida.
- Después de instalar el archivo .war del portlet, puede comprobar el nombre raíz
de contexto y el nombre del portlet utilizando la consola administrativa WebSphere Application Server ampliando Aplicaciones y pulsando Aplicaciones empresariales. Pulse en su archivo .war
y después pulse Raíz de contexto para módulos Web.
Anote el valor para el módulo Web y ContextRoot. Estos valores se utilizan
para iniciar la aplicación HATS.
- Para ejecutar la aplicación HATS, escriba su URL en un navegador. Por ejemplo, escriba
http://host:puerto/nombre_raíz_contexto/nombre_portlet
donde host y puerto representan el nombre sistema principal
y el puerto para el sistema principal WebSphere Application Server donde ha instalado el portlet. Para nombre_raíz_contexto,
utilice el valor proporcionado para Raíz de contexto al instalar el archivo .war del portlet, y para nombre_portlet, utilice el valor proporcionado para el módulo Web.
Administración de portlets de HATS
Puede administrar los portlets de HATS mediante la consola administrativa
de HATS. Los portlets estándar de HATS, independientemente de si están
instalados en Portal Server o WebSphere Application Server, pueden administrarse utilizando una aplicación administrativa de
HATS autónoma. Los portlets de IBM de HATS pueden administrarse utilizando una aplicación administrativa de
HATS autónoma o el soporte para consola administrativa incluido en el propio portlet.
Utilización de una aplicación administrativa de HATS autónoma
Para administrar los portlets estándar de HATS y los portlets de IBM de HATS mediante una aplicación administrativa de HATS autónoma, siga estos pasos:
- Cree un proyecto administrativo de HATS autónomo en HATS Toolkit seleccionando
Archivo > Nuevo > Proyecto > HATS > Proyecto de administración de HATS.
El proyecto administrativo de HATS sólo aparece en HATS Toolkit en la pestaña
Navegador.
- Para exportar el proyecto .ear administrativo de HATS a un archivo .ear pulse el botón derecho del ratón
en el proyecto .ear y seleccione Exportar > Java EE > Archivo EAR.
- Despliegue el archivo .ear para la aplicación administrativa de HATS autónoma
a WebSphere Application Server utilizando la consola administrativa de WebSphere Application Server.
Notas:
- Instale el archivo .ear en el mismo sistema WebSphere Application Server que el servidor WebSphere Portal.Cuando se instale un portlet de HATS estándar directamente en WebSphere Application Server,
instale el archivo .ear en el mismo servidor.
- Asegúrese de que el módulo está correlacionado con WebSphere Application Server, por ejemplo, server1, y no con el servidor WebSphere Portal.
- Para WebSphere Application Server V6.x, asegúrese de que la opción Todos autenticados
del panel Correlacionar roles de seguridad con usuarios y grupos
está seleccionada para el rol de administrador de HATS. Para WebSphere Application Server V7.x, asegúrese de que la opción Todos autenticados en el campo de la aplicación
está seleccionada utilizando el menú despleglable Correlacionar sujetos especiales del panel Correlacionar roles de seguridad con usuarios y grupos.
- El ID de usuario utilizado para administrar los portlets se debe definir como un
usuario de la consola administrativa de WebSphere
Application Server con la autoridad de Administrador. Para ello, siga estos pasos:
- En la consola administrativa de WebSphere Application Server, seleccione Usuarios y grupos > Roles de usuario administrativo > Añadir (para versiones anteriores a WebSphere
Application Server V6.1, seleccione Administración del sistema
> Valores de consola > Usuarios de consola > Añadir).
- Escriba el ID de usuario utilizado para administrar los portlets y correlacione el ID de usuario
con el rol de Administrador.
Nota:
- Inicie la aplicación administrativa de HATS mediante la consola administrativa de WebSphere Application Server.
- Acceda a la consola administrativa de HATS autónoma. Por ejemplo, utilice el
URL, http://<nombresistppalwas>/<nombreproyectoadminhats>/hatsadmin/admin.
Nota:
al acceder a la consola administrativa de HATS, debe utilizar un navegador diferente
del que se está utilizando para acceder a los portlets.
- Seleccione Cómo empezar > Ámbito de gestión.
- Pulse Nuevo.
- En el campo Sistema principal especifique el mismo nombre de sistema principal
que el del sistema principal del sistema principal WebSphere Application Server de destino.
- En el campo Puerto especifique el puerto BOOTSTRAP_ADDRESS
del servidor de destino. Para encontrar el puerto BOOTSTRAP_ADDRESS
del servidor de destino, acceda a la consola administrativa de WebSphere Application Server y siga estos pasos:
- Seleccione Servidores > Servidores de aplicaciones.
- Pulse su servidor de destino (servidor de WebSphere Portal o WebSphere Application Server, por ejemplo, servidor1,
cuando haya instalado un portlet de HATS directamente en WebSphere Application Server.
- En la pestaña Configuración, bajo Comunicaciones, amplíe
Puertos.
- Anote el puerto BOOTSTRAP_ADDRESS para su servidor de destino.
- Pulse Aceptar.
- Seleccione el sistema principal recién añadido.
- No seleccione Gestionar todas las aplicaciones dentro del ámbito seleccionado más arriba.
- Ahora puede ver una lista de los portlets de HATS. Utilice la consola administrativa de HATS para administrar una aplicación de portlet cada vez seleccionando una de esta lista.
Utilización del soporte administrativo incluido en el portlet
Para administrar los portlets de
IBM de HATS
mediante un portlet que incluya soporte para consola administrativa de HATS, siga los pasos que aparecen
abajo.
Nota:
Esta acción no está soportada para los portlets estándar de HATS.
- Cree un proyecto de portlet de IBM de HATS
en HATS Toolkit seleccionando Archivo > Nuevo > Proyecto de HATS. En el
asistente Crear un proyecto para el portlet de IBM, seleccione
la opción Añadir soporte para consola administrativa.
- Exporte el proyecto de portlet a un archivo .war, para ello pulse con el botón derecho del ratón en el proyecto
en la vista Proyectos de HATS y seleccione Exportar proyecto.
- Despliegue el archivo .war para el portlet de IBM de HATS en el servidor WebSphere Portal.
- Acceda a la consola administrativa de WebSphere Application Server donde está instalado el servidor WebSphere Portal.
- Seleccione Aplicaciones > Enterprise Applications.
- Pulse el nombre del portlet administrativo de HATS, después pulse Ver descriptor de despliegue.
- Anote el PA_valor del descriptor de despliegue,
por ejemplo, PA_#uaj0rfu (WebSphere Portal
V6.0) o PA_nombreproyecto (WebSphere Portal
V6.1).
- Seleccione Servidores > Servidores de aplicaciones.
- Pulse el servidor WebSphere Portal, en la pestaña Configuración, bajo
Comunicaciones, amplíe Puertos.
- Anote el puerto BOOTSTRAP_ADDRESS de su servidor Portal.
- Acceda a la consola administrativa de HATS incluida en el portlet mediante
el PA_valor que anotó antes del descriptor de despliegue. Por ejemplo, utilice el URL, http://<nombresistppalportal>/wps/PA_valor/hatsadmin/admin.
Nota:
al acceder a la consola administrativa de HATS, debe utilizar un navegador diferente
del que se está utilizando para acceder a los portlets.
- Seleccione Cómo empezar > Ámbito de gestión.
- Pulse Nuevo, en el campo
Sistema principal especifique el mismo nombre de sistema principal que
el sistema principal del servidor WebSphere
Portal, y en el campo Puerto especifique el puerto
BOOTSTRAP_ADDRESS del servidor WebSphere Portal que anotó antes.
Pulse Aceptar.
- Seleccione el sistema principal recién añadido.
- No seleccione Gestionar todas las aplicaciones dentro del ámbito seleccionado más arriba.
- Ahora puede ver una lista de los portlets de HATS. Utilice la consola administrativa de HATS para administrar la aplicación de portlet en la que está incluida la consola.
Consideraciones y limitaciones de portlets de HATS
Consideraciones y limitaciones comunes
A continuación se muestra una lista de factores a tener en cuenta y las limitaciones al
trabajar con los portlets de IBM
de HATS o los portlets estándar de HATS:
- Los portlets sólo pueden instalarse en producción como archivos de aplicación Web
(archivos .war). HATS sólo tiene un proyecto por cada archivo .war, por lo tanto, no puede exportar
un conjunto de aplicaciones de HATS como una sola aplicación de portlet.
- Los cookies son necesarios para la autenticación dentro de WebSphere Portal, por tanto debe ejecutar HATS en WebSphere Portal con los cookies habilitados.
- Los archivos JSP, como plantillas, transformaciones, fragmentos de transformación y
manejadores de macro, si se copian desde proyectos Web de HATS a proyectos de portlet de
IBM de HATS
o a proyectos de portlet estándar de HATS, no funcionarán sin conversión. Puede utilizar la
acción Convertir JSP para Portal para convertir estos archivos
JSP. De forma similar, los archivos JSP copiados desde proyectos de portlet de
IBM de HATS
a proyectos de portlet estándar de HATS, o viceversa, deben convertirse utilizando la
acción Convertir JSP para Portal.
- Las opciones de HATS aparecen en el asistente Nuevo portlet de Rational SDP, pero al seleccionar estas opciones
sólo se genera un portlet vacío sin recursos de HATS.
- Los portlets estándar IBM y de HATS no pueden ejecutarse en la misma página de portal
sin interferir entre ellos. Cualquier entrada o acción ejecutada en el portlet estándar
es transferida o heredada por el portlet de IBM. Para obtener más detalles sobre las diferencias
entre el manejo de los parámetros de petición de IBM y estándar, consulte el centro de información de
WebSphere Portal en http://publib.boulder.ibm.com/infocenter/wpdoc/v6r1m0/index.jsp
y busque Manejo y visibilidad de los parámetros de solicitud en los portlets.
- Cuando un portlet de HATS está en la misma página de portal con otros portlets
(de HATS o ajenos a HATS), si desconecta el portlet de HATS, se reinicia automáticamente
como resultado de la renovación de la página que se produce cuando interactúa con cualquier otro portlet de la misma página de portal.
Los portlets IBM de HATS muestran este comportamiento cuando el tema se establece en el valor por omisión, Heredado.
Los portlets estándar de HATS muestran este comportamiento cuando el tema de la página de portal se establece en, PortalWeb2.
- Las funciones, acciones y valores siguientes de HATS no están soportados en los portlets de HATS:
- La función Vista previa en el Page Designer al editar transformaciones y plantillas.
- El valor Habilitar compresión HTTP.
- El applet actualización asíncrona.
- El parámetro de conexión disconnectOnClose.
- La opción de combinación de pantallas, utilizar carga de contenido dinámico, en antememoria.
- La interoperatividad de HATS con aplicaciones de WebFacing.
Consideraciones y limitaciones de portlets de IBM
A continuación se muestra una lista de factores a tener en cuenta y las limitaciones
al trabajar con los portlets de
IBM
de HATS:
- La API de Portlet de IBM
se ha desechado en HATS V7.5.1 y en WebSphere Portal
V6.0 y V6.1.
- Los portlets IBM
de HATS sólo pueden ejecutarse en servidores WebSphere
Portal. Por ejemplo, no puede ejecutar directamente los portlets de IBM de HATS en WebSphere Application Server.
- La acción Reenviar a URL y la función
Insertar Reenviar a aplicación HATS. Las aplicaciones de HATS que utilizan
control de flujo JSP no funcionan correctamente en los portlets de IBM de HATS. Los portlets IBM son entidades dirigidas por servlets y requieren el uso de acciones codificadas en URL para dirigir la navegación.
Consideraciones y limitaciones de portlets estándar
A continuación se muestra una lista de factores a tener en cuenta y las limitaciones
al trabajar con los portlets de estándar de HATS:
- Los portlets estándar de HATS sólo pueden ejecutarse en servidores WebSphere Portal o en WebSphere Application Server V6.1 o V7.0.
- Si añade soporte de inicio de sesión Express en Web (WEL) a un portlet estándar de HATS utilizando el plug-in WebSphere Portal Credential Vault, se ejecutará en los servidores WebSphere Portal
soportados. Sin embargo, no podrá iniciar sesión en el sistema principal cuando se ejecute en WebSphere Application Server v6.1 o v7.0, los cuales no tienen soporte de Credential
Vault Service.
- Las acciones, valores y funciones siguientes de HATS no están soportados en los portlets estándar de HATS:
- La capacidad de añadir soporte para consola administrativa de HATS al proyecto de portlet.
- La capacidad de generar código de ejemplo en el asistente Nueva lógica empresarial
para funciones como acceder y recuperar datos de autenticación, mensajería de portlets o
el uso de Property Broker.
- La acción de Presentación portlets (Añadir delimitador de bloque).
- Cuando se utiliza la acción Enviar variable global, las acciones siguientes son las únicas
soportadas entre la acción Aplicar transformación y la acción Enviar variable global:
- Ejecutar lógica empresarial
- Extraer variable global
- Insertar datos
- Establecer variable global
- Eliminar variable global
- Realizar una transacción de macro
- Pausa
- Cuando se utilizan objetos de integración:
- Cuando se visualizan las conexiones de sistema principal activas mediante la
consola administrativa de HATS, la conexión de cliente para un portlet estándar de HATS muestra
una dirección IP en blanco.