Configuración de portlets JSR 168

Para configurar un portlet JSR 168, abra el editor de descriptor de despliegue de portlet, seleccione el portlet en el recuadro de lista Portlets y especifique los valores siguientes.

Tabla 1. Clase de portlet
Nombre de propiedad Descripción
Clase de portlet Nombre canónico del portlet seleccionado en la lista Portlets. Seleccione el botón Examinar para abrir el diálogo Seleccionar portlet y crear una correlación nueva en el descriptor de despliegue. Se utiliza en el nodo <portlet-class>.
Tabla 2. Localización (traducción) de los valores del descriptor de despliegue
Nombre de propiedad Descripción
Idioma Información sobre el entorno local que se utiliza en el atributo xml:lang para localizar el Nombre de visualización y la Descripción. El valor por omisión del atributo xml:lang es inglés en). Se utiliza en el atributo xml:lang de <display-name> y en <description> de <portlet>.
Nombre de visualización Nombre administrativo que se utiliza para identificar el portlet. Sólo se muestra en las herramientas del GUI. Se utiliza en <display-name> de <portlet>.
Descripción Texto descriptivo sobre el portlet. Este texto no se muestra a los usuarios finales. Se utiliza en <description> de <portlet>.
Tabla 3. Información de portlet específica de idioma
Nombre de propiedad Descripción
Paquete de recursos Para proporcionar información de portlet específica de idioma, como título y palabras clave, se utilizan paquetes de recursos. Establece el nombre de clase totalmente calificado del paquete de recursos. Se utiliza en <resource-bundle>.
Entornos locales soportados Declara los entornos locales que el portlet soporta durante la ejecución. Se utiliza en <supported-locale>, y para localizar el archivo de paquetes de recursos para cada entorno local.
Información de portlet Especifica la información de portlet siguiente para cada entorno local soportado. Seleccione uno de los entornos locales anteriores y especifique la información de portlet para el entorno local seleccionado. La información especificada se guardará en archivos de paquetes de recursos.
Título
Título que se debería visualizar en la barra de título del portlet. Sólo se permite un título por entorno local. Tenga en cuenta que el portal puede alterar temporalmente este título, y también el portlet mediante programación. Se utiliza en <title> en <portlet-info> para el entorno local por omisión y en javax.portlet.title en el archivo de paquetes de recursos específico de idioma para otros entornos locales.
Título corto
Versión corta del título que se puede utilizar para dispositivos con capacidad de visualización limitada. Sólo se permite un título corto por cada entorno local. Se utiliza en <short-title> en <portlet-info> para el entorno local por omisión y en javax.portlet.short-title en el archivo de paquetes de recursos específico de idioma para otros entornos locales.
Palabras clave
Palabras clave que describen la funcionalidad del portlet. Los Portal que permiten al usuario buscar portlets basados en palabras clave pueden utilizarlas. Se permiten varias palabras clave para cada entorno local, pero deben separarse por comas ,). Se utilizan en <keywords> en <portlet-info> para el entorno local por omisión y en javax.portlet.keywords en el archovo de paquetes de recursos específico de idioma para otros entornoslocales.
Tabla 4. Definición de soporte de modalidades de portlet
Nombre de propiedad Descripción
Modalidades soportadas Modalidades de portlet que el portlet puede manejar para cada tipo de marcación que soporta. Todos los portlets deben tener soporte para la modalidad portlet VIEW. El portlet no se debe invocar en una modalidad portlet que no se haya declarado como 'soportada' para un tipo de marcación dado. El contenedor del portlet ignorará todas las referencias a modalidades de portlet personalizadas que no tengan soporte en la implementación de portal, o que no tengan correlación con modalidades de portlet con soporte en portal.
Tipo MIME
Tipo MIME que el portlet soporta. Se utiliza en <mime-type> de <supports>.
Marcación
Tipo de marcación que el portlet soporta. Se utiliza en <init-param> para definir la propiedad: wps.markup. Es una propiedad de marcación de extensión de IBM que permite al portlet acceder al tipo de marcación, que es una definición más refinada de la marcación a devolver que el tipo MIME. Por ejemplo, HTML y cHTML tienen el tipo MIME text/html, pero tienen la marcación html y chtml para permitir que el portlet genere distinta salida para los casos HTML y cHTML. Para obtener más información sobre esta extensión de IBM, consulte Desarrollo de portlets utilizando JSR 168 y WebSphere Portal V5.02
Modalidades de portlet
Modalidades de portlet que el portlet puede manejar para el tipo de marcación especificado por el tipo MIME. Las modalidades de de portlet estándar (VIEW, EDIT o HELP). Se utilizan en <portlet-mode> de<supports>.
Tabla 5. Parámetros de inicialización
Nombre de propiedad Descripción
Inicialización Especifica los parámetros de inicialización del portlet. Pulse los botones Añadir o Eliminar para añadir o eliminar parámetros de inicialización como pares nombre/valor. Seleccione un parámetro y pulse el botón Editar para actualizar el parámetro con su valor. Se utiliza en <init-param>.
Tabla 6. Seguridad programada
Nombre de propiedad Descripción
Referencias de cometido de seguridad Especifica las referencias en los roles de seguridad. Pulse los botones Añadir, Eliminar o Editar para añadir, eliminar o actualizar una referencia en los roles de seguridad. En el elemento <security-role-ref> se definen los subelementos siguientes.
Nombre de rol
Cadena que especifica el nombre del rol que hace referencia a un rol de seguridad de la aplicación. Los portlets deben utilizar este nombre de rol para determinar si el usuario autenticado está incluido en un rol de seguridad de la aplicación. Se utiliza en <role-name>.
Enlace de rol
Cadena que especifica el nombre del rol de seguridad de la aplicación con el que se puede correlacionar el usuario. Este rol de seguridad se debe definir en el descriptor de despliegue Web. Si especifica un rol de seguridad que ya se ha definido en el descriptor de despliegue Web, puede seleccionarlo en la lista. Se utiliza en <role-link>.
Idioma
Idioma en que se escribe la descripción. Se utiliza como xml:lang en<description>.
Descripción
Texto descriptivo sobre este rol de seguridad. Se utiliza en <description>.
Por ejemplo, para correlacionar la referencia de rol de seguridad FOO al rol de seguridad con el nombre de rol manager, especifique FOO en el campo Nombre de rol y manager en el campo Enlace de rol. En este caso, si el portlet que ha invocado un usuario perteneciente al rol de seguridad manager ha realizado la llamada a la API isUserInRole("FOO"), el resultado será true.

Caching

La colocación de contenido en antememoria ayuda alos usuarios a mejorar el tiempo de respuesta de Portal. Tembién ayuda a reducir la carga en los servidores. La especificación de portlet define un mecanismo de caducidad basado en antememoria. Este mecanismo de antememoria es por portlet y por cliente usuario. El contenido de la antememoria no debe compartirse entre distintos clientes usuarios que visualicen el mismo portlet.

En un entorno donde se utiliza un servidor proxy remoto para la colocación en antememoria, los portlets compatibles conJSR 168 pueden indicar los valores de antememoria que utiliza el servidor para determinar la forma en que la página se pone en antememoria en un servidor proxy remoto.

Tabla 7. Colocación en antememoria
Nombre de propiedad Descripción
Antememoria de caducidad Define un mecanismo de colocación en antememoria basado en la caducidad. La selección siguiente se utiliza para establecer el valor de la propiedad de caducidad <expiration-cache>.
Siempre caduca
La colocación en antememoria se inhabilita para el portlet. Esto establecerá la propiedad de caducidad en 0.
No caduca nunca
La antememoria no caduca. Esto establecerá la propiedad de caducidad en -1.
Caduca una vez transcurridos los segundos especificados
Duración (en segundos) de la antememoria de caducidad.
Antememoria remota También deben proporcionarse valores adicionales mediante una extensión de descriptor de despliegue (ibm-portlet-portal-ext.xmi). El portlet indica si la antememoria remota es compartida o no compartida utilizando el elemento <remote-cache-scope> del archivo de extensión.
Antememoria remota dinámica
Si la ventana del portlet no modifica los valores de la antememoria durante la ejecución, este recuadro de selección deberá estar deseleccionado. Este valor optimiza el rendimiento e informa al contenedor del portlet de que no necesita esperar a que la ventana del portlet publique información sobre la antememoria remota. El comportamiento por omisión de este valor (el recuadro de selección está seleccionado) indica que la ventana del portlet no publica información sobre la antememoria remota.
Ámbito de antememoria remota
compartida indica que la antememoria remota está compartida.

Preferencias de portlet

Los portlets se suelen configurar de forma que proporcionen una vista o un comportamiento personalizados para cada usuario. Esta configuración se representa como un conjunto persistente de pares nombre-valor y se le hace referencia como preferencias de portlet. Las preferencias de portlet están pensadas para almacenar datos de configuración básica para portlets. No es objetivo de las preferencias de portlet sustituir bases de datos de propósito general.

Nombre de propiedad Descripción
Almacén de preferencias persistentes Especifica las preferencias de portlet. Especifica los elementos de una preferencia. Se incluye en un atributo <preference>.
Nombre
Nombre de la preferencia. Se utiliza en <name> de <preference>.
Valores
Valores por omisión iniciales de la preferencia. Se utilizan en <value> de<preference>.
Sólo lectura
Marque el recuadro de selección Read only (sólo lectura) para fijar esta preferencia en tiempo de despliegue. Si no se selecciona, la preferencia se puede modificar cuando el portlet esté procesando una petición de acción en cualquiera de las modalidades de portlet estándar (VIEW, EDIT o HELP). Esta selección establecerá el elemento <read-only> en true, en <preference>.
Seleccione una clase de validador de preferencia
Clase de validador
Especifique una clase que implemente la interfaz PreferencesValidator para validar el conjunto de valores de preferencia del objeto PortletPreferences. Edite el campo Clase de validador o pulse el botón Examinar para seleccionar el validador de preferencia. Se utiliza en el atributo <preference-validator> del atributo <portlet-preferences>.

Conceptos relacionados
API de portlet
Creación de portlets y proyectos de portlet
Trabajo con descriptores de despliegue de portlet

Tareas relacionadas
Creación, adición, eliminación o edición de portlets
Definición de restricciones de seguridad de portlet
Definición de modalidades de portlet personalizadas
Definición de estados de ventana personalizados
Definición de atributos de usuario
Definición de extensiones

Referencia relacionada
Referencias

(C) Copyright IBM Corporation 2002, 2005. Reservados todos los derechos.