Portali AEM e portlet aem-portals-and-portlets

Questo documento descrive quanto segue:

Architettura AEM Portal aem-portal-architecture

AEM'architettura del portale 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 dei contenuti da diverse sorgenti 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. Vedi Amministrazione del AEM Content Portlet.

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 compilata e distribuita come file .war all’interno di un contenitore portlet. Se esegui AEM come portale, è necessario il file .war del portlet per eseguire il portlet.

Per configurare AEM contenuto da visualizzare in un portale, vedi Installazione, configurazione e utilizzo di AEM in un portlet.

AEM Portal Director aem-portal-director

Amministrazione del AEM Content Portlet administering-the-aem-content-portlet

Il portlet del contenuto AEM consente di visualizzare AEM contenuto in un portale. Il portlet è disponibile all'indirizzo /crx-quickstart/opt/portale può essere personalizzato in vari modi. Ad esempio, è possibile personalizzare la gestione SSO/autenticazione distribuendo il proprio servizio di autenticazione generando le informazioni di autenticazione necessarie per AEM sovrascrivere il comportamento predefinito. I plug-in utilizzano un’API definita che ti consente di aggiungere funzionalità personalizzate 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 AEM insieme al percorso del contenuto da visualizzare all’avvio.

Alcune delle configurazioni possono essere modificate tramite le preferenze del portlet e altre tramite le configurazioni del servizio OSGi. Queste configurazioni vengono modificate utilizzando config file o la console Web OSGi.

Preferenze del portlet portlet-preferences

È possibile configurare le preferenze del portlet in fase di distribuzione nel server del portale o modificando il WEB-INF/portlet.xml prima di distribuire l'applicazione web portlet. Il file portlet.xml viene visualizzato come segue per impostazione predefinita:

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

Supponendo che il server portale venga eseguito su host localhost, porta 8080 e che l'applicazione Web AEM portlet sia montata nel contesto dell'applicazione Web cqportlet, l’url di per la console web è http://localhost:8080/cqportlet/cqbridge/system/console. L'utente e la password predefiniti sono admin.

Apri Configurazioni e seleziona Configurazione del server CQ della directory portale. Qui si specifica l’URL di base per l’istanza di authoring e di pubblicazione. Questa procedura è descritta in Configurazione del portlet.

Configurazione providing-configurations

Per supportare le distribuzioni automatizzate e il provisioning della configurazione, il portlet di contenuti AEM dispone di un supporto di configurazione integrato che cerca di leggere le configurazioni dal percorso di classe fornito all’applicazione portlet.

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

Se è impostato un ambiente, la ricerca in un file di configurazione si trova nel classpath in* *com/day/cq/portlet/{env}.config dove env viene sostituito con il valore effettivo per l’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, questo 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 inserita in tutti questi file - se si tratta solo di un singolo ambiente, viene inserita solo in quel file. Questo meccanismo assicura il pieno controllo sulla configurazione che viene letta in quale ambiente.

È possibile utilizzare una proprietà di sistema diversa per rilevare l'ambiente. Specificare la proprietà di sistema com.day.cq.portet.configproperty contenente il nome della proprietà di sistema da utilizzare invece di com.day.cq.portet.config.

Annullamento della validità della memorizzazione nella cache e della memorizzazione nella cache caching-and-caching-invalidation

Il portlet, nella configurazione predefinita, memorizza nella cache le risposte ricevute da AEM WCM in una cache specifica dell’utente. Le cache devono essere invalidate quando si verificano modifiche nel contenuto dell'istanza di pubblicazione. A questo scopo, in AEM WCM deve essere configurato un agente di replica nell’istanza di authoring. La cache può anche essere scaricata manualmente. Questa sezione descrive entrambe le procedure.

Il portlet può essere configurato con la 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, utilizzando CRXDE Lite o Webdav, il file da quella posizione.

Puoi distribuire questo bundle in fase di runtime o aggiungerlo all'applicazione web portlet in WEB-INF/lib/resources/bundles prima della distribuzione.

Dopo la distribuzione della cache, il portlet memorizza in cache il contenuto dall'istanza di pubblicazione. La cache del portlet può essere invalidata con uno scaricamento del dispatcher da AEM. Per configurare il portlet per l’utilizzo della propria cache:

Scaricamento della cache tramite Replication Agent flushing-the-cache-via-replication-agent

Proprio come la normale invalidazione del dispatcher, un agente di replica può essere configurato per eseguire il targeting della cache AEM portlet del portale. Dopo aver configurato l’agente di replica, ogni normale attivazione della pagina scarica la cache del portale.

Se si gestiscono più nodi portale che eseguono il portlet AEM, è necessario creare un agente per ogni 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 scaricare manualmente la cache del portlet accedendo allo stesso URL configurato per l’agente di replica. Vedi Scaricamento della cache per il modulo dell’URL. Inoltre, l'URL deve essere esteso con un parametro URL Path=<path> per indicare cosa eseguire lo scaricamento.

Ad esempio:

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

Sicurezza del portale portal-security

Il portale è il meccanismo di autenticazione alla guida. Puoi accedere a AEM sia 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 l'accesso corretto a un utente, deve essere utilizzata una soluzione SSO. In questo caso, il portlet AEM inoltra tutte le informazioni necessarie a AEM, che a sua volta inoltrano tali informazioni all’archivio AEM sottostante. Questo comportamento è collegabile e può essere personalizzato.

Autenticazione su Publish authentication-on-publish

Questa sezione descrive 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 utente all’istanza di pubblicazione di AEM; il contenuto viene sempre visualizzato come utente anonimo. Se è necessario fornire informazioni specifiche per l’utente da AEM o se è richiesta l’autenticazione utente per la pubblicazione, è necessario attivarle.

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

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

Per accedere alla configurazione di autenticazione del portlet:

Modalità utente tecnica technical-user-mode

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

L'utente tecnico specificato deve esistere nell'istanza di authoring AEM WCM e nell'istanza di pubblicazione se Autentica su Pubblica è abilitato. Assicurati di assegnare agli utenti i privilegi di accesso sufficienti per il lavoro di authoring.

SSO sso

Il portlet supporta SSO con AEM preconfigurato. Il servizio di autenticazione può essere configurato per utilizzare SSO e trasmettere l'utente del portale corrente con il formato Base come cookie denominato cqpsso AEM. AEM deve essere configurato per utilizzare il gestore di autenticazione SSO per il percorso /. Anche in questo caso è necessario configurare il nome del cookie.

La crx-quickstart/repository/repository.xml per AEM repository 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à 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 che ha effettuato l'accesso al portale viene inoltrato a AEM WCM 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 AEM sottostanti, più comunemente sotto forma di AEM WCM collegato a LDAP, o avendo creato manualmente gli utenti in precedenza. Inoltre, prima di abilitare SSO nel portlet, l'istanza di authoring AEM WCM sottostante (e l'istanza di pubblicazione, se Autentica su Pubblica è abilitato) deve essere configurato per accettare richieste basate su SSO.

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

Abilitazione dell’archivio AEM WCM per accettare credenziali affidabili enabling-aem-wcm-s-repository-to-accept-trusted-credentials

Prima di poter abilitare SSO per AEM WCM, l'archivio sottostante deve essere configurato per accettare le credenziali affidabili fornite da AEM WCM. A questo scopo, è necessario configurare AEM repository.xml.

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

Per abilitare SSO in AEM WCM, accedi alla voce di configurazione pertinente nella Console di gestione Web Apache Felix di AEM WCM (OSGi):

Per ogni richiesta AEM ricevuta da WCM, si tenta innanzitutto l'autenticazione basata su SSO. In caso di errore, viene eseguito un fallback al normale schema di autenticazione di base. Come tale, le normali connessioni a AEM WCM senza SSO rimangono possibili.

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

Affinché l’istanza WCM sottostante AEM possa accettare richieste SSO, la modalità di autenticazione del portlet deve essere commutata da Tecnico a SSO.

Per abilitare l'autenticazione SSO in un portlet AEM:

Dopo aver eseguito questa procedura, le richieste vengono autenticate utilizzando 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 utilizzi le funzioni di modifica in linea predefinite del portlet di contenuti AEM, ma desideri che la parte di authoring e amministrazione del portlet all’esterno del portale direttamente nell’istanza di authoring AEM, devi abilitare l’autenticazione PIN. È inoltre necessario modificare la configurazione dei pulsanti di gestione.

Per aprire la pagina di amministrazione del sito web o modificare una pagina dal portlet, il portlet del contenuto AEM utilizza la nuova autenticazione pin. Per impostazione predefinita, l’autenticazione tramite 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. Questo può essere fatto tramite una configurazione OSGi. Il "Day Portal Director Privilege Manager" può essere configurato con un set di ruoli per ogni privilegio. Se l’utente dispone di uno dei ruoli, l’utente dispone del privilegio corrispondente.

Inoltre è possibile definire questo accesso basato su un ruolo basato su una base di istanze di portlet per. 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 un valore è configurato, questo esclude la configurazione globale 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 AEM portlet customizing-the-aem-portlet-application

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

Pulsanti della barra degli strumenti toolbar-buttons

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

La console web OSGi elenca tutte le configurazioni dei pulsanti presenti nella Configurazione scheda . Per ogni pulsante, puoi definire in quale modalità viene visualizzato questo pulsante. Questo consente di disattivare un pulsante rimuovendo, ad esempio, tutte le modalità.

Per impostazione predefinita, il portlet di contenuti AEM utilizza la funzionalità di modifica in linea. Tuttavia, se preferisci passare all’istanza di authoring AEM per la modifica, abilita Pulsante SiteAdmin e Pulsante ContentFinder, ma disattiva 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 attraverso 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 richiesto da 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 HTML/CSS/images si trovino all'interno della cartella /com/day/cq/portlet/toolbar/layout è richiesto dal portlet e non può essere modificato. Sulle stesse linee, le intestazioni Import-Package ed Export-Package in MANIFEST.MF devono essere chiamate anche /com/day/cq/portlet/toolbar/layout. Bundle-SymbolicName deve essere un nome di pacchetto univoco e completo.

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

Viste della barra degli strumenti del portlet portlet-toolbar-views

La barra degli strumenti della portlet ha sostanzialmente due stati di visualizzazione. È possibile personalizzare ciascuna visualizzazione e i pulsanti associati con un rispettivo file HTML.

Vista di pubblicazione publish-view

Nella visualizzazione di pubblicazione è disponibile un solo pulsante che consente di passare alla visualizzazione Gestisci. La visualizzazione di pubblicazione è rappresentata dal file publish.html in bundle precedente. In HTML è possibile utilizzare i seguenti segnaposto, sostituiti dal portlet con i rispettivi contenuti durante il rendering:

Pubblicare Segnaposto Vista publish-view-placeholders

Gestisci vista manage-view

La vista Gestisci presenta quattro pulsanti: Modifica, scheda Siti Web, Aggiorna e Indietro. La vista Gestisci è rappresentata dal file manage.html nel bundle precedente. In HTML è possibile utilizzare i seguenti segnaposto, sostituiti dal portlet con i rispettivi contenuti durante il rendering:

Gestisci segnaposto visualizzazione manage-view-placeholders

Pulsanti buttons

I pulsanti, a prescindere dalla visualizzazione, utilizzano lo stesso HTML comune, definito in button.html.

In HTML è possibile utilizzare i seguenti segnaposto, sostituiti dal portlet con i rispettivi contenuti durante il rendering:

Pulsanti di visualizzazione Gestisci e pubblica 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 console Web OSGI del portlet Bundle e carica il bundle.

Pacchetti packages

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

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 parametri di rendering. Il rewriter di Portal Director HTML può essere configurato in modo da utilizzare al suo posto i collegamenti delle azioni.

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

Inoltre, è possibile configurare il rewriter di Portal Director HTML con un elenco di espressioni regolari definite esclusioni 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 di contenuti AEM dispone di una funzione di localizzazione integrata che garantisce che il contenuto di AEM sia nella lingua corretta.

Questo avviene in due passaggi:

Il gestore locale Director del portale può essere configurato con i percorsi per controllare le informazioni sulle impostazioni internazionali - di solito questo include tutto ciò che si trova sotto /content e con la posizione delle informazioni sulle impostazioni internazionali nel percorso. Per impostazione predefinita, il gestore di impostazioni internazionali segue la ridefinizione della strutturazione di siti multilingue in AEM.

Se il tuo sito non dispone di una regola restrittiva per la gestione delle informazioni sulle impostazioni internazionali all'interno del percorso, è possibile sostituire il gestore impostazioni internazionali con la tua implementazione.

Servizi OSGi opzionali optional-osgi-services

I servizi OSGi opzionali possono essere implementati per personalizzare varie parti del portlet. Ogni servizio corrisponde a un'interfaccia Java. Questa interfaccia può essere implementata e distribuita tramite un bundle nel portlet.

Sostituzione dei servizi predefiniti replacing-default-services

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

Quando implementi tale servizio, assicurati di impostare la variabile service.ranking proprietà del servizio a 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 portlet (JSR-286) specifica gli eventi portlet. Il portlet dei contenuti AEM ha un ponte integrato, che distribuisce eventi portlet per il portlet AEM come eventi OSGi - questo rende la gestione degli eventi portlet collegabili.

Se desideri gestire eventi specifici, dichiarali come eventi riceventi nel descrittore di distribuzione (o configuralo tramite il server del 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 tuo handler. 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 evento portlet.

Utilizzo di AEM come portale using-aem-as-a-portal

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

Per utilizzare AEM come portale, eseguire le operazioni seguenti:

Installazione del componente portlet installing-the-portlet-component

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

Aggiunta del componente Portlet alla barra laterale adding-the-portlet-component-to-sidekick

Aggiungi il componente portlet al sistema di paragrafi in modo che sia disponibile per gli autori.

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

Distribuisci i portlet nel contenitore Web dell’applicazione server in modo che siano disponibili per il componente Portal. Prima di distribuire l'applicazione portlet, è necessario configurare l'applicazione 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 Portale 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 AEM WCM, il server portale deve essere dotato del Portlet Director del Portale AEM. A tale scopo, installa, configura e aggiungi il portlet alla pagina del portale utilizzando i passaggi descritti in questa sezione.

Per impostazione predefinita, il portlet si connette all'istanza di pubblicazione su localhost:4503 e all'istanza di authoring su localhost:4502. Questi valori possono essere modificati durante la distribuzione del portlet. Il direttore del portale è disponibile come contenuto nell'archivio sotto /libs/portal/directory. Sarà necessario scaricare 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 del contenuto content-urls

Quando il contenuto viene richiesto da 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 è http://localhost:4503/content/geometrixx/en.portlet.html. Il valore del htmlSelector viene aggiunto automaticamente all'URL prima dell'estensione .

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

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

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

Di solito il percorso iniziale punta direttamente al contenuto in AEM. Tuttavia, se desideri mantenere i percorsi iniziali in AEM anziché nelle preferenze del portlet, puoi indirizzare il percorso iniziale a una mappa di contenuto in AEM, come /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. Dovrebbe emettere un reindirizzamento all'URL corretto.

Aggiunta del portlet alla pagina del 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: