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 portletNombre 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 despliegueNombre 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 predeterminado 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 idiomaNombre 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 predeterminado 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 predeterminado 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 predeterminado y en javax.portlet.keywords en el archivo de paquetes de recursos específico de idioma para otros entornoslocales.
|
Tabla 4. Definición de soporte de modalidades de portletNombre 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ónNombre 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 programadaNombre 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 a los usuarios a mejorar el tiempo de respuesta de Portal. Tambié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 con JSR 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 antememoriaNombre 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 predeterminado 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 predeterminados 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>.
|