AEM Portals y portlets de la red aem-portals-and-portlets

Este documento describe lo siguiente:

AEM Arquitectura de portal de aem-portal-architecture

AEM La arquitectura del portal de datos incluye definiciones de portales y portlets.

¿Qué es un portal? what-is-a-portal

Un portal es una aplicación web que proporciona personalización, inicio de sesión único, integración de contenido de diferentes fuentes y aloja la capa de presentación de los sistemas de información.

AEM Puede ejecutar portlets compatibles con JSR 286 en la interfaz de usuario de. El componente portlet permite incrustar un portlet en la página. AEM Consulte Administración del portlet de contenido de la.

¿Qué es un portlet? what-is-a-portlet

Los portlets son componentes web implementados dentro de un contenedor que generan contenido dinámico. La interfaz del portlet se empaqueta e implementa como un archivo .war dentro de un contenedor de portlet. AEM Si está ejecutando el portlet como un portal, necesita el archivo .war del portlet para ejecutar el portlet.

AEM AEM Para configurar el contenido de la para que aparezca en un portal, consulte Instalación, configuración y uso de los elementos de un portlet.

AEM Portal Director de aem-portal-director

AEM Administración del portlet de contenido de la administering-the-aem-content-portlet

AEM AEM El portlet de contenido le permite mostrar el contenido de la aplicación en un portal. El portlet está disponible en /crx-quickstart/opt/portal y se puede personalizar de varias formas. AEM Por ejemplo, puede personalizar la administración de SSO/autenticación implementando su propio servicio de autenticación y generando la información de autenticación necesaria para que los usuarios sobrescriban el comportamiento predeterminado. Los complementos utilizan una API definida que le permite añadir su propia funcionalidad creando el complemento con la API. El complemento se puede implementar en el portlet en ejecución. AEM Para funcionar correctamente, necesita una configuración de la instancia de autor y publicación de la junto con la ruta de contenido para mostrarla al inicio.

Algunas de las configuraciones se pueden cambiar mediante las preferencias del portlet y otras mediante las configuraciones del servicio OSGi. Estas configuraciones se cambian usando los archivos config o la consola web OSGi.

Preferencias de portlet portlet-preferences

Las preferencias del portlet se pueden configurar en el momento de la implementación en el servidor del portal o editando el archivo WEB-INF/portlet.xml antes de implementar la aplicación web del portlet. El archivo portlet.xml aparece de la siguiente manera de forma predeterminada:

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="https://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
             xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="https://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd /opt/SUNWps/dtd/portlet.xsd"
             version="1.0">
   <portlet>
      <portlet-name>RSSWeatherPortlet</portlet-name>
      <portlet-class>org.jboss.portlet.weather.WeatherPortlet</portlet-class>
      <init-param>
         <name>default_zipcode</name>
         <value>05673</value>
      </init-param>
      <init-param>
         <name>RSS_XSL</name>
         <value>/WEB-INF/Rss.xsl</value>
      </init-param>
      <init-param>
         <name>base_url</name>
         <value>https://xml.weather.yahoo.com/forecastrss?p=</value>
      </init-param>
      <expiration-cache>180</expiration-cache>
      <supports>
         <mime-type>text/html</mime-type>
         <portlet-mode>VIEW</portlet-mode>
         <portlet-mode>EDIT</portlet-mode>
      </supports>
      <portlet-info>
         <title>Weather Portlet</title>
      </portlet-info>
      <portlet-preferences>
         <preference>
            <name>expires</name>
            <value>180</value>
         </preference>
         <preference>
            <name>RssXml</name>
            <value>https://xml.weather.yahoo.com/forecastrss?p=33145</value>
            <read-only>false</read-only>
         </preference>
      </portlet-preferences>
   </portlet>
</portlet-app>

El portlet se puede configurar con las siguientes preferencias:

Consola web OSGi osgi-web-console

AEM Suponiendo que el servidor de portal se ejecute en el host localhost, el puerto 8080 y la aplicación web del portlet de la aplicación web se monta en el contexto de aplicación web cqportlet, la dirección URL de la consola web es https://localhost:8080/cqportlet/cqbridge/system/console. El usuario y la contraseña predeterminados son admin.

Abra la ficha Configuraciones y seleccione Configuración del servidor CQ de Portal Directory. Aquí se especifica la dirección URL base del autor y la instancia de publicación. Este procedimiento se describe en Configuración del portlet.

Proporcionar configuraciones providing-configurations

AEM Para admitir implementaciones automatizadas y el aprovisionamiento de configuración, el portlet de contenido de la tiene compatibilidad de configuración integrada que intenta leer las configuraciones de la ruta de clase proporcionada a la aplicación del portlet.

Al iniciar, se lee la propiedad del sistema com.day.cq.portet.config para detectar el entorno actual. Normalmente, el valor de esta propiedad es algo así como dev, prod, test, etc. Si no se establece ningún entorno, no se lee ninguna configuración.

Si se establece un entorno, se busca un archivo de configuración en la ruta de clase en* *com/day/cq/portlet/{env}.config, donde env se reemplaza con el valor real del entorno. Este archivo debe enumerar todos los archivos de configuración para este entorno. La búsqueda de estos archivos se realiza en relación con la ubicación del archivo de configuración. Por ejemplo, si el archivo contiene una línea my.service.xml,, este archivo se lee desde la ruta de clase en com/day/cq/portlet/my.service.config.. El nombre del archivo consiste en el identificador de persistencia del servicio, seguido de .config. En el ejemplo anterior, el identificador de persistencia es my.service. El formato del archivo de configuración es el formato utilizado por el instalador OSGi de Apache Sling.

Esto significa que, para cada entorno, es necesario añadir un archivo de configuración correspondiente. Es necesario introducir una configuración que se aplique a todos los entornos en todos estos archivos; si es solo para un entorno, solo se introduce en ese archivo. Este mecanismo garantiza un control total sobre qué configuración se lee en qué entorno.

Es posible utilizar una propiedad del sistema diferente para detectar el entorno. Especifique la propiedad del sistema com.day.cq.portet.configproperty que contiene el nombre de la propiedad del sistema que se va a utilizar en lugar de com.day.cq.portet.config.

Almacenamiento en caché e invalidación de caché caching-and-caching-invalidation

AEM El portlet, en su configuración predeterminada, almacena en caché las respuestas que recibe de WCM en una caché específica del usuario. Las cachés deben invalidarse cuando se produzcan cambios en el contenido de la instancia de publicación. AEM Para este fin, en WCM de se debe configurar un agente de replicación en la instancia de autor. La caché también se puede vaciar manualmente. En esta sección se describen ambos procedimientos.

AEM El portlet se puede configurar con su propia caché, de modo que el contenido del portlet se muestre sin necesidad de tener acceso a la caché de la interfaz de usuario de la interfaz de usuario de. El portal está disponible como contenido en /libs/portal/director. AEM Para acceder al contenido, inicie una instancia de y descargue, mediante CRXDE Lite o Webdav, el archivo desde esa ubicación.

Puede implementar este paquete en tiempo de ejecución o agregarlo a la aplicación web del portlet en WEB-INF/lib/resources/bundles antes de la implementación.

Una vez implementada la caché, el portlet almacena en caché el contenido de la instancia de publicación. AEM La caché del portlet se puede invalidar con un vaciado de Dispatcher desde el servidor de correo de la red de distribución de la red de. Para configurar el portlet para que utilice su propia caché:

Vaciar la caché mediante el agente de replicación flushing-the-cache-via-replication-agent

AEM Al igual que la invalidación normal de Dispatcher, se puede configurar un agente de replicación para que se dirija a la caché de portlets de la red del portal. Después de configurar el agente de replicación, cada activación de página normal vacía la caché del portal.

AEM Si opera varios nodos de portal que ejecutan el portlet de la, debe crear un agente para cada nodo como se describe en este procedimiento.

Para configurar un agente de replicación para el portal:

Vaciar manualmente la caché del portlet manually-flushing-the-portlet-cache

Puede vaciar manualmente la caché del portlet accediendo a la misma URL configurada para el agente de replicación. Consulte Vaciar la caché para ver la forma de la dirección URL. Además, la dirección URL debe ampliarse con un parámetro de URL Path=<path> para indicar qué se debe vaciar.

Por ejemplo:

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* vacía la caché completa. https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz vacía /content/mypage/xyz de la caché.

Seguridad de portal portal-security

El portal es el mecanismo de autenticación impulsor. AEM Puede iniciar sesión en la sesión de con un usuario técnico, con el usuario del portal, con un grupo, etc. El portlet no tiene acceso a la contraseña del usuario en el portal, por lo que si el portlet no conoce todas las credenciales para iniciar sesión correctamente en un usuario, se debe utilizar una solución SSO. AEM AEM AEM En este caso, el portlet de la reenvía toda la información necesaria a los usuarios, que a su vez reenvía esta información al repositorio de la subyacente. Este comportamiento es conectable y se puede personalizar.

Autenticación en Publish authentication-on-publish

AEM En esta sección se describen los modos de autenticación disponibles que el portlet puede utilizar para comunicarse con las instancias de WCM de la subyacente.

AEM De forma predeterminada, no se envía ninguna información de usuario a la instancia de publicación de; el contenido siempre se muestra como usuario anónimo. AEM Si la información específica del usuario debe entregarse desde el servidor de correo o si se requiere la autenticación del usuario para la publicación, esto debe activarse.

Acceso a la configuración de autenticación del portlet accessing-the-portlet-s-authentication-configuration

AEM Las opciones de configuración de autenticación que utiliza el portlet en las instancias de WCM de la plataforma de autenticación están disponibles en la consola web (configuración de OSGi).

Para acceder a la configuración de autenticación del portlet:

Modo de usuario técnico technical-user-mode

AEM En el modo predeterminado, todas las solicitudes emitidas por el portlet para la instancia de autor de WCM de se autentican con el mismo usuario técnico, independientemente del usuario del portal actual. El modo de usuario técnico está activado de forma predeterminada. Puede habilitar/deshabilitar este modo en la pantalla de configuración correspondiente de la consola de administración OSGi:

AEM El usuario técnico especificado debe existir en la instancia de autor de WCM de la y en la instancia de publicación si Autenticar en Publish está habilitado. Asegúrese de otorgar al usuario los privilegios de acceso suficientes para el trabajo de creación.

SSO sso

AEM El portlet es compatible con SSO con la opción de configuración predeterminada de la aplicación de la forma más rápida. AEM El servicio de autenticación se puede configurar para que utilice SSO y transmita al usuario del portal actual con el formato Basic como una cookie denominada cqpsso a la que se va a enviar el correo electrónico de la página de inicio de sesión (). AEM Debe configurarse para que utilice el controlador de autenticación SSO para la ruta /. El nombre de la cookie también debe configurarse aquí.

AEM El crx-quickstart/repository/repository.xml para el repositorio de debe configurarse en consecuencia:

<LoginModule class="com.day.crx.security.authentication.CRXLoginModule">
  ...
  <param name="trust_credentials_attribute" value="TrustedInfo"/>
  <param name="anonymous_principal" value="anonymous"/>
</LoginModule>

Modo de autenticación SSO sso-authentication-mode

AEM El portlet puede autenticarse para el WCM de la mediante el esquema de inicio de sesión único (SSO). AEM En este modo, el usuario que ha iniciado sesión en el portal se reenvía a WCM de la forma de una cookie de SSO a la que se accede mediante una contraseña de inicio de sesión único (SSO). AEM AEM AEM Si se utiliza el modo SSO, todos los usuarios del portal con acceso al portlet de la deben ser conocidos por las instancias de WCM de la subyacente, por lo general en forma de WCM de la conexión a LDAP o de haber creado manualmente a los usuarios de antemano. AEM Además, antes de habilitar SSO en el portlet, la instancia de autor de WCM subyacente (y la instancia de publicación, si Autenticar en Publish está habilitada) deben configurarse para aceptar solicitudes basadas en SSO.

Para configurar el portlet para que utilice el modo de autenticación SSO, complete los siguientes pasos (descritos en detalle en las secciones siguientes):

AEM Habilitar el repositorio de WCM para aceptar credenciales de confianza enabling-aem-wcm-s-repository-to-accept-trusted-credentials

AEM AEM Antes de poder habilitar el SSO para el WCM de la, es necesario configurar el repositorio subyacente para que acepte las credenciales de confianza proporcionadas por el WCM de la. AEM Para ello, debe configurar la configuración de la configuración del archivo repository.xml de la aplicación de configuración de.

AEM Habilitación de la autenticación SSO en el WCM de enabling-sso-authentication-in-the-aem-wcm

AEM AEM Para habilitar SSO en WCM, acceda a la entrada de configuración correspondiente en la consola de administración web Apache Felix (OSGi) de WCM de la:

AEM Por cada solicitud que WCM recibe, primero se intenta la autenticación basada en SSO. Si se produce un error, se vuelve al esquema de autenticación básico habitual. AEM Como tal, las conexiones normales a WCM sin SSO siguen siendo posibles.

AEM Activación de la autenticación SSO en un portlet de enabling-sso-authentication-in-a-aem-portlet

AEM Para que la instancia de WCM de la subyacente acepte solicitudes de SSO, el modo de autenticación del portlet debe cambiarse de Técnico a SSO.

AEM Para habilitar la autenticación SSO en un portlet de:

Después de realizar este procedimiento, las solicitudes se autentican mediante SSO. Un fragmento típico de la comunicación HTTP revela la presencia de los siguientes encabezados específicos de SSO y Portlet:

C-12-#001898 -> [GET /mynet/en/_jcr_content/par/textimage/image.img.png HTTP/1.1 ]
C-12-#001963 -> [cq5:locale: en ]
C-12-#001979 -> [cq5:used-locale: en ]
C-12-#002000 -> [cq5:locales: en,en_US ]
C-12-#002023 -> [cqp:user: wpadmin ]
C-12-#002042 -> [cqp:portal: IBM WebSphere Portal/6.1 ]
C-12-#002080 -> [cqp:windowid: 7_CGAH47L000CE302V2KFNOG0084 ]
C-12-#002124 -> [cqp:windowstate: normal ]
C-12-#002149 -> [cqp:portletmode: view ]
C-12-#002172 -> [User-Agent: Jakarta Commons-HttpClient/3.1 ]
C-12-#002216 -> [Host: 10.0.0.68:4502 ]
C-12-#002238 -> [Cookie: $Version=0; cqpsso=Basic+d3BhZG1pbg%3D%3D ]
C-12-#002289 -> [ ]

Habilitación de la autenticación PIN enabling-pin-authentication

AEM AEM Si no utiliza las características de edición en línea predeterminadas del portlet de contenido de la, pero desea que la parte de creación y administración del portlet esté fuera del portal directamente en la instancia de autor de la instancia, debe habilitar la autenticación PIN. También debe cambiar la configuración de los botones de administración.

AEM Para abrir la página de administración del sitio web o editar una página desde el portlet, el portlet de contenido utiliza la nueva autenticación de clavija. AEM De forma predeterminada, la autenticación de clavijas está desactivada, por lo que deben realizarse los siguientes cambios de configuración en la:

Privilegios privileges

Algunas funciones del portlet están protegidas por privilegios. El usuario actual necesita tener este privilegio para poder acceder a esta función. Hay los siguientes privilegios predefinidos:

El mejor método para administrar los privilegios es utilizar las funciones de portal y asignarles funciones. Esto se puede hacer mediante una configuración OSGi. El "Day Portal Director Privilege Manager" se puede configurar con un conjunto de funciones para cada privilegio. Si el usuario tiene uno de los roles, el usuario tiene el privilegio correspondiente.

Además, es posible definir esta función en función del acceso por base de instancia de portlet. El cuadro de diálogo de preferencias del portlet contiene un campo de entrada para cada uno de los privilegios anteriores. Para cada privilegio se puede configurar una lista de funciones de portlet separadas por coma. Si se configura un valor, esto anula la configuración global del servicio "Administrador de privilegios de Director del portal de día" y es posible que se requiera agregar los mismos roles de esta configuración global, ya que los roles no se combinan. Si no se especifica ningún valor, se utiliza la configuración global.

AEM Personalización de la aplicación de portlet de customizing-the-aem-portlet-application

AEM AEM La aplicación de portlet de la aplicación proporcionada inicia un contenedor OSGi dentro de la aplicación web del mismo modo que lo hace la aplicación web de la misma manera en que lo hace la. Esta arquitectura le permite utilizar todas las ventajas de OSGi:

Botones de barra toolbar-buttons

La barra de herramientas y sus botones se pueden configurar y personalizar. Puede añadir sus propios botones a la barra de herramientas o definir qué botones se muestran en qué modo. Cada botón es un servicio OSGi configurable mediante una configuración OSGi.

La consola web de OSGi enumera todas las configuraciones de botón en la ficha Configuración. Para cada botón, puede definir en qué modo se muestra este botón. Esto permite desactivar un botón, por ejemplo, eliminando todos los modos.

AEM De forma predeterminada, el portlet de contenido de la utiliza la funcionalidad de edición en línea. AEM Sin embargo, si prefiere cambiar a la instancia de autor de la para editarla, habilite SiteAdmin Button y ContentFinder Button, pero deshabilite Edit Button. AEM En este caso, asegúrese de configurar correctamente la autenticación PIN en el cuadro de diálogo de autenticación de.

El diseño de la barra de herramientas del portlet se puede personalizar instalando un paquete a través de la consola web Felix del portlet, que contiene CSS/HTML personalizado en una ubicación predefinida.

Estructura del paquete bundle-structure

A continuación se muestra un ejemplo de estructura de paquete:

$ jar tvf target/toolbarlayout-0.0.1-SNAPSHOT.jar | awk '{print $8}'
META-INF/
META-INF/MANIFEST.MF
/com/day/cq/portlet/toolbar/layout/
/com/day/cq/portlet/toolbar/layout/author.gif
/com/day/cq/portlet/toolbar/layout/back.gif
/com/day/cq/portlet/toolbar/layout/button.html
/com/day/cq/portlet/toolbar/layout/edit.gif
/com/day/cq/portlet/toolbar/layout/manage.html
/com/day/cq/portlet/toolbar/layout/publish.html
/com/day/cq/portlet/toolbar/layout/refresh.gif
/com/day/cq/portlet/toolbar/layout/siteadmin.gif
/com/day/cq/portlet/toolbar/layout/toolbar.css

La carpeta META-INF contiene el archivo MANIFEST.MF requerido por OSGi para identificarlo como un paquete. Aparece de la siguiente manera:

Manifest-Version: 1.0
Built-By: djaeggi
Created-By: Apache Maven Bundle Plugin
Import-Package: com.day.cq.portlet.toolbar.layout
Bnd-LastModified: 1234178347159
Export-Package: com.day.cq.portlet.toolbar.layout
Bundle-Version: 0.0.1.SNAPSHOT
Bundle-Name: Company CQ5 Portal Director Portlet Toolbar Layout
Bundle-Description: This bundle provides a custom layout for the CQ5 P
 ortal Director Portlet Toolbar.
Build-Jdk: 1.5.0_16
Bundle-ManifestVersion: 2
Bundle-SymbolicName: com.day.cq.portlet.company.toolbarlayout
Tool: Bnd-0.0.255

El portlet exige el hecho de que el HTML/CSS/images esté dentro de la carpeta /com/day/cq/portlet/toolbar/layout y no se puede cambiar. En la misma línea, los encabezados Import-Package y Export-Package en MANIFEST.MF también deben llamarse /com/day/cq/portlet/toolbar/layout. Bundle-SymbolicName debe ser un nombre de paquete único y completo.

Puede crearlo con una herramienta como maven o crear manualmente un archivo jar de este tipo con el encabezado relevante establecido como se muestra en esta sección.

Vistas de barra de portlets portlet-toolbar-views

La barra de herramientas del portlet tiene básicamente dos estados de vista. Cada vista y los botones asociados se pueden personalizar con un archivo de HTML correspondiente.

Vista de Publish publish-view

La vista de publicación solo tiene un botón que cambia la barra de herramientas a la vista Administrar. La vista de publicación está representada por el archivo publish.html en paquete anterior. En el HTML, puede utilizar los siguientes marcadores de posición, que se sustituyen por el portlet con el contenido respectivo cuando se representan:

Marcadores de posición de vista Publish publish-view-placeholders

Administrar vista manage-view

La vista de administración tiene cuatro botones: Editar, pestaña Sitios web, Actualizar y Atrás. La vista de administración está representada por el archivo manage.html del paquete anterior. En el HTML, puede utilizar los siguientes marcadores de posición, que se sustituyen por el portlet con el contenido respectivo cuando se representan:

Administrar marcadores de posición de vista manage-view-placeholders

Botones buttons

Los botones, en cualquier vista en la que aparezcan, utilizan el mismo HTML común, definido en button.html.

En el HTML, puede utilizar los siguientes marcadores de posición, que se sustituyen por el portlet con el contenido respectivo cuando se representan:

Botones Administrar y Vista de Publish manage-and-publish-view-buttons

Ejemplo de archivo button.html:

<div class="cqp_button">

 <a href="#" onclick="{onclick}">

 <img src="/wps/PA_CQ5_Portlet/cqbridge/static/{id}.gif" alt="{text}"
title="{text}"/>

 </a>
</div>

Instalación de un diseño personalizado installing-a-custom-layout

Para instalar un diseño personalizado, acceda a la sección Consola web OSGI del portlet Paquetes ​ y cargue el paquete.

Paquetes packages

AEM Si necesita cargar o crear paquetes para la instalación, consulte Administrador de paquetes en la documentación de para obtener instrucciones detalladas al respecto.

Administración de vínculos link-handling

Todos los vínculos se reescriben para que funcionen en el contexto del portal. De forma predeterminada, se utilizan vínculos con parámetros de procesamiento. El reescritor del HTML de Director del portal se puede configurar para que use vínculos de acción en su lugar.

También puede definir parámetros de solicitud adicionales para consultar la ruta de contenido que se va a mostrar. Esto resulta útil, por ejemplo, si hay un vínculo desde el exterior a contenido específico.

Además, la reescritura de HTML de Portal Director se puede configurar con una lista de expresiones regulares definidas que excluyen la reescritura de vínculos. Por ejemplo, si tiene vínculos relativos a sistemas externos, debe añadirlos a esta lista de exclusión.

Localización localization

AEM AEM El portlet de contenido de la aplicación tiene una función de localización integrada que garantiza que el contenido de la aplicación se encuentra en el idioma correcto. El portlet de contenido de la aplicación se encuentra en el idioma correcto.

Esto se realiza en dos pasos:

El controlador de configuración regional de Portal Director se puede configurar con las rutas para buscar información de configuración regional; generalmente incluye todo lo que hay bajo /content y con la posición de la información de configuración regional en la ruta. AEM De forma predeterminada, el controlador de configuración regional sigue la recomendación de estructurar sitios en varios idiomas dentro de la configuración de idioma de los sitios de la interfaz de usuario de.

Si el sitio no tiene una regla estricta para administrar la información de configuración regional dentro de la ruta, es posible reemplazar el controlador de configuración regional con su propia implementación.

Servicios OSGi opcionales optional-osgi-services

Se pueden implementar servicios OSGi opcionales para personalizar varias partes del portlet. Cada servicio corresponde a una interfaz de Java. Esta interfaz se puede implementar mediante un paquete en el portlet.

Reemplazar servicios predeterminados replacing-default-services

Los siguientes servicios tienen una implementación predeterminada en el portlet de contenido (con una interfaz Java correspondiente). Para personalizar, es necesario implementar un paquete que contenga la nueva implementación de servicio en la aplicación de portlet.

Al implementar un servicio de este tipo, asegúrese de establecer la propiedad service.ranking del servicio en un valor positivo. La implementación predeterminada utiliza la clasificación ​ 0 y el portlet utiliza el servicio con la clasificación más alta.

Eventos de portlet portlet-events

La API de portlet (JSR-286) especifica los eventos de portlet. AEM AEM El portlet de contenido de la tiene un puente integrado, que distribuye eventos de portlet para el portlet de la como eventos OSGi, lo que hace que la gestión de eventos de portlet sea conectable.

Si desea controlar eventos específicos, declárelos como eventos de recepción en el descriptor de implementación (o configúrelos a través del servidor de portal) e implemente un servicio OSGi que declare la interfaz EventHandler (consulte la especificación OSGi EventAdmin).

Cada vez que se produce un evento de portlet, se envía un evento OSGi específico invocando al controlador. El controlador obtiene toda la información de contexto y puede actualizar el estado del portlet en consecuencia o enviar nuevos eventos. Básicamente, dentro del método handle se puede utilizar toda la funcionalidad de la fase de evento portlet.

AEM Uso de como un portal using-aem-as-a-portal

AEM Utilice el componente Portlet para agregar ventanas de portlet a las páginas de la. Las bibliotecas compartidas que instala en el servidor de aplicaciones permiten que el componente Portlet detecte las aplicaciones de portlet implementadas.

AEM Para utilizar la aplicación de como portal, realice las siguientes tareas:

Instalación del componente de portlet installing-the-portlet-component

AEM El archivo JAR de Quickstart de contiene los archivos de componente del portlet. Para obtener los archivos (cq-portlet-components.zip), puede ejecutar Quickstart o extraer el contenido.

Adición del componente Portlet al Sidekick adding-the-portlet-component-to-sidekick

Agregue el componente portlet al sistema de párrafos para que esté disponible para los autores.

Configuración e implementación de las aplicaciones de portlet configuring-and-deploying-your-portlet-applications

Implemente los portlets en el contenedor web del servidor de aplicaciones para que estén disponibles para el componente Portal. AEM Antes de implementar la aplicación de portlet, debe configurar la aplicación para que cargue el servlet contenedor de portal de la aplicación de manera que se cargue el servlet contenedor de portal de la aplicación de portlet de la aplicación de manera que se ejecute de forma independiente. Esta configuración permite que el componente Portlet acceda a los portlets.

AEM Adición de portlets a la página de la adding-portlets-to-your-aem-page

Utilice el componente Portal para añadir una ventana de portlet a la página web. Utilice las propiedades del componente para especificar el portlet que se va a mostrar.

AEM Instalación, configuración y uso de un portlet de, que se puede usar en un portlet de installing-configuring-and-using-aem-in-a-portlet

AEM AEM Para acceder al contenido proporcionado por WCM, es necesario que el servidor del portal esté equipado con el Portlet Director del portal de la interfaz de usuario de la interfaz de usuario de. Para ello, instale, configure y agregue el portlet a la página del portal siguiendo los pasos que se indican en esta sección.

De forma predeterminada, el portlet se conecta a la instancia de publicación en localhost:4503 y a la instancia de autor en localhost:4502. Estos valores se pueden cambiar durante la implementación del portlet. El director del portal está disponible como contenido en el repositorio en /libs/portal/directory. Descargue el archivo WAR de la aplicación antes de utilizarlo.

Descarga del archivo WAR downloading-the-war-file

Instalación del portlet installing-the-portlet

Para instalar el portlet:

Configuración del portlet configuring-the-portlet

AEM Después de instalar el portlet, debe configurarlo para que conozca las direcciones URL de las instancias de subyacentes (autor y publicación). También puede configurar otras opciones.

Para configurar el portlet:

URL de contenido content-urls

AEM Cuando se solicita contenido desde la interfaz de usuario, el portlet utiliza el modo de visualización actual (publicación o autor) y la ruta de acceso actual para combinar una dirección URL completa. Con los valores predeterminados, la primera dirección URL es https://localhost:4503/content/geometrixx/en.portlet.html. El valor de htmlSelector se agrega automáticamente a la dirección URL antes de la extensión.

Si el portlet cambia al modo de ayuda y se selecciona appendHelpViewModeAsSelector, también se anexa el selector help, por ejemplo, https://localhost:4503/content/geometrixx/en.portlet.html.help. Si la ventana del portlet está maximizada y se selecciona appendMaxWindowStateAsSelector, el selector también se anexa, por ejemplo, https://localhost:4503/content/geometrixx/en.portlet.max.help.

AEM Los selectores se pueden evaluar en la forma de una plantilla y se puede usar una plantilla diferente para distintos selectores.

AEM Uso de un mapa de URL de contenido en la using-a-content-url-map-in-aem

AEM Normalmente, la ruta de inicio apunta directamente al contenido en la página de inicio de la página de la página de la aplicación AEM AEM Sin embargo, si desea mantener las rutas de inicio en las preferencias del portlet en lugar de en las de los recursos, puede apuntar la ruta de inicio a un mapa de contenido en el que se va a realizar el seguimiento, como /var/portlets. AEM En este caso, una secuencia de comandos que se ejecute en la interfaz de usuario puede utilizar la información enviada desde el portlet para decidir qué dirección URL es la dirección URL de inicio. Debe emitir un redireccionamiento a la dirección URL correcta.

Agregar el portlet a la página del portal adding-the-portlet-to-the-portal-page

Para agregar el portlet a la página del portal:

Uso del portlet using-the-portlet

Para acceder a la página que agregó al portlet: