Portali e portlet AEM aem-portals-and-portlets

Questo documento descrive quanto segue:

Architettura del portale AEM aem-portal-architecture

L'architettura del portale AEM include definizioni di portali e portlet.

Che cos'è un portale? what-is-a-portal

Un portale è un'applicazione Web che offre personalizzazione, accesso singolo, integrazione di contenuti da origini diverse e ospita il livello di presentazione dei sistemi informativi.

È possibile eseguire portlet conformi a JSR 286 in AEM. Il componente portlet consente di incorporare un portlet nella pagina. Vedere Amministrazione del portlet dei contenuti dell'AEM.

Che cos'è un portlet? what-is-a-portlet

I portlet sono componenti web distribuiti all’interno di un contenitore che genera contenuto dinamico. L'interfaccia portlet viene creata e distribuita come file .war all'interno di un contenitore portlet. Se si esegue AEM come portale, è necessario il file .war del portlet per eseguire il portlet.

Per configurare il contenuto AEM per la visualizzazione in un portale, vedere Installazione, configurazione e utilizzo di AEM in un portlet.

Director del portale AEM aem-portal-director

Amministrazione del portlet dei contenuti dell’AEM administering-the-aem-content-portlet

Il portlet dei contenuti dell’AEM consente di visualizzare il contenuto dell’AEM in un portale. Il portlet è disponibile in /crx-quickstart/opt/portal e può essere personalizzato in vari modi. Ad esempio, puoi personalizzare la gestione di SSO/autenticazione implementando un servizio di autenticazione personalizzato che generi le informazioni di autenticazione richieste affinché l’AEM possa sovrascrivere il comportamento predefinito. I plug-in utilizzano un’API definita che ti consente di aggiungere le tue funzionalità creando il plug-in rispetto all’API. Il plug-in può essere distribuito nel portlet in esecuzione. Per funzionare correttamente, è necessaria una configurazione dell’istanza di authoring e pubblicazione dell’AEM insieme al percorso del contenuto da visualizzare all’avvio.

Alcune configurazioni possono essere modificate tramite le preferenze del portlet e altre tramite le configurazioni del servizio OSGi. Puoi modificare queste configurazioni utilizzando i file config o la console Web OSGi.

Preferenze portlet portlet-preferences

Le preferenze del portlet possono essere configurate al momento della distribuzione nel server portale o modificando il file WEB-INF/portlet.xml prima di distribuire l'applicazione Web portlet. Per impostazione predefinita, il file portlet.xml viene visualizzato come segue:

<?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>

Il portlet può essere configurato con le seguenti preferenze:

Console web OSGi osgi-web-console

Se il server portale viene eseguito su host locale, porta 8080 e l'applicazione Web portlet AEM è montata nel contesto dell'applicazione Web cqportlet, l'URL della console Web sarà https://localhost:8080/cqportlet/cqbridge/system/console. L'utente e la password predefiniti sono admin.

Apri la scheda Configurazioni e seleziona Configurazione server CQ directory portale. Qui puoi specificare l’URL di base per l’istanza di authoring e pubblicazione. Questa procedura è descritta in Configurazione del portlet.

Fornitura di configurazioni providing-configurations

Per supportare le distribuzioni automatizzate e il provisioning della configurazione, il portlet dei contenuti AEM dispone del supporto integrato per la configurazione che tenta di leggere le configurazioni dal classpath fornito all'applicazione portlet.

All'avvio, la proprietà di sistema com.day.cq.portet.config viene letta per rilevare l'ambiente corrente. In genere, il valore di questa proprietà è dev, prod, test e così via. Se non è impostato alcun ambiente, non viene letta alcuna configurazione.

Se è impostato un ambiente, viene eseguita una ricerca nel file di configurazione nel percorso di classe in* *com/day/cq/portlet/{env}.config, dove env viene sostituito con il valore effettivo dell'ambiente. Questo file deve elencare tutti i file di configurazione per questo ambiente. La ricerca di questi file viene eseguita in base alla posizione del file di configurazione. Ad esempio, se il file contiene una riga my.service.xml,, il file viene letto dal percorso di classe in com/day/cq/portlet/my.service.config.. Il nome del file è costituito dall'ID di persistenza del servizio, seguito da .config. Nell'esempio precedente, l'ID di persistenza è my.service. Il formato del file di configurazione è il formato utilizzato dal programma di installazione di Apache Sling OSGi.

Ciò significa che, per ogni ambiente, è necessario aggiungere un file di configurazione corrispondente. Una configurazione che deve essere applicata a tutti gli ambienti deve essere immessa in tutti questi file; se si tratta di un ambiente singolo, viene appena immessa in quel file. Questo meccanismo garantisce il controllo completo sulla configurazione che viene letta in un determinato ambiente.

Per rilevare l’ambiente è possibile utilizzare una proprietà di sistema diversa. Specificare la proprietà di sistema com.day.cq.portet.configproperty contenente il nome della proprietà di sistema da utilizzare al posto di com.day.cq.portet.config.

Annullamento della validità della memorizzazione in cache e del caching caching-and-caching-invalidation

Nella sua configurazione predefinita, il portlet memorizza nella cache le risposte ricevute da WCM AEM in una cache specifica per l’utente. Le cache devono essere invalidate quando si verificano modifiche nel contenuto dell’istanza Publish. A questo scopo, in WCM per AEM è necessario configurare un agente di replica nell’istanza di authoring. La cache può anche essere scaricata manualmente. In questa sezione vengono descritte entrambe le procedure.

Il portlet può essere configurato con una propria cache, in modo che il contenuto del portlet venga visualizzato senza richiedere l’accesso a AEM. Il portale è disponibile come contenuto in /libs/portal/director. Per accedere al contenuto, avvia un’istanza AEM e scarica il file da tale posizione utilizzando CRXDE Lite o Webdav.

È possibile distribuire questo bundle in fase di esecuzione o aggiungerlo all'applicazione Web portlet in WEB-INF/lib/resources/bundles prima della distribuzione.

Una volta distribuita la cache, il portlet memorizza in cache i contenuti dell’istanza Publish. La cache del portlet può essere invalidata con uno svuotamento del dispatcher dall’AEM. Per configurare il portlet in modo che utilizzi la propria cache:

Scaricamento della cache tramite l’agente di replica flushing-the-cache-via-replication-agent

Proprio come il normale annullamento della validità del dispatcher, è possibile configurare un agente di replica per eseguire il targeting della cache del portlet AEM del portale. Dopo aver configurato l’agente di replica, ogni attivazione regolare delle pagine svuota la cache del portale.

Se gestisci più nodi di portale che eseguono il portlet AEM, devi creare un agente per ciascun nodo come descritto in questa procedura.

Per configurare un agente di replica per il portale:

Scaricamento manuale della cache del portlet manually-flushing-the-portlet-cache

Puoi svuotare manualmente la cache del portlet accedendo allo stesso URL configurato per l’agente di replica. Vedere Scaricamento della cache per il formato dell'URL. Inoltre, l’URL deve essere esteso con un parametro URL Path=<percorso> per indicare cosa deve essere scaricato.

Ad esempio:

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* svuota la cache completa. https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz svuota /content/mypage/xyz dalla cache.

Sicurezza portale portal-security

Il portale è il meccanismo di autenticazione guida. È possibile accedere all'AEM con un utente tecnico, l'utente del portale, un gruppo e così via. Il portlet non ha accesso alla password per l'utente nel portale, quindi se il portlet non conosce tutte le credenziali per accedere correttamente a un utente, è necessario utilizzare una soluzione SSO. In questo caso, il portlet dell'AEM inoltra tutte le informazioni richieste all'AEM, che a sua volta le trasmette al relativo archivio AEM. Questo comportamento è collegabile e può essere personalizzato.

Autenticazione su Publish authentication-on-publish

In questa sezione vengono descritte le modalità di autenticazione disponibili che il portlet può utilizzare per comunicare con le istanze WCM AEM sottostanti.

Per impostazione predefinita, non vengono inviate informazioni sull’utente all’istanza Publish dell’AEM; il contenuto viene sempre visualizzato come utente anonimo. È necessario attivare questa opzione se le informazioni specifiche dell’utente devono essere fornite dall’AEM o se è richiesta l’autenticazione dell’utente per la pubblicazione.

Accesso alla configurazione di autenticazione del portlet accessing-the-portlet-s-authentication-configuration

Le opzioni di configurazione dell’autenticazione utilizzate dal portlet nelle istanze WCM dell’AEM sono disponibili nella console web (configurazione OSGi).

Per accedere alla configurazione dell'autenticazione del portlet:

Modalità utente tecnico technical-user-mode

In modalità predefinita, tutte le richieste emesse dal portlet per l’istanza di authoring WCM dell’AEM vengono autenticate utilizzando lo stesso utente tecnico, indipendentemente dall’utente corrente del portale. La modalità utente tecnico è attivata per impostazione predefinita. Abilita/disabilita questa modalità nella rispettiva schermata di configurazione nella console di gestione OSGi:

L'utente tecnico specificato deve esistere nell'istanza di authoring WCM per AEM e nell'istanza di pubblicazione se Autentica in Publish è abilitato. Assicurati di fornire all’utente privilegi di accesso sufficienti per il lavoro di authoring.

SSO sso

Il portlet supporta l’SSO con AEM preconfigurato. Il servizio di autenticazione può essere configurato per utilizzare l'SSO e trasmettere l'utente del portale corrente con il formato Basic come cookie denominato cqpsso all'AEM. L’AEM deve essere configurato per utilizzare il gestore di autenticazione SSO per il percorso /. Il nome del cookie deve essere configurato anche qui.

crx-quickstart/repository/repository.xml per l'archivio AEM deve essere configurato di conseguenza:

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

Modalità di autenticazione SSO sso-authentication-mode

Il portlet può eseguire l'autenticazione per AEM WCM utilizzando lo schema Single Sign On (SSO). In questa modalità, l’utente attualmente connesso al portale viene inoltrato a WCM AEM sotto forma di cookie SSO. Se si utilizza la modalità SSO, tutti gli utenti del portale con accesso al portlet AEM devono essere noti alle istanze WCM dell’AEM sottostanti, più comunemente sotto forma di WCM dell’AEM connesso al protocollo LDAP o mediante la creazione manuale degli utenti in precedenza. Inoltre, prima di abilitare l'SSO nel portlet, è necessario configurare l'istanza di authoring WCM dell'AEM sottostante (e l'istanza di pubblicazione, se Autentica in Publish è abilitato) per accettare le richieste basate su SSO.

Per configurare il portlet per l'utilizzo della modalità di autenticazione SSO, completare i passaggi seguenti (descritti in dettaglio nelle sezioni seguenti):

Abilitazione dell'archivio di WCM AEM per accettare credenziali attendibili enabling-aem-wcm-s-repository-to-accept-trusted-credentials

Prima di poter abilitare l’SSO per WCM AEM, è necessario configurare l’archivio sottostante in modo da accettare le credenziali attendibili fornite da WCM AEM. A questo scopo, devi configurare il file repository.xml dell’AEM.

Abilitazione dell’autenticazione SSO in AEM WCM enabling-sso-authentication-in-the-aem-wcm

Per abilitare l’SSO in WCM AEM, accedi alla voce di configurazione pertinente nell’OSGi (Apache Felix Web Management Console) di WCM AEM:

Per ogni richiesta ricevuta da AEM WCM, viene innanzitutto tentata l’autenticazione basata su SSO. In caso di errore, viene eseguito un fallback allo schema di autenticazione di base consueto. Di conseguenza, le normali connessioni a WCM AEM senza SSO rimangono possibili.

Abilitazione dell’autenticazione SSO in un portlet AEM enabling-sso-authentication-in-a-aem-portlet

Affinché l'istanza WCM AEM sottostante possa accettare richieste SSO, è necessario passare dalla modalità di autenticazione del portlet da Technical a SSO.

Per abilitare l'autenticazione SSO in un portlet AEM:

Dopo aver eseguito questa procedura, le richieste vengono autenticate tramite SSO. Un frammento tipico della comunicazione HTTP rivela la presenza delle seguenti intestazioni specifiche SSO e 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 -> [ ]

Abilitazione dell’autenticazione PIN enabling-pin-authentication

Se non si utilizzano le funzioni di modifica in linea predefinite del portlet dei contenuti AEM, ma si desidera che la parte relativa all’authoring e all’amministrazione del portlet venga eseguita all’esterno del portale direttamente nell’istanza di authoring AEM, è necessario abilitare l’autenticazione PIN. È inoltre necessario modificare la configurazione dei pulsanti di gestione.

Per aprire la pagina di amministrazione del sito web o per modificare una pagina dal portlet, il portlet dei contenuti AEM utilizza la nuova autenticazione pin. Per impostazione predefinita, l’autenticazione pin è disabilitata. Pertanto, è necessario apportare le seguenti modifiche alla configurazione in AEM:

Privilegi privileges

Alcune funzioni del portlet sono protette da privilegi. L’utente corrente deve disporre di questo privilegio per poter accedere a questa funzione. Sono disponibili i seguenti privilegi predefiniti:

L'approccio migliore per gestire i privilegi consiste nell'utilizzare i ruoli del portale e assegnare ruoli a tali privilegi. Questa operazione può essere eseguita tramite una configurazione OSGi. Day Portal Director Privilege Manager può essere configurato con un set di ruoli per ogni privilegio. Se l’utente dispone di uno dei ruoli, dispone del privilegio corrispondente.

Inoltre, è possibile definire questo ruolo in base all'accesso a una base di istanze per portlet. La finestra di dialogo delle preferenze del portlet contiene un campo di input per ciascuno dei privilegi di cui sopra. Per ogni privilegio è possibile configurare un elenco di ruoli portlet separati da virgole. Se è configurato un valore, la configurazione globale verrà ignorata dal servizio "Day Portal Director Privilege Manager" e potrebbe essere necessario aggiungere gli stessi ruoli da questa impostazione globale in quanto i ruoli non vengono uniti. Se non viene specificato alcun valore, viene utilizzata la configurazione globale.

Personalizzazione dell'applicazione portlet AEM customizing-the-aem-portlet-application

L’applicazione portlet AEM fornita avvia un contenitore OSGi all’interno dell’applicazione web proprio come avviene per l’AEM. Questa architettura consente di sfruttare tutti i vantaggi di OSGi:

Pulsanti barra degli strumenti toolbar-buttons

La barra degli strumenti e i relativi pulsanti sono configurabili e possono essere personalizzati. È possibile aggiungere pulsanti personalizzati alla barra degli strumenti o definire i pulsanti da visualizzare in una determinata modalità. Ogni pulsante è un servizio OSGi configurabile tramite una configurazione OSGi.

La console Web OSGi elenca tutte le configurazioni di pulsanti nella scheda Configurazione. Per ogni pulsante è possibile definire la modalità di visualizzazione del pulsante. In questo modo è possibile disattivare un pulsante, ad esempio rimuovendo tutte le modalità.

Per impostazione predefinita, il portlet dei contenuti dell’AEM utilizza la funzionalità di modifica in linea. Tuttavia, se preferisci passare all'istanza di modifica dell'autore AEM, abilita il pulsante SiteAdmin e il pulsante ContentFinder, ma disabilita il pulsante Modifica. In questo caso, assicurati di configurare correttamente l’autenticazione PIN in AEM.

Il layout della barra degli strumenti del portlet può essere personalizzato installando un bundle tramite la Console Web Felix del portlet, che contiene CSS/HTML personalizzati in una posizione predefinita.

Struttura del bundle bundle-structure

Di seguito è riportato un esempio di struttura del bundle:

$ 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 cartella META-INF contiene il file MANIFEST.MF necessario a OSGi per identificarlo come bundle. Viene visualizzato come segue:

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

Il fatto che le immagini HTML/CSS/siano all'interno della cartella /com/day/cq/portlet/toolbar/layout è obbligatorio per il portlet e non può essere modificato. Sulle stesse righe, le intestazioni Import-Package ed Export-Package in MANIFEST.MF devono essere denominate anche /com/day/cq/portlet/toolbar/layout. Il nome del pacchetto Bundle-SymbolicName deve essere univoco e completo.

Puoi generarlo utilizzando uno strumento come maven o creare manualmente un file jar di questo tipo con l’intestazione pertinente impostata come mostrato in questa sezione.

Visualizzazioni barra degli strumenti portlet portlet-toolbar-views

La barra degli strumenti del portlet ha sostanzialmente due stati di visualizzazione. Ogni vista e i pulsanti associati possono essere personalizzati con un rispettivo file HTML.

Vista Publish publish-view

Nella visualizzazione di pubblicazione è disponibile un solo pulsante che consente di passare dalla barra degli strumenti alla visualizzazione Gestisci. La visualizzazione di pubblicazione è rappresentata dal file publish.html nel bundle precedente. Nel HTML, è possibile utilizzare i segnaposto seguenti, che vengono sostituiti dal portlet con il rispettivo contenuto al momento del rendering:

Segnaposto visualizzazione Publish publish-view-placeholders

Gestisci visualizzazione manage-view

La visualizzazione di gestione include quattro pulsanti: Modifica, scheda Siti Web, Aggiorna e Indietro. La visualizzazione di gestione è rappresentata dal file manage.html nel bundle precedente. Nel HTML, è possibile utilizzare i segnaposto seguenti, che vengono sostituiti dal portlet con il rispettivo contenuto al momento del rendering:

Gestisci segnaposto visualizzazione manage-view-placeholders

Pulsanti buttons

I pulsanti, indipendentemente dalla visualizzazione visualizzata, utilizzano lo stesso HTML comune definito in button.html.

Nel HTML, è possibile utilizzare i segnaposto seguenti, che vengono sostituiti dal portlet con il rispettivo contenuto al momento del rendering:

Pulsanti di visualizzazione Gestisci e Publish manage-and-publish-view-buttons

Esempio di file 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>

Installazione di un layout personalizzato installing-a-custom-layout

Per installare un layout personalizzato, accedi alla sezione Bundle ​ console web OSGI del portlet) e carica il bundle.

Pacchetti packages

Se devi caricare o creare pacchetti per l’installazione, consulta Gestione pacchetti nella documentazione dell’AEM per istruzioni dettagliate.

Gestione dei collegamenti link-handling

Tutti i collegamenti vengono riscritti in modo che funzionino nel contesto del portale. Per impostazione predefinita vengono utilizzati collegamenti con i parametri di rendering. È possibile configurare il rewriter di Portal Director HTML in modo da utilizzare i collegamenti alle azioni.

Puoi anche definire parametri di richiesta aggiuntivi da interrogare per il percorso del contenuto da visualizzare. Ciò è utile, ad esempio, se è presente un collegamento dall’esterno a contenuto specifico.

Inoltre, Portal Director HTML Rewriter può essere configurato con un elenco di espressioni regolari definite escluse per la riscrittura dei collegamenti. Ad esempio, se disponi di collegamenti relativi a sistemi esterni, devi aggiungerli a questo elenco di esclusione.

Localizzazione localization

Il portlet dei contenuti dell’AEM dispone di una funzione di localizzazione integrata che garantisce che il contenuto dell’AEM sia nella lingua corretta.

Questa operazione viene eseguita in due passaggi:

È possibile configurare il gestore delle impostazioni locali di Portal Director con i percorsi per verificare la disponibilità di informazioni sulle impostazioni locali. In genere sono inclusi tutti gli elementi presenti in /content e la posizione delle informazioni sulle impostazioni locali nel percorso. Per impostazione predefinita, il gestore delle impostazioni internazionali segue la ridiffusione della strutturazione di siti multilingue all'interno dell'AEM.

Se il sito non dispone di regole severe per la gestione delle informazioni sulle impostazioni internazionali all'interno del percorso, è possibile sostituire il gestore delle impostazioni internazionali con la propria implementazione.

Servizi OSGi opzionali optional-osgi-services

È possibile implementare servizi OSGi opzionali per personalizzare varie parti del portlet. Ogni servizio corrisponde a un’interfaccia Java. Questa interfaccia può essere implementata e implementata tramite un bundle nel portlet.

Sostituzione dei servizi predefiniti replacing-default-services

I seguenti servizi hanno un’implementazione predefinita nel portlet dei contenuti (con la corrispondente interfaccia Java). Per personalizzare, è necessario distribuire nell'applicazione portlet un bundle contenente la nuova implementazione del servizio.

Quando implementi tale servizio, assicurati di impostare la proprietà service.ranking del servizio su un valore positivo. L’implementazione predefinita utilizza la classificazione ​ 0 e il portlet utilizza il servizio con la classificazione più alta.

Eventi portlet portlet-events

L’API del portlet (JSR-286) specifica gli eventi del portlet. Il portlet dei contenuti AEM dispone di un bridge integrato che distribuisce gli eventi portlet per il portlet AEM come eventi OSGi. In questo modo è possibile collegare la gestione degli eventi portlet.

Se desideri gestire eventi specifici, dichiarali come eventi di ricezione nel descrittore di distribuzione (o configuralo tramite il server portale) e implementa un servizio OSGi che dichiara l’interfaccia EventHandler (consulta le specifiche OSGi EventAdmin).

Ogni volta che si verifica un evento portlet, viene inviato un evento OSGi specifico che richiama il gestore. Il gestore ottiene tutte le informazioni di contesto e può aggiornare di conseguenza lo stato del portlet o inviare nuovi eventi. In pratica, all'interno del metodo handle è possibile utilizzare tutte le funzionalità della fase dell'evento portlet.

Utilizzo dell’AEM come portale using-aem-as-a-portal

Utilizzare il componente Portlet per aggiungere finestre portlet alle pagine AEM. Le librerie condivise installate nel server applicazioni consentono al componente Portlet di rilevare le applicazioni portlet distribuite.

Per utilizzare l'AEM come portale, eseguire le operazioni seguenti:

Installazione del componente portlet installing-the-portlet-component

Il file JAR Quickstart per AEM contiene i file dei componenti portlet. Per ottenere i file (cq-portlet-components.zip), puoi eseguire Quickstart o estrarre il contenuto.

Aggiunta del componente Portlet al Sidekick adding-the-portlet-component-to-sidekick

Aggiungi il componente portlet al sistema paragrafo affinché sia disponibile per gli autori.

Configurazione e distribuzione delle applicazioni portlet configuring-and-deploying-your-portlet-applications

Distribuire i portlet nel contenitore Web del server applicazioni in modo che siano disponibili per il componente Portal. Prima di distribuire l'applicazione portlet, è necessario configurarla in modo che carichi il servlet contenitore del portale AEM. Questa configurazione consente al componente Portlet di accedere ai portlet.

Aggiunta di portlet alla pagina AEM adding-portlets-to-your-aem-page

Utilizza il componente Portal per aggiungere una finestra portlet alla pagina web. Utilizza le proprietà del componente per specificare il portlet da visualizzare.

Installazione, configurazione e utilizzo di AEM in un portlet installing-configuring-and-using-aem-in-a-portlet

Per accedere al contenuto fornito da WCM AEM, il server di portale deve essere dotato del portlet Director del portale AEM. A tale scopo, installare, configurare e aggiungere il portlet alla pagina del portale utilizzando i passaggi descritti in questa sezione.

Per impostazione predefinita, il portlet si connette all'istanza Publish in localhost:4503 e all'istanza Author in localhost:4502. Questi valori possono essere modificati durante la distribuzione del portlet. Il director del portale è disponibile come contenuto nell’archivio in /libs/portal/directory. Scarica il file .war dell’applicazione prima di utilizzarlo.

Download del file .war downloading-the-war-file

Installazione del portlet installing-the-portlet

Per installare il portlet:

Configurazione del portlet configuring-the-portlet

Dopo aver installato il portlet, devi configurarlo in modo che conosca gli URL delle istanze AEM sottostanti (authoring e pubblicazione). Puoi anche configurare altre opzioni.

Per configurare il portlet:

URL di contenuto content-urls

Quando il contenuto viene richiesto dall’AEM, il portlet utilizza la modalità di visualizzazione corrente (pubblicazione o authoring) e il percorso corrente per assemblare un URL completo. Con i valori predefiniti, il primo URL è https://localhost:4503/content/geometrixx/en.portlet.html. Il valore di htmlSelector viene aggiunto automaticamente all'URL prima dell'estensione.

Se il portlet passa alla modalità guida e appendHelpViewModeAsSelector è selezionato, viene aggiunto anche il selettore help, ad esempio https://localhost:4503/content/geometrixx/en.portlet.html.help. Se la finestra del portlet è ingrandita e si seleziona appendMaxWindowStateAsSelector, anche il selettore viene aggiunto, ad esempio https://localhost:4503/content/geometrixx/en.portlet.max.help.

I selettori possono essere valutati in AEM e un modello diverso può essere utilizzato per selettori diversi.

Utilizzo di una mappa URL di contenuto nell’AEM using-a-content-url-map-in-aem

Di solito il percorso iniziale punta direttamente al contenuto nell’AEM. Tuttavia, se si desidera mantenere i percorsi iniziali in AEM anziché nelle preferenze del portlet, è possibile puntare il percorso iniziale a una mappa dei contenuti in AEM, ad esempio /var/portlets. In questo caso, uno script in esecuzione in AEM può utilizzare le informazioni inviate dal portlet per decidere quale URL è l’URL iniziale. Deve emettere un reindirizzamento all’URL corretto.

Aggiunta del portlet alla pagina portale adding-the-portlet-to-the-portal-page

Per aggiungere il portlet alla pagina del portale:

Utilizzo del portlet using-the-portlet

Per accedere alla pagina aggiunta al portlet: