AEM-Portale und Portlets aem-portals-and-portlets

Dieses Dokument beschäftigt sich mit den folgenden Themen:

AEM Portal-Architektur aem-portal-architecture

AEM Portalarchitektur umfasst Definitionen von Portalen und Portlets.

Was ist ein Portal? what-is-a-portal

Ein Portal ist eine Webanwendung, die Personalisierung, Single Sign-On und Inhaltsintegration aus unterschiedlichen Quellen ermöglicht und die Präsentationsschicht von Informationssystemen hostet.

Sie können JSR 286-kompatible Portlets in AEM ausführen. Mit der Portlet-Komponente können Sie ein Portlet auf der Seite einbetten. Weitere Informationen dazu finden Sie in Verwalten des AEM-Inhalts-Portlets.

Was ist ein Portlet? what-is-a-portlet

Portlets sind Webkomponenten, die innerhalb eines Containers bereitgestellt werden, der dynamische Inhalte generiert. Die Portlet-Oberfläche wird als .war-Datei in einem Portlet-Container gepackt und bereitgestellt. Wenn Sie AEM als Portal ausführen, benötigen Sie die .war-Datei des Portlets, um das Portlet auszuführen.

Informationen zum Konfigurieren AEM Inhalts für die Anzeige in einem Portal finden Sie unter Installieren, Konfigurieren und Verwenden von AEM in einem Portlet.

AEM Portal Director aem-portal-director

Verwalten des AEM Content Portlet administering-the-aem-content-portlet

Mit dem AEM Content-Portlet können Sie AEM Inhalte in einem Portal anzeigen. Das Portlet ist unter /crx-quickstart/opt/portal verfügbar und kann auf verschiedene Weise angepasst werden. Sie können beispielsweise die Handhabung von SSO/Authentifizierung anpassen, indem Sie Ihren eigenen Authentifizierungsdienst bereitstellen und die erforderlichen Authentifizierungsinformationen generieren, damit AEM das Standardverhalten überschreiben können. Die Plug-ins verwenden eine definierte API, mit der Sie eigene Funktionen hinzufügen können, indem Sie das Plug-in mit der API erstellen. Das Plug-in kann im laufenden Portlet bereitgestellt werden. Um ordnungsgemäß zu funktionieren, ist eine Konfiguration der AEM Autoren- und Veröffentlichungsinstanz sowie der Inhaltspfad erforderlich, der beim Start angezeigt werden soll.

Einige der Konfigurationen können über Portlet-Voreinstellungen und andere über OSGi-Dienstkonfigurationen geändert werden. Sie können diese Konfigurationen mithilfe von config-Dateien oder der OSGi-Web-Konsole ändern.

Portlet-Voreinstellungen portlet-preferences

Die Portlets-Voreinstellungen können zur Bereitstellungszeit im Portal-Server oder durch Bearbeiten der WEB-INF/portlet.xml Datei vor der Bereitstellung der Portlet-Webanwendung. Die Datei portlet.xml wird standardmäßig wie folgt angezeigt:

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

Das Portlet kann mit den folgenden Voreinstellungen konfiguriert werden:

OSGi-Web-Konsole osgi-web-console

Vorausgesetzt, dass der Portal-Server auf dem Host „localhost“ (Port ) ausgeführt und die Web-Anwendung des AEM-Portlets im Web-Anwendungskontext cqportlet gemountet wird, lautet die URL für die Web-Konsole http://localhost:8080/cqportlet/cqbridge/system/console:8080/. Der Standardbenutzer und das Standardkennwort lautet admin.

Öffnen Sie die Konfigurationen Registerkarte und wählen Sie Portal Directory CQ Server-Konfiguration. Hier geben Sie die Basis-URL für die Autoren- und Veröffentlichungsinstanz an. Dieses Verfahren wird im Abschnitt Konfigurieren von Portlets näher beschrieben.

Bereitstellen von Konfigurationen providing-configurations

Um automatisierte Bereitstellungen und Konfigurationsbereitstellungen zu unterstützen, verfügt das AEM-Inhalts-Portlet über integrierte Konfigurationsunterstützung, die versucht, Konfigurationen aus dem Klassenpfad zu lesen, der der Portlet-Anwendung bereitgestellt wird.

Beim Start wird die Systemeigenschaft com.day.cq.portet.config wird gelesen, um die aktuelle Umgebung zu erkennen. Normalerweise lautet der Wert dieser Eigenschaft dev, prod, test usw. Wenn keine Umgebung festgelegt ist, werden keine Konfigurationen gelesen.

Ist eine Umgebung festgelegt, wird im Klassenpfad unter com/day/cq/portlet/{umg}.config nach einer Konfigurationsdatei gesucht, wobei umg durch den tatsächlichen Wert für die Umgebung ersetzt wird. Diese Datei sollte alle Konfigurationsdateien für diese Umgebung auflisten. Diese Dateien werden relativ zum Speicherort der Konfigurationsdatei durchsucht. Wenn die Datei beispielsweise eine Zeile my.service.xml, enthält, wird diese Datei aus dem Klassenpfad unter com/day/cq/portlet/my.service.config. gelesen. Der Name der Datei besteht aus der Persistenz-ID des Service, gefolgt von .config. Im vorherigen Beispiel ist die Persistenz-ID my.service. Das Format der Konfigurationsdatei entspricht dem Format, das vom Apache Sling OSGi-Installationsprogramm verwendet wird.

Dies bedeutet, dass für jede Umgebung eine entsprechende Konfigurationsdatei hinzugefügt werden muss. Eine Konfiguration, die auf alle Umgebungen angewendet werden soll, muss in all diesen Dateien eingegeben werden - wenn sie nur für eine Umgebung bestimmt ist, wird sie nur in diese Datei eingegeben. Dieser Mechanismus gewährleistet die vollständige Kontrolle darüber, welche Konfiguration in welcher Umgebung gelesen wird.

Es ist möglich, zur Erkennung der Umgebung eine andere Systemeigenschaft zu verwenden. Angeben der Systemeigenschaft com.day.cq.portet.configproperty enthält den Namen der Systemeigenschaft, die anstelle von com.day.cq.portet.config.

Invalidierung von Caching und Caching caching-and-caching-invalidation

Das Portlet speichert in seiner Standardkonfiguration die Antworten, die es von AEM WCM erhält, in einem benutzerspezifischen Cache zwischen. Die Caches müssen invalidiert werden, wenn Änderungen am Inhalt der Veröffentlichungsinstanz auftreten. Zu diesem Zweck muss in AEM WCM ein Replikationsagent auf der Autoreninstanz konfiguriert werden. Der Cache kann auch manuell geleert werden. In diesem Abschnitt werden diese beiden Verfahren beschrieben.

Das Portlet kann mit einem eigenen Cache konfiguriert werden, sodass der Inhalt im Portlet angezeigt wird, ohne dass Zugriff auf AEM erforderlich ist. Das Portal ist als Inhalt in /libs/portal/director verfügbar. Um auf die Inhalte zuzugreifen, starten Sie eine AEM-Instanz und laden Sie mithilfe von CRXDE Lite oder Webdav die Datei aus diesem Speicherort herunter.

Sie können dieses Bundle während der Laufzeit bereitstellen oder vor der Bereitstellung der Portlet-Web-Anwendung unter WEB-INF/lib/resources/bundles hinzufügen.

Nachdem der Cache bereitgestellt wurde, speichert das Portlet Inhalte aus der Veröffentlichungsinstanz zwischen. Der Portlet-Cache kann mit einem Dispatcher-Flush aus AEM invalidiert werden. So konfigurieren Sie das Portlet, um seinen eigenen Cache zu verwenden:

Leeren des Cache über den Replikationsagenten flushing-the-cache-via-replication-agent

Genau wie die normale Dispatcher-Invalidierung kann ein Replikationsagent so konfiguriert werden, dass er den AEM Portlet-Cache des Portals abruft. Nachdem Sie den Replikationsagenten konfiguriert haben, wird bei jeder normalen Seitenaktivierung der Portal-Cache geleert.

Wenn Sie mehrere Portalknoten betreiben, die das AEM Portlet ausführen, müssen Sie für jeden Knoten einen Agenten erstellen, wie in diesem Verfahren beschrieben.

So konfigurieren Sie einen Replikationsagenten für das Portal:

Manuelles Leeren des Portlet-Cache manually-flushing-the-portlet-cache

Sie können den Portlet-Cache manuell leeren, indem Sie auf dieselbe URL zugreifen, die für den Replikationsagenten konfiguriert ist. Siehe Leeren des Cache für das Formular der URL. Darüber hinaus muss die URL mit dem URL-Parameter Path= erweitert werden<path> um anzugeben, was geleert werden soll.

Beispiel:

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* leert den vollständigen Cache. https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz leert /content/mypage/xyz aus dem Cache.

Portal-Sicherheit portal-security

Das Portal ist der treibende Authentifizierungsmechanismus. Sie können sich bei AEM entweder mit einem technischen Benutzer, dem Portal-Benutzer, einer Gruppe usw. anmelden. Das Portlet hat keinen Zugriff auf das Kennwort für den Benutzer im Portal. Wenn das Portlet also nicht alle Anmeldedaten für die erfolgreiche Anmeldung eines Benutzers kennt, muss eine SSO-Lösung verwendet werden. In diesem Fall leitet das AEM-Portlet alle erforderlichen Informationen an AEM weiter, das diese Informationen wiederum an das zugrunde liegende AEM-Repository weiterleitet. Dieses Verhalten ist austauschbar und kann angepasst werden.

Authentifizierung bei Veröffentlichung authentication-on-publish

In diesem Abschnitt werden die verfügbaren Authentifizierungsmodi beschrieben, die das Portlet für die Kommunikation mit den zugrunde liegenden AEM WCM-Instanzen verwenden kann.

Standardmäßig werden keine Benutzerinformationen an die Veröffentlichungsinstanz der AEM gesendet. der Inhalt wird immer als anonymer Benutzer angezeigt. Wenn benutzerspezifische Informationen von AEM bereitgestellt werden sollen oder eine Benutzerauthentifizierung für die Veröffentlichung erforderlich ist, muss dies aktiviert sein.

Zugriff auf die Authentifizierungskonfiguration des Portlets accessing-the-portlet-s-authentication-configuration

Die vom Portlet in AEM WCM-Instanzen verwendeten Authentifizierungskonfigurationsoptionen sind in der Web-Konsole (OSGi-Konfiguration) verfügbar.

Zugreifen auf die Portlet-Authentifizierungskonfiguration

Technischer Benutzermodus technical-user-mode

Im Standardmodus werden alle vom Portlet für die AEM WCM-Autoreninstanz ausgegebenen Anforderungen mit demselben technischen Benutzer authentifiziert, unabhängig vom aktuellen Portal-Benutzer. Der Modus Technischer Benutzer ist standardmäßig aktiviert. Sie aktivieren/deaktivieren diesen Modus auf dem entsprechenden Konfigurationsbildschirm in der OSGi-Verwaltungskonsole:

Der angegebene technische Benutzende muss auf der AEM WCM-Autoreninstanz und auf der Veröffentlichungsinstanz vorhanden sein, wenn die Option Authentifizieren bei Veröffentlichung aktiviert ist. Stellen Sie sicher, dass Sie dem Benutzer ausreichend Zugriffsberechtigungen für die Bearbeitung gewähren.

SSO sso

Das Portlet unterstützt SSO mit vorkonfigurierten AEM. Der Authentifizierungs-Service kann so konfiguriert werden, dass er SSO nutzt und aktuelle Portal-Benutzende mit dem Format Allgemein als Cookie mit dem Namen cqpsso an AEM übermittelt. AEM sollte so konfiguriert sein, dass der SSO-Authentifizierungs-Handler für den Pfad / verwendet wird. Der Cookie-Name muss hier ebenfalls konfiguriert werden.

Die Datei crx-quickstart/repository/repository.xml muss entsprechend konfiguriert sein:

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

SSO-Authentifizierungsmodus sso-authentication-mode

Das Portlet kann die Authentifizierung für AEM WCM mithilfe des Single Sign-on-(SSO)-Schemas durchführen. In diesem Modus wird der Benutzer, der sich derzeit beim Portal angemeldet hat, in Form eines SSO-Cookies an AEM WCM weitergeleitet. Wenn der SSO-Modus verwendet wird, müssen alle Portalbenutzer mit Zugriff auf das AEM Portlet den zugrunde liegenden AEM WCM-Instanzen bekannt sein, meist in Form der Verbindung von AEM WCM mit LDAP oder durch manuelles Erstellen der Benutzer im Voraus. Bevor SSO im Portlet aktiviert wird, muss die zugrundeliegende AEM WCM-Autoreninstanz (und die Veröffentlichungsinstanz, sofern Authentifizieren bei Veröffentlichung aktiviert ist) so konfiguriert werden, dass SSO-basierte Anfragen akzeptiert werden.

Um das Portlet für die Verwendung des SSO-Authentifizierungsmodus zu konfigurieren, führen Sie die folgenden Schritte aus (die in den folgenden Abschnitten detailliert beschrieben werden):

Aktivierung AEM WCM-Repositorys zum Akzeptieren vertrauenswürdiger Anmeldeinformationen enabling-aem-wcm-s-repository-to-accept-trusted-credentials

Bevor SSO für AEM WCM aktiviert werden kann, muss das zugrunde liegende Repository so konfiguriert werden, dass die von AEM WCM bereitgestellten vertrauenswürdigen Anmeldeinformationen akzeptiert werden. Dazu konfigurieren Sie AEM repository.xml.

Aktivieren der SSO-Authentifizierung im AEM WCM enabling-sso-authentication-in-the-aem-wcm

Um die einmalige Anmeldung in AEM WCM zu aktivieren, greifen Sie auf den entsprechenden Konfigurationseintrag in der Apache Felix Web Management Console (OSGi) des AEM WCM zu:

Bei jeder Anfrage, die AEM WCM erhält, wird zunächst die SSO-basierte Authentifizierung versucht. Bei einem Fehler wird ein Fallback zum üblichen grundlegenden Authentifizierungsschema durchgeführt. Daher bleiben normale Verbindungen zu AEM WCM ohne SSO möglich.

Aktivieren der SSO-Authentifizierung in einem AEM Portlet enabling-sso-authentication-in-a-aem-portlet

Damit die zugrundeliegende AEM WCM-Instanz SSO-Anfragen akzeptieren kann, muss der Authentifizierungsmodus des Portlets von Technisch in SSO geändert werden.

Zur Aktivierung der SSO-Authentifizierung in einem AEM-Portlet:

Nach dem Ausführen dieses Verfahrens werden Anforderungen mithilfe der einmaligen Anmeldung authentifiziert. Ein typisches Snippet aus der HTTP-Kommunikation zeigt das Vorhandensein der folgenden SSO- und Portlet-spezifischen Kopfzeilen:

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 -> [ ]

Aktivieren der PIN-Authentifizierung enabling-pin-authentication

Wenn Sie nicht die standardmäßigen Inline-Bearbeitungsfunktionen des AEM-Inhalts-Portlets verwenden, aber den Authoring- und Verwaltungsbereich des Portlets außerhalb des Portals direkt in der AEM Autoreninstanz verwenden möchten, sollten Sie die PIN-Authentifizierung aktivieren. Außerdem müssen Sie die Konfiguration der Verwaltungsschaltflächen ändern.

Um die Administrationsseite der Website zu öffnen oder eine Seite vom Portlet aus zu bearbeiten, verwendet das AEM Content Portlet die neue Pin-Authentifizierung. Standardmäßig ist die PIN-Authentifizierung deaktiviert. Daher müssen die folgenden Konfigurationsänderungen in AEM vorgenommen werden:

Berechtigungen privileges

Einige Funktionen des Portlets sind durch Privilegien geschützt. Der aktuelle Benutzer muss über diese Berechtigung verfügen, um auf diese Funktion zugreifen zu können. Folgende Berechtigungen sind vordefiniert:

Der beste Ansatz zur Verwaltung der Berechtigungen besteht darin, Portalrollen zu verwenden und diesen Berechtigungen Rollen zuzuweisen. Dies kann über eine OSGi-Konfiguration erfolgen. Der "Day Portal Director Privilege Manager"kann mit einer Reihe von Rollen für jede Berechtigung konfiguriert werden. Wenn der Benutzer über eine der Rollen verfügt, hat der Benutzer die entsprechende Berechtigung.

Darüber hinaus ist es möglich, diesen rollenbasierten Zugriff auf eine Portlets-Instanzenbasis zu definieren. Das Dialogfeld "Voreinstellungen"des Portlets enthält ein Eingabefeld für jede der oben genannten Berechtigungen. Für jede Berechtigung kann eine kommagetrennte Liste von Portlet-Rollen konfiguriert werden. Wenn ein Wert konfiguriert ist, überschreibt dies die globale Konfiguration aus dem Dienst "Day Portal Director Privilege Manager"und es kann erforderlich sein, dieselben Rollen aus dieser globalen Einstellung hinzuzufügen, da die Rollen nicht zusammengeführt werden! Ist kein Wert festgelegt, wird die globale Konfiguration verwendet.

Anpassen der AEM Portlet-Anwendung customizing-the-aem-portlet-application

Die bereitgestellte AEM Portlet-Anwendung startet einen OSGi-Container in der Webanwendung genauso wie AEM. Mit dieser Architektur können Sie alle Vorteile von OSGi nutzen:

Schaltflächen der Symbolleiste toolbar-buttons

Die Symbolleiste und ihre Schaltflächen sind konfigurierbar und können angepasst werden. Sie können der Symbolleiste eigene Schaltflächen hinzufügen oder festlegen, welche Schaltflächen in welchem Modus angezeigt werden. Jede Schaltfläche ist ein OSGi-Dienst, der über eine OSGi-Konfiguration konfiguriert werden kann.

Die OSGi-Web-Konsole listet alle Schaltflächenkonfigurationen auf der Konfiguration Registerkarte. Für jede Schaltfläche können Sie festlegen, in welchem Modus diese Schaltfläche angezeigt wird. Dadurch können Sie eine Schaltfläche deaktivieren, indem Sie beispielsweise alle Modi entfernen.

Standardmäßig verwendet das AEM-Inhalts-Portlet die Inline-Bearbeitungsfunktion. Wenn Sie jedoch lieber zur Bearbeitung in die AEM-Autoreninstanz wechseln möchten, aktivieren Sie die SiteAdmin-Schaltfläche und Schaltfläche "ContentFinder", aber deaktivieren Sie die Schaltfläche "Bearbeiten". Vergewissern Sie sich in diesem Fall, dass die PIN-Authentifizierung in AEM korrekt konfiguriert ist.

Das Symbolleistenlayout des Portlets kann angepasst werden, indem ein Bundle über die Felix Web Console des Portlets installiert wird, die benutzerdefinierte CSS/HTML an einem vordefinierten Speicherort enthält.

Bundle-Struktur bundle-structure

Im Folgenden finden Sie ein Beispiel für eine Bundle-Struktur:

$ 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

Der Ordner META-INF enthält die Datei MANIFEST.MF , die von OSGi benötigt wird, um sie als Bundle zu identifizieren. Sie wird wie folgt angezeigt:

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

Die Tatsache, dass sich die HTML/CSS/images im Ordner /com/day/cq/portlet/toolbar/layout befinden, wird vom Portlet vorgeschrieben und kann nicht geändert werden. Entlang derselben Zeilen müssen die Header Import-Package und Export-Package in MANIFEST.MF auch /com/day/cq/portlet/toolbar/layout genannt werden. Bundle-SymbolicName muss ein eindeutiger, vollständig qualifizierter Paketname sein.

Sie können sie mit einem Tool wie Maven erstellen oder eine solche JAR-Datei manuell mit dem entsprechenden Header erstellen, wie in diesem Abschnitt gezeigt.

Portlet-Symbolleistenansichten portlet-toolbar-views

Die Symbolleiste des Portlets weist im Grunde zwei Ansichtsstatus auf. Jede Ansicht und die zugehörigen Schaltflächen können mit einer entsprechenden HTML-Datei angepasst werden.

Veröffentlichungsansicht publish-view

Die Veröffentlichungsansicht verfügt nur über eine Schaltfläche, mit der die Symbolleiste zur Ansicht "Verwalten"wechselt. Die Veröffentlichungsansicht wird durch die Datei publish.html in vorheriges Bundle. Im HTML können Sie die folgenden Platzhalter verwenden, die beim Rendern durch das Portlet mit dem entsprechenden Inhalt ersetzt werden:

Platzhalter für Veröffentlichungsansicht publish-view-placeholders

Verwaltungsansicht manage-view

Die Verwaltungsansicht verfügt über vier Schaltflächen: Bearbeiten, Registerkarte Websites, Aktualisieren und Zurück. Die Verwaltungsansicht wird im vorherigen Bundle durch die Datei manage.html repräsentiert. Im HTML können Sie die folgenden Platzhalter verwenden, die beim Rendern durch das Portlet mit dem entsprechenden Inhalt ersetzt werden:

Verwalten von Platzhaltern in der Ansicht manage-view-placeholders

Schaltflächen buttons

Schaltflächen, unabhängig davon, in welcher Ansicht sie angezeigt werden, verwenden dieselbe allgemeine HTML, die in button.html definiert ist.

Im HTML können Sie die folgenden Platzhalter verwenden, die beim Rendern durch das Portlet mit dem entsprechenden Inhalt ersetzt werden:

Schaltflächen zur Verwaltungs- und Veröffentlichungsansicht manage-and-publish-view-buttons

Beispiel einer Datei "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>

Installieren eines benutzerdefinierten Layouts installing-a-custom-layout

Um ein benutzerdefiniertes Layout zu installieren, greifen Sie auf die OSGi-Web-Konsole des Portlets zu Bundles und laden Sie das Bundle hoch.

Pakete packages

Wenn Sie Pakete für Ihre Installation hochladen oder erstellen müssen, lesen Sie den Abschnitt „Package Manager“ in der AEM-Dokumentation, um weitere Informationen zu erhalten.

Link-Handhabung link-handling

Alle Links werden neu geschrieben, damit sie im Portalkontext funktionieren. Standardmäßig werden Links mit Render-Parametern verwendet. Der Portal Director HTML Rewriter kann so konfiguriert werden, dass stattdessen Aktionslinks verwendet werden.

Sie können auch zusätzliche Anforderungsparameter definieren, die abgefragt werden sollen, damit der Inhaltspfad angezeigt wird. Dies ist zum Beispiel dann hilfreich, wenn ein Link von außerhalb auf bestimmte Inhalte verweist.

Darüber hinaus kann der Portal Director HTML Rewriter mit einer Liste von mit regulären Ausdrücken definierten Ausschlüssen für die Link-Neuschreibung konfiguriert werden. Wenn Sie beispielsweise relative Links haben, die auf externe Systeme verweisen, sollten Sie sie dieser Ausschlussliste hinzufügen.

Lokalisierung localization

Das AEM Content-Portlet verfügt über eine integrierte Lokalisierungsfunktion, mit der sichergestellt wird, dass die Inhalte von AEM in der richtigen Sprache vorliegen.

Dies geschieht in zwei Schritten:

Der „Portal Director Locale Handler“ kann mit den Pfaden für die Suche nach Gebietsschema-Informationen – für gewöhnlich alles unter /content – und mit der Position der Gebietsschema-Informationen unter dem Pfad konfiguriert werden. Standardmäßig befolgt der „Locale Handler“ die Empfehlung zur Strukturierung von mehrsprachigen Sites innerhalb von AEM.

Falls die Regeln hinsichtlich der Handhabung von Gebietsschema-Informationen innerhalb des Pfads Ihrer Website nicht sehr streng sind, ist es möglich, den „Locale Handler“ durch Ihre eigene Implementierung zu ersetzen.

Optionale OSGi-Dienste optional-osgi-services

Optionale OSGi-Dienste können implementiert werden, um verschiedene Teile des Portlets anzupassen. Jeder Dienst entspricht einer Java-Schnittstelle. Diese Schnittstelle kann über ein Bundle im Portlet implementiert und bereitgestellt werden.

Ersetzen von Standarddiensten replacing-default-services

Die folgenden Dienste verfügen über eine Standardimplementierung im Inhalts-Portlet (mit einer entsprechenden Java-Schnittstelle). Zur Anpassung muss ein Bundle, das die neue Dienstimplementierung enthält, in der Portlet-Anwendung bereitgestellt werden.

Stellen Sie bei der Implementierung eines solchen Dienstes sicher, dass Sie die service.ranking -Eigenschaft des Dienstes auf einen positiven Wert gesetzt. Die Standardimplementierung verwendet den Rangfolgenwert 0 und das Portlet nutzt den Service mit dem höchsten Rangfolgenwert.

Portlet-Ereignisse portlet-events

Die Portlet-API (JSR-286) gibt Portlet-Ereignisse an. Das AEM Content Portlet verfügt über eine integrierte Verbindung, die Portlet-Ereignisse für das AEM Portlet als OSGi-Ereignisse verteilt - dies macht die Handhabung von Portlet-Ereignissen Pluggable.

Wenn Sie bestimmte Ereignisse verarbeiten möchten, deklarieren Sie diese im Bereitstellungsdeskriptor als Empfangsereignisse (oder konfigurieren Sie sie über Ihren Portalserver) und implementieren Sie einen OSGi-Dienst, der die EventHandler-Schnittstelle deklariert (siehe OSGi EventAdmin-Spezifikation).

Wenn ein Portlet-Ereignis auftritt, wird ein bestimmtes OSGi-Ereignis gesendet, das Ihren Handler aufruft. Der Handler ruft alle Kontextinformationen ab und kann den Status des Portlets entsprechend aktualisieren oder neue Ereignisse senden. Grundsätzlich können innerhalb des Verarbeitungsverfahrens alle Funktionen des Portlet-Ereignisses verwendet werden.

Verwenden von AEM als Portal using-aem-as-a-portal

Verwenden Sie die Portlet-Komponente, um Portlet-Fenster zu AEM Seiten hinzuzufügen. Gemeinsame Bibliotheken, die Sie auf dem Anwendungsserver installieren, ermöglichen es der Portlet-Komponente, bereitgestellte Portlet-Anwendungen zu erkennen.

Um AEM als Portal zu verwenden, führen Sie die folgenden Aufgaben aus:

Installieren der Portlet-Komponente installing-the-portlet-component

Die AEM Quickstart-JAR-Datei enthält die Portlet-Komponentendateien. Um die Dateien (cq-portlet-components.zip) zu erhalten, können Sie entweder den Schnellstart ausführen oder den Inhalt extrahieren.

Hinzufügen der Portlet-Komponente zum Sidekick adding-the-portlet-component-to-sidekick

Fügen Sie die Portlet-Komponente zum Absatzsystem hinzu, damit sie für Autoren verfügbar ist.

Konfigurieren und Bereitstellen von Portlet-Anwendungen configuring-and-deploying-your-portlet-applications

Stellen Sie die Portlets im Webcontainer des Anwendungsservers bereit, damit sie für die Portal-Komponente verfügbar sind. Bevor Sie die Portlet-Anwendung bereitstellen, müssen Sie die Anwendung so konfigurieren, dass sie das Container-Servlet des AEM-Portals lädt. Diese Konfiguration ermöglicht der Portlet-Komponente den Zugriff auf die Portlets.

Hinzufügen von Portlets zu Ihrer AEM adding-portlets-to-your-aem-page

Nutzen Sie die Portlet-Komponente zum Einfügen eines Portlet-Fensters auf Ihrer Web-Seite. Verwenden Sie die Komponenteneigenschaften, um das anzuzeigende Portlet anzugeben.

Installieren, Konfigurieren und Verwenden von AEM in einem Portlet installing-configuring-and-using-aem-in-a-portlet

Um auf von AEM WCM bereitgestellte Inhalte zuzugreifen, muss der Portal-Server mit dem AEM Portal Director Portlet ausgestattet werden. Installieren, konfigurieren und fügen Sie dazu das Portlet mithilfe der in diesem Abschnitt beschriebenen Schritte zur Portalseite hinzu.

Standardmäßig stellt das Portlet eine Verbindung zur Veröffentlichungsinstanz unter localhost:4503 und zur Autoreninstanz unter localhost:4502 her. Diese Werte können während der Bereitstellung des Portlets geändert werden. Der Portal-Director ist als Inhalt im Repository unter /libs/portal/directory verfügbar. Sie müssen die WAR-Datei der Anwendung vor der Verwendung herunterladen.

Herunterladen der WAR-Datei downloading-the-war-file

Installieren des Portlets installing-the-portlet

So installieren Sie das Portlet:

Konfigurieren des Portlets configuring-the-portlet

Nachdem Sie das Portlet installiert haben, müssen Sie es so konfigurieren, dass es die URLs der zugrunde liegenden AEM-Instanzen (Autor und Veröffentlichung) kennt. Sie können auch andere Optionen konfigurieren.

So konfigurieren Sie das Portlet:

Inhalts-URLs content-urls

Wenn Inhalte von AEM angefordert werden, verwendet das Portlet den aktuellen Anzeigemodus (Veröffentlichung oder Autor) und den aktuellen Pfad, um eine vollständige URL zusammenzustellen. Mit den Standardwerten lautet die erste URL http://localhost:4503/content/geometrixx/en.portlet.html. Der htmlSelector-Wert wird der URL automatisch vor der Erweiterung angefügt.

Wenn das Portlet in den Hilfemodus wechselt und der appendHelpViewModeAsSelector ausgewählt ist, wird ebenfalls der help-Selektor angehängt, zum Beispiel http://localhost:4503/content/geometrixx/en.portlet.html.help. Wenn das Fenster maximiert wird und der appendMaxWindowStateAsSelector ausgewählt ist, wird der Selektor ebenfalls angehängt, zum Beispiel http://localhost:4503/content/geometrixx/en.portlet.max.help.

Die Selektoren können in AEM ausgewertet und für verschiedene Selektoren kann eine andere Vorlage verwendet werden.

Verwenden einer Inhalts-URL-Map in AEM using-a-content-url-map-in-aem

Normalerweise verweist der Startpfad direkt auf den Inhalt in AEM. Falls Sie die Startpfade jedoch lieber in AEM anstatt in den Portlet-Voreinstellungen verwalten möchten, können Sie den Startpfad auf eine Inhaltskarte in AEM verweisen lassen, z. B. /var/portlets. In diesem Fall kann ein in AEM ausgeführtes Skript die übermittelten Informationen aus dem Portlet verwenden, um zu entscheiden, welche URL die Start-URL ist. Es sollte eine Umleitung zur richtigen URL ausgeben.

Hinzufügen des Portlets zur Portalseite adding-the-portlet-to-the-portal-page

So fügen Sie das Portlet zur Portalseite hinzu:

Verwenden des Portlets using-the-portlet

So greifen Sie auf die Seite zu, die Sie zum Portlet hinzugefügt haben: