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:

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:

En el asistente Crear un proyecto, en el panel Proyecto de HATS:

  1. Escriba el nombre del proyecto de portlet.
  2. De manera opcional, especifique una descripción.
  3. Acepte la ubicación por omisión.
  4. 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.
  5. Para el campo Servidor de destino, seleccione uno de los servidores WebSphere Portal admitidos, WebSphere Portal v6.0 o WebSphere Portal v6.1.
    Notas:
    1. 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.
    2. Los portlets estándar destinados para WebSphere Portal v6.1 también pueden ejecutarse en WebSphere Application Server v6.1 o v7.0.
  6. 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.
  7. 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.
  8. 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.
  9. 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:

  1. Escriba el nombre del proyecto de portlet.
  2. En el campo Servidor de destino, seleccione el servidor WebSphere Portal de destino, WebSphere Portal v6.0 o WebSphere Portal v6.1.
    Notas:
    1. 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.
    2. 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.
    3. 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.
  3. 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.
  4. 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.
  5. Seleccione en esta lista los tipos de archivos que se convertirán automáticamente:
  6. 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:
  1. 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.
  2. 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.
  3. No puede volver a convertir un proyecto de portlet HATS en un proyecto Web de HATS.
  4. 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:

  1. Migración de las facetas del proyecto.
  2. Migración de los archivos descriptores de despliegue Web y del portlet.
  3. Migración de las transformaciones, las plantillas y los manejadores de macro.
  4. Migración de los archivos específicos de HATS.
  5. Migración de otras funciones de portal (opcional).

Migración de las facetas del proyecto

  1. Si está incluida, elimine la faceta Struts ya que los portlets JSR estándar de HATS no soportan Struts.
    1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Propiedades.
    2. En la página Propiedades, pulse Facetas de proyecto.
    3. Si está seleccionado, anule la selección del recuadro de selección Struts para portlets de IBM.
    4. Pulse Aceptar.
  2. Sustituya la faceta de portlets de IBM por la faceta de portlets JSR.
    1. En la vista Proyectos de HATS, pulse con el botón derecho del ratón en el proyecto de portlet y seleccione Propiedades.
    2. En la página Propiedades, pulse Facetas de proyecto.
    3. 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.
    4. Pulse Aceptar.

Migración de los archivos descriptores de despliegue Web y del portlet

  1. En la vista Navegador, edite el descriptor de despliegue Web (Contenido Web/WEB-INF/web.xml) y efectúe los pasos siguientes:
    1. En la pestaña Servlets, elimine los servlets y las correlaciones yourportlet (su portlet) y HATSAdminServlet (si existe).
    2. 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.
    3. 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	
  2. En la vista Navegador, edite el descriptor de despliegue del portlet (Contenido Web/WEB-INF/portlet.xml) y efectúe los pasos siguientes:
    1. 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.
    2. Elimine EntryPortlet (su portlet) y todas sus referencias en el descriptor de despliegue del portlet.
    3. 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:

  1. Añada el código siguiente:
  2. Convierta response.encodeUrl("...") a renderResponse.encodeUrl(renderRequest.getContextPath()+"...").
  3. Convierta todas las apariciones de request a renderRequest.

Migración de los archivos específicos de HATS

  1. 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).
  2. En la vista Navegador, suprima los archivos y carpetas siguientes, si existen:
    1. Los archivos HATSApplet.cab y HATSApplet.jar en la carpeta Contenido Web.
    2. La carpeta hatsadmin en la carpeta Contenido Web.
    3. El archivo hatsadmin.tld en la carpeta Contenido Web/WEB-INF/tld.

Migración de otras funciones de portal

  1. 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:

    Las clases de plug-in WEL utilizadas en portlets estándar son:

  2. 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.
  3. 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 icono de carpeta de portlet.

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:
  1. Los valores que ha especificado el usuario no se validan.
  2. 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
  1. 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.
  2. 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.

  3. 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
  1. 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.
  2. 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:

  1. Abra la vista Explorador de proyectos desde la barra de menús de Rational SDP seleccionando Ventana > Mostrar vista > Otras > General > Explorador de proyectos.
  2. 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.
  3. 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.
  4. 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:

  1. Abra la vista Explorador de proyectos desde la barra de menús de Rational SDP seleccionando Ventana > Mostrar vista > Otras > General > Explorador de proyectos.
  2. 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.
  3. Pulse con el botón derecho del ratón en la propiedad y seleccione Editar tipo de datos.
  4. 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:

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:

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:

  1. 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.
  2. 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.
  3. 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:
    1. 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.
    2. Asegúrese de que el módulo está correlacionado con WebSphere Application Server, por ejemplo, server1, y no con el servidor WebSphere Portal.
    3. 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.
  4. 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:
    1. 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).
    2. Escriba el ID de usuario utilizado para administrar los portlets y correlacione el ID de usuario con el rol de Administrador.
    Nota:
    Si desea obtener más información, consulte Consola administrativa de HATS y seguridad de WebSphere.
  5. Inicie la aplicación administrativa de HATS mediante la consola administrativa de WebSphere Application Server.
  6. 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.
    1. Seleccione Cómo empezar > Ámbito de gestión.
    2. Pulse Nuevo.
    3. 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.
    4. 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:
      1. Seleccione Servidores > Servidores de aplicaciones.
      2. 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.
      3. En la pestaña Configuración, bajo Comunicaciones, amplíe Puertos.
      4. Anote el puerto BOOTSTRAP_ADDRESS para su servidor de destino.
    5. Pulse Aceptar.
    6. Seleccione el sistema principal recién añadido.
    7. No seleccione Gestionar todas las aplicaciones dentro del ámbito seleccionado más arriba.
    8. 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.

  1. 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.
  2. 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.
  3. Despliegue el archivo .war para el portlet de IBM de HATS en el servidor WebSphere Portal.
  4. Acceda a la consola administrativa de WebSphere Application Server donde está instalado el servidor WebSphere Portal.
    1. Seleccione Aplicaciones > Enterprise Applications.
    2. Pulse el nombre del portlet administrativo de HATS, después pulse Ver descriptor de despliegue.
    3. Anote el PA_valor del descriptor de despliegue, por ejemplo, PA_#uaj0rfu (WebSphere Portal V6.0) o PA_nombreproyecto (WebSphere Portal V6.1).
    4. Seleccione Servidores > Servidores de aplicaciones.
    5. Pulse el servidor WebSphere Portal, en la pestaña Configuración, bajo Comunicaciones, amplíe Puertos.
    6. Anote el puerto BOOTSTRAP_ADDRESS de su servidor Portal.
  5. 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.
    1. Seleccione Cómo empezar > Ámbito de gestión.
    2. 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.
    3. Seleccione el sistema principal recién añadido.
    4. No seleccione Gestionar todas las aplicaciones dentro del ámbito seleccionado más arriba.
    5. 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:

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:

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: