AEM portaler och portlets aem-portals-and-portlets

I det här dokumentet beskrivs följande:

AEM Portal Architecture aem-portal-architecture

AEM portalarkitektur innehåller definitioner av portaler och portlets.

Vad är en portal? what-is-a-portal

En portal är ett webbprogram som innehåller personalisering, samlad inloggning, innehållsintegrering från olika källor och som är värd för informationssystemens presentationsskikt.

Du kan köra JSR 286-kompatibla portlets i AEM. Med portletkomponenten kan du bädda in en portlet på sidan. Se Administrera AEM Content Portlet.

Vad är en portlet? what-is-a-portlet

Portlets är webbkomponenter som distribueras inuti en behållare som genererar dynamiskt innehåll. Portletgränssnittet paketeras och distribueras som en .war-fil inuti en portletbehållare. Om du kör AEM som en portal måste du ha portletens .war-fil för att kunna köra portleten.

Information om hur du konfigurerar AEM innehåll så att det visas i en portal finns i Installera, konfigurera och använda AEM i en portlet.

AEM Portal Director aem-portal-director

Administrera AEM Content Portlet administering-the-aem-content-portlet

Med den AEM innehållsportleten kan du visa AEM innehåll i en portal. Portleten är tillgänglig på /crx-quickstart/opt/portal och kan anpassas på olika sätt. Du kan till exempel anpassa hanteringen av enkel inloggning/autentisering genom att distribuera din egen autentiseringstjänst och generera den autentiseringsinformation som krävs för AEM skriva över standardbeteendet. Plugin-programmen använder ett definierat API som gör att du kan lägga till egna funktioner genom att skapa plugin-programmet mot API:t. Plugin-programmet kan distribueras till den portlet som körs. För att funktionen ska fungera på rätt sätt måste AEM författare och publiceringsinstans ha en konfiguration tillsammans med innehållssökvägen som ska visas vid start.

Vissa konfigurationer kan ändras via portletinställningar och andra genom OSGi-tjänstkonfigurationer. Du ändrar dessa konfigurationer med config-filer eller OSGi-webbkonsolen.

Portletinställningar portlet-preferences

Portletinställningar kan konfigureras vid distributionen på portalservern eller genom att redigera filen WEB-INF/portlet.xml innan du distribuerar portletwebbprogrammet. Filen portlet.xml ser ut så här som standard:

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

Portleten kan konfigureras med följande inställningar:

OSGi Web Console osgi-web-console

Om portalservern körs på värddatorns lokala värd, port 8080 och webbprogrammet för AEM portlet är monterat i webbprogramskontexten cqportlet, är webbadressen för webbkonsolen https://localhost:8080/cqportlet/cqbridge/system/console. Standardanvändare och lösenord är admin.

Öppna fliken Konfigurationer och välj Portal Directory CQ Server Configuration. Här anger du bas-URL:en till författaren och publiceringsinstansen. Den här proceduren beskrivs i Konfigurera portleten.

Erbjuda konfigurationer providing-configurations

För att stödja automatiserad driftsättning och konfigureringsetablering har AEM innehållsportlet inbyggt konfigurationsstöd som försöker läsa konfigurationer från klassökvägen som tillhandahålls till portletprogrammet.

Vid start läses systemegenskapen com.day.cq.portet.config för att identifiera den aktuella miljön. Vanligtvis är värdet för den här egenskapen något som dev, prod, test och så vidare. Om ingen miljö är inställd läses inga konfigurationer.

Om en miljö är inställd genomsöks en config-fil i klassökvägen på* *com/day/cq/portlet/{env}.config där env ersätts med det verkliga värdet för miljön. Den här filen bör innehålla en lista över alla konfigurationsfiler för den här miljön. Dessa filer söks igenom i förhållande till platsen för konfigurationsfilen. Om filen till exempel innehåller raden my.service.xml, läses den här filen från klassökvägen vid com/day/cq/portlet/my.service.config. Namnet på filen består av tjänstens beständiga ID, följt av .config. I föregående exempel är beständighets-ID my.service. Konfigurationsfilens format är det format som används av installationsprogrammet för Apache Sling OSGi.

Det innebär att en motsvarande konfigurationsfil måste läggas till för varje miljö. En konfiguration som ska användas i alla miljöer måste anges i alla dessa filer - om den bara är för en enda miljö anges den bara i den filen. Denna mekanism ger fullständig kontroll över vilken konfiguration som läses i vilken miljö.

Det går att använda en annan systemegenskap för att identifiera miljön. Ange systemegenskapen com.day.cq.portet.configproperty som innehåller namnet på den systemegenskap som ska användas i stället för com.day.cq.portet.config.

Invalidering av cachelagring och cachelagring caching-and-caching-invalidation

Portleten, i standardkonfigurationen, cachelagrar svaren som tas emot från AEM WCM i en användarspecifik cache. Cacheminnen måste ogiltigförklaras när ändringar görs i innehållet i publiceringsinstansen. I AEM WCM måste därför en replikeringsagent konfigureras på författarinstansen. Cachen kan också tömmas manuellt. I det här avsnittet beskrivs båda dessa procedurer.

Portleten kan konfigureras med sin egen cache, så att innehållet i portleten visas utan att åtkomst till AEM krävs. Portalen finns som innehåll i /libs/portal/director. Om du vill komma åt innehållet startar du en AEM och hämtar filen från den platsen med CRXDE Lite eller WebDAV.

Du kan antingen distribuera det här paketet vid körning eller lägga till det i portletwebbprogrammet WEB-INF/lib/resources/bundles före distributionen.

När cacheminnet har distribuerats cachelagrar portleten innehållet från publiceringsinstansen. Portletcachen kan göras ogiltig med en dispatchertömning från AEM. Så här konfigurerar du portleten att använda sin egen cache:

Tömmer cache via replikeringsagenten flushing-the-cache-via-replication-agent

Precis som vid normal invalidering av dispatcher kan en replikeringsagent konfigureras för portalens AEM portletcache. När du har konfigurerat replikeringsagenten rensas portalcachen vid varje vanlig sidaktivering.

Om du använder flera portalnoder som kör AEM portlet måste du skapa en agent för varje nod enligt beskrivningen i den här proceduren.

Så här konfigurerar du en replikeringsagent för portalen:

Manuell tömning av portletcachen manually-flushing-the-portlet-cache

Du kan manuellt tömma portletcachen genom att gå till samma URL som konfigurerats för replikeringsagenten. Mer information om URL-formatet finns i Tömma cache. Dessutom måste URL-adressen utökas med URL-parametern Path=<path> för att ange vad som ska rensas.

Till exempel:

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* tömmer hela cachen. https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz tömmer /content/mypage/xyz från cachen.

Portal Security portal-security

Portalen är den drivande autentiseringsmekanismen. Du kan logga in AEM med en teknisk användare, portalanvändaren, en grupp och så vidare. Portleten har ingen åtkomst till lösenordet för användaren i portalen, så om portleten inte känner till alla autentiseringsuppgifter för att kunna logga in en användare måste en SSO-lösning användas. I det här fallet vidarebefordrar AEM portleten all nödvändig information till AEM, som i sin tur vidarebefordrar informationen till den underliggande AEM. Det här beteendet är anslutningsbart och kan anpassas.

Autentisering på Publish authentication-on-publish

I det här avsnittet beskrivs de tillgängliga autentiseringslägena som portleten kan använda för att kommunicera med de underliggande AEM WCM-instanserna.

Som standard skickas ingen användarinformation till publiceringsinstansen för AEM. Innehållet visas alltid som anonym användare. Om användarspecifik information ska skickas från AEM eller om användarautentisering krävs för publicering måste detta vara aktiverat.

Åtkomst till portletens autentiseringskonfiguration accessing-the-portlet-s-authentication-configuration

De alternativ för autentiseringskonfiguration som portleten använder i AEM WCM-instanser finns tillgängliga i webbkonsolen (OSGi-konfiguration).

Så här kommer du åt portletens autentiseringskonfiguration:

Tekniskt användarläge technical-user-mode

I standardläge autentiseras alla begäranden som skickas av portleten för den AEM WCM-författarinstansen med samma tekniska användare, oavsett vilken portalanvändare som används. Tekniskt användarläge är aktiverat som standard. Du aktiverar/inaktiverar det här läget i respektive konfigurationsskärm i OSGi-hanteringskonsolen:

Den angivna tekniska användaren måste finnas på den AEM WCM-författarinstansen och på publiceringsinstansen om Autentisera på Publish är aktiverat. Se till att ge användaren tillräcklig behörighet för redigeringsarbetet.

SSO sso

Portleten har stöd för enkel inloggning med AEM ur lådan. Autentiseringstjänsten kan konfigureras att använda enkel inloggning och överföra den aktuella portalanvändaren med formatet Grundläggande som en cookie med namnet cqpsso till AEM. AEM ska konfigureras att använda autentiseringshanteraren för enkel inloggning för sökvägen /. Även cookie-namnet måste konfigureras här.

crx-quickstart/repository/repository.xml för AEM måste konfigureras i enlighet med detta:

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

SSO-autentiseringsläge sso-authentication-mode

Portleten kan autentisera för AEM WCM med SSO-schemat (Single Sign On). I det här läget vidarebefordras den användare som för närvarande är inloggad på portalen till AEM WCM i form av en SSO-cookie. Om SSO-läge används måste alla portalanvändare med åtkomst till den AEM portleten vara kända för de underliggande AEM WCM-instanserna, vanligtvis i form av AEM WCM-anslutning till LDAP, eller genom att manuellt ha skapat användarna i förväg. Innan enkel inloggning aktiveras i portleten måste dessutom den underliggande AEM WCM-författarinstansen (och publiceringsinstansen, om Autentisera på Publish är aktiverat) konfigureras för att acceptera SSO-baserade begäranden.

Om du vill konfigurera portleten så att SSO-autentiseringsläget används utför du följande steg (beskrivs i detalj i följande avsnitt):

Aktivera AEM WCM-databasen för att godkänna pålitliga autentiseringsuppgifter enabling-aem-wcm-s-repository-to-accept-trusted-credentials

Innan enkel inloggning kan aktiveras för AEM WCM måste den underliggande databasen konfigureras så att den godkänner de pålitliga autentiseringsuppgifter som AEM WCM tillhandahåller. Om du vill göra det konfigurerar du AEM database.xml.

Aktivera SSO-autentisering i AEM WCM enabling-sso-authentication-in-the-aem-wcm

Om du vill aktivera enkel inloggning AEM WCM öppnar du den relevanta konfigurationsposten i AEM WCM:s Apache Felix Web Management Console (OSGi):

För varje begäran AEM WCM tar emot görs först ett försök att utföra SSO-baserad autentisering. Vid fel utförs en återställning till det vanliga grundläggande autentiseringsschemat. Därför är det fortfarande möjligt att ansluta AEM WCM utan enkel inloggning.

Aktivera SSO-autentisering i en AEM enabling-sso-authentication-in-a-aem-portlet

För att den underliggande AEM WCM-instansen ska kunna acceptera SSO-begäranden måste portletens autentiseringsläge växlas från Teknik till SSO.

Så här aktiverar du SSO-autentisering i en AEM portlet:

När du har utfört den här proceduren autentiseras begäranden med enkel inloggning. Ett typiskt utdrag från HTTP-kommunikationen visar att det finns följande SSO- och Portlet-specifika rubriker:

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

Aktivera PIN-autentisering enabling-pin-authentication

Om du inte använder standardfunktionerna för infogad redigering i AEM innehållsportlet, men vill att författaren och administrationen ska ingå i portleten utanför portalen direkt i den AEM författarinstansen, bör du aktivera PIN-autentisering. Du måste också ändra konfigurationen för hanteringsknapparna.

Om du vill öppna administrationssidan för webbplatsen eller redigera en sida från portleten använder AEM innehållsportlet den nya nålautentiseringen. Som standard är PIN-autentiseringen inaktiverad och därför måste följande konfigurationsändringar göras i AEM:

Behörighet privileges

Vissa funktioner i portleten skyddas av behörigheter. Den aktuella användaren måste ha denna behörighet för att kunna komma åt den här funktionen. Följande privilegier är fördefinierade:

Det bästa sättet att hantera behörigheter är att använda portalroller och tilldela roller till dessa behörigheter. Detta kan du göra med en OSGi-konfiguration. "Day Portal Director Privilege Manager" kan konfigureras med en uppsättning roller för varje privilegium. Om användaren har en av rollerna har användaren motsvarande behörighet.

Dessutom är det möjligt att definiera den här rollen baserat på åtkomst per portlet-instansbas. Dialogrutan med inställningar för portleten innehåller ett indatafält för var och en av de ovanstående behörigheterna. För varje privilegium kan en kommaavgränsad lista över portletroller konfigureras. Om ett värde är konfigurerat åsidosätter detta den globala konfigurationen från tjänsten "Day Portal Director Privilege Manager" och det kan krävas att samma roller läggs till från den här globala inställningen eftersom rollerna inte sammanfogas! Om inget värde anges används den globala konfigurationen.

Anpassa AEM portletprogram customizing-the-aem-portlet-application

Angivet AEM portletprogram startar en OSGi-behållare i webbprogrammet precis som AEM gör. Med den här arkitekturen kan du utnyttja alla fördelarna med OSGi:

Verktygsfältsknappar toolbar-buttons

Verktygsfältet och dess knappar är konfigurerbara och kan anpassas. Du kan lägga till egna knappar i verktygsfältet eller definiera vilka knappar som ska visas i vilket läge. Varje knapp är en OSGi-tjänst som kan konfigureras via en OSGi-konfiguration.

OSGi-webbkonsolen visar alla knappkonfigurationer på fliken Konfiguration. För varje knapp kan du definiera i vilket läge knappen ska visas. På så sätt kan du inaktivera en knapp genom att till exempel ta bort alla lägen.

Som standard använder AEM innehållsportlet redigeringsfunktionen. Om du föredrar att växla till AEM författarinstans för redigering aktiverar du SiteAdmin Button och ContentFinder Button, men inaktiverar Redigera-knappen. I så fall måste du konfigurera PIN-autentiseringen korrekt i AEM.

Portletens verktygsfältslayout kan anpassas genom att installera ett paket via portletens Felix Web Console, som innehåller anpassad CSS/HTML på en fördefinierad plats.

Paketstruktur bundle-structure

Följande är ett exempel på paketstruktur:

$ 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

Mappen META-INF innehåller filen MANIFEST.MF som krävs av OSGi för att identifiera den som ett paket. Det ser ut så här:

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

Det faktum att HTML/CSS/images finns i mappen /com/day/cq/portlet/toolbar/layout krävs av portleten och kan inte ändras. På samma rader måste även rubrikerna Import-Package och Export-Package i MANIFEST.MF heta /com/day/cq/portlet/toolbar/layout. Bundle-SymbolicName måste vara ett unikt, fullständigt paketnamn.

Du kan skapa den med ett verktyg som maven eller manuellt skapa en sådan jar-fil med den relevanta rubrikuppsättningen som visas i det här avsnittet.

Vyer i verktygsfältet Portlet portlet-toolbar-views

Portletens verktygsfält har i stort sett två visningslägen. Varje vy och tillhörande knappar kan anpassas med en HTML-fil.

Publish View publish-view

Publiceringsvyn har bara en knapp som växlar verktygsfältet till vyn Hantera. Publiceringsvyn representeras av filen publish.html i föregående paket. I HTML kan du använda följande platshållare, som ersätts av portleten med respektive innehåll när de återges:

Publish View-platshållare publish-view-placeholders

Hantera vy manage-view

I vyn Hantera finns fyra knappar: Redigera, Fliken Webbplatser, Uppdatera och Bakåt. Den hanterade vyn representeras av filen manage.html i det föregående paketet. I HTML kan du använda följande platshållare, som ersätts av portleten med respektive innehåll när de återges:

Hantera visning av platshållare manage-view-placeholders

Knappar buttons

Knappar, oavsett vilken vy de visas, använder samma HTML, som definieras i button.html.

I HTML kan du använda följande platshållare, som ersätts av portleten med respektive innehåll när de återges:

Knapparna Hantera och Publish Visa manage-and-publish-view-buttons

Exempel på filen 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>

Installera en anpassad layout installing-a-custom-layout

Om du vill installera en anpassad layout går du till portletens OSGI-webbkonsol Paket ​ och överför paketet.

Paket packages

Om du behöver överföra, eller skapa, paket för din installation finns mer information i Pakethanteraren i AEM dokumentation.

Länkhantering link-handling

Alla länkar skrivs om för att fungera i portalkontexten. Som standard används länkar med renderingsparametrar. Portal Director HTML Rewriter kan konfigureras att använda åtgärdslänkar i stället.

Du kan också definiera ytterligare frågeparametrar som ska efterfrågas för innehållssökvägen som ska visas. Detta är praktiskt om det till exempel finns en länk från utsidan till specifikt innehåll.

Dessutom kan portalen Director HTML Rewriter konfigureras med en lista över reguljära uttryck som definierats exkluderar för länkreskrivning. Om du till exempel har relativa länkar till externa system bör du lägga till dem i den här exkluderingslistan.

Lokalisering localization

Den AEM innehållsportleten har en inbyggd lokaliseringsfunktion som ser till att innehållet från AEM är på rätt språk.

Detta görs i två steg:

Portal Director Locale Handler kan konfigureras med sökvägarna för att kontrollera språkinformation. Detta omfattar vanligtvis allt under /content och med positionen för språkinformationen i sökvägen. Som standard följer språkhanteraren rekommendationen att strukturera flerspråkiga webbplatser i AEM.

Om webbplatsen inte har någon strikt regel för hantering av språkinformationen i sökvägen går det att ersätta språkhanteraren med din egen implementering.

OSGi-tjänster som tillval optional-osgi-services

OSGi-tjänster som tillval kan implementeras för att anpassa olika delar av portleten. Varje tjänst motsvarar ett Java-gränssnitt. Gränssnittet kan implementeras och distribueras via ett paket i portleten.

Ersätter standardtjänster replacing-default-services

Följande tjänster har en standardimplementering i innehållsportleten (med motsvarande Java-gränssnitt). För att kunna anpassa måste ett paket som innehåller den nya tjänstimplementeringen distribueras till portletprogrammet.

När du implementerar en sådan tjänst måste du se till att egenskapen service.ranking för tjänsten har ett positivt värde. Standardimplementeringen använder rangordningen ​ 0 och portleten använder tjänsten med högst rankning.

Portlethändelser portlet-events

Portlet API (JSR-286) anger portlethändelser. Den AEM innehållsportleten har en integrerad brygga som distribuerar portlethändelser för den AEM portleten som OSGi-händelser, vilket gör att hantering av portlethändelser kan kopplas ihop.

Om du vill hantera specifika händelser deklarerar du dessa som mottagningshändelser i distributionsbeskrivningen (eller konfigurerar dem via portalservern) och implementerar en OSGi-tjänst som deklarerar EventHandler-gränssnittet (se OSGi EventAdmin-specifikationen).

När en portlethändelse inträffar skickas en specifik OSGi-händelse som anropar hanteraren. Hanteraren hämtar all kontextinformation och kan uppdatera portletens status i enlighet med detta eller skicka nya händelser. I hanteringsmetoden kan i princip alla funktioner i portlethändelsefasen användas.

Använda AEM som portal using-aem-as-a-portal

Använd Portlet-komponenten för att lägga till portletfönster AEM sidor. Delade bibliotek som du installerar på programservern gör att Portlet-komponenten kan identifiera distribuerade portletprogram.

Utför följande uppgifter om du vill använda AEM som en portal:

Installera portletkomponenten installing-the-portlet-component

Den AEM QuickStart JAR-filen innehåller portletkomponentfilerna. Om du vill hämta filerna (cq-portlet-components.zip) kan du antingen köra QuickStart eller extrahera innehållet.

Lägga till portletkomponenten i Sidekick adding-the-portlet-component-to-sidekick

Lägg till portletkomponenten i styckesystemet så att den är tillgänglig för författare.

Konfigurera och distribuera portletprogram configuring-and-deploying-your-portlet-applications

Distribuera portlets till programserverns webbbehållare så att de är tillgängliga för portalkomponenten. Innan du distribuerar portletprogrammet måste du konfigurera programmet så att det läser in AEM portalbehållarserver. Den här konfigurationen gör att Portlet-komponenten kan komma åt portlets.

Lägga till portlets på AEM adding-portlets-to-your-aem-page

Använd portalkomponenten för att lägga till ett portletfönster på webbsidan. Använd komponentegenskaperna för att ange vilken portlet som ska visas.

Installera, konfigurera och använda AEM i en portlet installing-configuring-and-using-aem-in-a-portlet

För att få åtkomst till innehåll som tillhandahålls av AEM WCM måste portalservern vara utrustad med den AEM portalen Director Portlet. Det gör du genom att installera, konfigurera och lägga till portleten på portalsidan med hjälp av stegen i det här avsnittet.

Portleten ansluter som standard till publiceringsinstansen vid localhost:4503 och till författarinstansen vid localhost:4502. Dessa värden kan ändras under distributionen av portleten. Portaldirektören är tillgänglig som innehåll i databasen under /libs/portal/directory. Ladda ned programmets krigsfil innan du använder den.

Laddar ned krigsfilen downloading-the-war-file

Installera portleten installing-the-portlet

Så här installerar du portleten:

Konfigurera portleten configuring-the-portlet

När du har installerat portleten måste du konfigurera den så att den känner till URL:erna för de underliggande AEM instanserna (författare och publicering). Du kan också konfigurera andra alternativ.

Så här konfigurerar du portlet:

Innehålls-URL:er content-urls

När innehåll begärs från AEM, använder portleten det aktuella visningsläget (publicera eller författare) och den aktuella sökvägen för att sätta ihop en fullständig URL. Med standardvärdena är den första URL:en https://localhost:4503/content/geometrixx/en.portlet.html. Värdet för htmlSelector läggs automatiskt till i URL:en före tillägget.

Om portleten växlar till hjälpläget och appendHelpViewModeAsSelector är markerad läggs även help-väljaren till, till exempel https://localhost:4503/content/geometrixx/en.portlet.html.help. Om portletfönstret är maximerat och appendMaxWindowStateAsSelector är markerat läggs även väljaren till, till exempel https://localhost:4503/content/geometrixx/en.portlet.max.help.

Väljarna kan utvärderas i AEM och en annan mall kan användas för olika väljare.

Använda URL-karta för innehåll i AEM using-a-content-url-map-in-aem

Vanligtvis pekar startbanan direkt mot innehållet i AEM. Om du vill behålla startbanorna i AEM i stället för i portletinställningarna kan du peka startbanan mot en innehållskarta i AEM, till exempel /var/portlets. I det här fallet kan ett skript som körs i AEM använda den skickade informationen från portleten för att avgöra vilken URL som är start-URL:en. Den ska skicka en omdirigering till rätt URL.

Lägga till portleten på portalsidan adding-the-portlet-to-the-portal-page

Så här lägger du till portleten på portalsidan:

Använda portleten using-the-portlet

Så här kommer du åt sidan som du lade till i portleten: