AEM门户和Portlet

本文档将介绍以下内容：

  • AEM Portal体系结构
  • 将AEM管理和配置为门户
  • 将AEM用作门户
  • 在portlet中安装、配置和显示AEM内容（例如，Web服务器）

AEM Portal体系架构

AEM门户体系结构包括门户和Portlet的定义。

什么是门户？

门户是Web应用程序，它提供个性化、单一登录、来自不同来源的内容集成并托管信息系统的表示层。

您可以在AEM中运行符合JSR 286规范的Portlet。 portlet组件允许您在页面上嵌入portlet。 请参 阅管理AEM内容Portlet。

什么是portlet?

Portlet是部署在容器内的Web组件，用于生成动态内容。 portlet接口被打包并部署为portlet容器内的。war文件。 如果您将AEM作为门户运行，则需要portlet的。war文件才能运行portlet。

要将AEM内容配置为显示在门户中，请参 阅在portlet中安装、配置和使用AEM。

AEM Portal Director

注意

AEM Portal Director从AEM 6.4起已弃用。请参 阅已弃用和已删除功能。

管理AEM内容Portlet

AEM内容portlet允许您在门户中显示AEM内容。 Portlet在上可用， /crx-quickstart/opt/portal并且可以通过各种方式进行自定义。 例如，您可以通过部署您自己的身份验证服务来自定义SSO/身份验证处理，该服务生成AEM覆盖默认行为所需的身份验证信息。 插件使用定义的API，它允许您根据API构建插件以添加您自己的功能。 插件可部署到正在运行的portlet中。 要正常工作，它需要配置AEM作者实例和发布实例以及要在启动时显示的内容路径。

某些配置可以通过portlet首选项进行更改，而其他配置则可通过OSGi服务配置进行更改。 您可以使用配置文 件或 OSGi Web控制台更改这些配置。

Portlet首选项

可以在部署门户服务器时或通过在部署门户Web应用程序之前编辑WEB-INF/portlet.xml 文件 ，配置门户首选项。 默认情况下，portlet.xml文件如下所示：

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

Portlet可以使用以下首选项进行配置：

startPath

这是portlet的开始路径：它定义最初显示的内容。

重要说明:如果portlet配置为连接到AEM作者实例并发布在不同于 //的上下文路径上运行的实例，则需要在这些AEM实例的Html库管理器配置中启用强制 CQUrlInfo （例如，通过Felix Webconsole）或编辑将无法正常工作，且将不显示首选项对话框。
htmlSelector 附加到每个URL的选择器。 默认情况下，这是 portlet，因此对html页面的所有请求都使用以 .portlet.html结尾的url。 这允许在AEM中使用自定义脚本进行portlet渲染。
addCssToPortalHeader

默认情况下，包含在AEM的HTML页面中的css文件包含在portlet中。 禁用此选项将不包括默认的css文件。

如果启用此选项，则CSS文件将添加到html页面的标题中或嵌入到html页面中，具体取决于门户的行为。
includeToolbar 默认情况下，在内容portlet中显示一个工具栏以用于管理功能。 通过禁用此选项，不会呈现任何工具栏。
urlParameterNames

列表可能包含要为portlet显示的新内容URL的替代URL参数名称。 从上到下处理列表，使用包含值的第一个参数。 如果未找到URL，则使用默认的URL参数。 提供的URL按原样使用，无需进一步修改。

此设置是按部署的portlet进行的——还可以在“Day Portal Director Portlet Bridge”的OSGi配置中全局配置一些url参数。
preferenceDialog AEM中首选项对话框的路径——如果留空，则将使用内置首选项对话框。 默认为/libs/portal/content/prefs.html。
initialRedirect 默认情况下，portlet在第一次调用时执行整个门户页面的javascript重定向。 这是为了支持现代门户服务器的拖放场景。 在生产中，很少需要此重定向，因此可以关闭此首选项，将其设置为 false。

OSGi Web控制台

假定门户服务器运行在主机localhost上，端口8080，并且AEM portlet Web应用程序装载在Web应用程序上下文 cqportlet，则Web控制台的url为 https://localhost:8080/cqportlet/cqbridge/system/console。 默认的用户和密码为 admin。

打开“配 置 ”选项卡，选择 “门户目录CQ服务器配置”。 在此处，您指定作者和发布实例的基本URL。 配置Portlet中介绍 了此过程。

注意

OSGi Web控制台仅用于在开发（或测试）期间更改配置。 确保阻止对生产系统控制台的请求。

提供配置

为支持自动部署和配置配置配置，AEM内容portlet具有内置配置支持，可尝试从提供到portlet应用程序的类路径中读取配置。

启动时，将读取系统 属性com.day.cq.portet.config ，以检测当前环境。 通常，此属性的值类似于 dev、 prod、 test 等。 如果未设置环境，则不会读取配置。

如果设置了环境，则会在类路径* *com/day/cq/portlet/{env}.config中搜索配置文件，其中 env ​​被替换为环境的实际值。 此文件应列表此环境的所有配置文件。 这些文件会相对于配置文件的位置进行搜索。 例如，如果文件包含一行，则从 my.service.xml, classpath中读取此文件，该文件的名称由服务的持久性ID组成，后跟 com/day/cq/portlet/my.service.config. .config ​。 在上一个示例中，持久性ID 是my.service。 配置文件的格式是Apache Sling OSGi安装程序使用的格式。

这意味着，对于每个环境，都需要添加相应的配置文件。 应应用于所有环境的配置需要在所有这些文件中输入——如果仅用于单个环境，则只需在该文件中输入。 此机制确保完全控制读取哪个环境的配置。

可以使用不同的系统属性来检测环境。 指定系统属 性com.day.cq.portet.configproperty ，其中包含要使用的系统属性名称，而不 是com.day.cq.portet.config。

缓存和缓存失效

portlet在其默认配置中将其从AEM WCM接收的响应缓存到用户特定的缓存中。 当发布实例的内容发生更改时，缓存需要失效。 为此，在AEM WCM中，必须在创作实例上配置复制代理。 也可以手动刷新缓存。 本节将介绍这两个过程。

Portlet可以配置其自己的缓存，这样便无需访问AEM即可显示Portlet中的内容。 门户在/libs/portal/director中以内容形式提供。 要访问内容，请开始AEM实例，然后使用CRXDE Lite或Webdav从该位置下载文件。

您可以在运行时部署此捆绑包，也可以在部署之前将其添加到portlet WEB-INF/lib/resources/bundles web应用程序。

部署缓存后，portlet缓存来自发布实例的内容。 使用来自AEM的调度程序刷新，portlet缓存可以失效。 要配置portlet以使用其自己的缓存，请执行以下操作：

  1. 在作者中配置目标门户服务器的复制代理。
  2. 假定门户服务器在主机 localhost、端口8080 上运行，并且AEM portlet Web应用程序已装载到上下文 cqportlet，则刷新缓存的url为 https://localhost:8080/cqportlet/cqbridge/cqpcache?Path=$(path)。 使用GET作为方法。
    注意： 您可以发送名为Path的http头，而不是使用请求 参数。

通过复制代理刷新缓存

与正常的调度程序失效一样，复制代理也可以配置为目标门户的AEM portlet缓存。 配置复制代理后，每个常规页面激活都会刷新门户缓存。

如果运行AEM Portlet的多个门户节点，则需要为每个节点创建一个代理，如本过程所述。

为门户配置复制代理：

  1. 登录到创作实例。

  2. 在“网站”选项卡中，单击“工 具 ”选项卡。

  3. 单击 新建页面…… 在复制代理中， 新增…… 菜单。

    screen_shot_2012-02-15at40647pm

  4. 在模 板中，选择 复制代理，然后输入代理的名称。 单击​创建。

    screen_shot_2012-02-15at40817pm

  5. 多次-单击您刚刚创建的复制代理。 它显示为无效，因为尚未配置。

    screen_shot_2012-02-15at41001pm

  6. Click Edit.

  7. 在“设 置 ”选项卡中，选择“已启用 ”复选框，选择 Dispatcher Flush ​​作为序列化类型，然后输入重试超时（例如，60000）。

    screen_shot_2012-02-15at42101pm

  8. Click the Transport tab.

  9. 在 URI字段 ，输入portlet的刷新URI(URL)。 URI的形式如下：

    https://<wps-host>:<port>/<wps-context>/<cq5-portlet-context>/cqbridge/cqpcache

    screen_shot_2012-02-15at42322pm

  10. Click the Extended tab.

    screen_shot_2012-02-15at42515pm

  11. 在“ HTTP方法 ”字段中，键 入GET。

  12. 在“ HTTP头”字段 ，单击 +以添加新条目并键入​路径：{path}。

  13. 如有必要，请单击“ 代理 ”选项卡，然后向代理输入代理信息。

  14. Click OK to save changes.

  15. 要测试连接，请单击“测 试连接 ”链接。 将显示一条日志消息，指示复制测试是否成功。 例如：

    screen_shot_2012-02-15at42639pm

手动刷新Portlet缓存

您可以通过访问为复制代理配置的同一URL手动刷新portlet缓存。 请参 阅刷新缓存 ，以查找URL的形式。 此外，URL需要扩展，并带有URL参数Path=<path>，以指示要刷新的内容。

例如：

https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* 刷新完整缓存。 https://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz 从缓 /content/mypage/xyz 存中刷新。

门户安全性

门户是驱动认证机制。 您可以与技术用户、门户用户、用户组等登录AEM。 Portlet无权访问门户中用户的口令，因此，如果Portlet不知道成功登录用户的所有凭据，则必须使用SSO解决方案。 在这种情况下，AEM Portlet会将所有必需信息转发到AEM,AEM Portlet又会将此信息转发到基础AEM存储库。 此行为可插拔，并且可以自定义。

发布时身份验证

本节介绍Portlet在与基础AEM WCM实例通信时可用的身份验证模式。

默认情况下，不会向AEM的发布实例发送用户信息；内容始终显示为匿名用户。 如果应从AEM传送用户特定信息，或者如果需要用户进行发布身份验证，则必须打开此选项。

访问Portlet的身份验证配置

Portlet在AEM WCM实例中使用的身份验证配置选项在Web控制台（OSGi配置）中可用。

注意

使用AEM时，有多种方法可管理OSGi服务（控制台或存储库节点）的配置设置。

有关完 整的详细信息 ，请参阅配置OSGi。

要访问portlet的身份验证配置：

  1. 访问位于以下URL的Web控制台：

    https://localhost:8080/cqportlet/cqbridge/system/console

    例如，在其默认配置中：

    https://wps-host:10040/wps/PA_CQ5_Portlet/cqbridge/system/console

  2. 登录到Web控制台。 默认凭据为 admin/admin。

  3. 在控制台中，选择 配置。

  4. 在“配 置 ”菜单中，选择要配置的特定服务。 服务由OSGi框架中的portlet提供。

    服务名称 描述
    Day Portal Director Authenticator 配置用于AEM WCM实例的身份验证模式。 根据所选模式，可以指定技术用户或SSO Cookie的名称。 此外，还可以启用AEM WCM发布实例的身份验证。
    Day Portal Director文件缓存 配置portlet缓存其从AEM WCM实例接收的响应方式的参数。
    Day Portal Director HTTP客户端服务 配置portlet如何通过HTTP连接到基础AEM WCM实例。 例如，可以指定代理服务器。
    Day Portal Director区域设置处理程序 配置portlet支持的区域设置。 对AEM WCM实例的请求基于用户区域设置；例如，用户语言德语将请求 /content/geometrixx/de/…
    Day Portal Director权限管理器 根据当前登录的用户配置portlet是否应测试“网站”选项卡。
    Day Portal Director工具栏渲染器 自定义portlet工具栏的呈现。

  5. 此外，您还可以配置Web控制台和日志记录服务。 例如，您可以通过单击Apache Felix OSGi管理控制台链接来更改Web控制台的管理凭据。

技术用户模式

在默认模式下，Portlet为AEM WCM作者实例发出的所有请求都将使用同一技术用户进行身份验证，而不管当前门户用户如何。 技术用户模式默认为启用状态。 在OSGi管理控制台中的相应配置屏幕中启用／禁用此模式：

如果启用了“发布时验证”，则指定的技术用户必须存在于AEM WCM作者实例和发布实 例中 。 请务必为用户授予足够的访问权限，以便进行创作。

SSO

Portlet支持AEM的SSO（现成）。 可以将身份验证器服务配置为使用SSO并以AEM命名的cookie格式 Basic 传输当前门户用 cqpsso 户。 应将AEM配置为使用路径／的SSO身份验证处理程序。 此处也需要配置Cookie名称。

需 crx-quickstart/repository/repository.xml 要相应地配置AEM存储库：

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

SSO身份验证模式

Portlet可以使用单点登录(SSO)方案对AEM WCM进行身份验证。 在此模式中，当前登录到门户的用户将以SSO cookie的形式转发到AEM WCM。 如果使用SSO模式，则对AEM Portlet具有访问权限的所有门户用户都必须知道底层AEM WCM实例，最常见的方式是将AEM WCM连接到LDAP，或者事先手动创建用户。 此外，在portlet中启用SSO之前，需要将基础AEM WCM作者实例(如果启用了“发布时验证” ​​，则还需将发布实例)配置为接受基于SSO的请求。

要将portlet配置为使用SSO身份验证模式，请完成以下步骤（在以下各节中有详细说明）:

  • 启用AEM WCM的存储库以接受受信任的凭据。
  • 在AEM WCM中启用SSO身份验证。
  • 在AEM Portlet中启用SSO身份验证。

使AEM WCM的存储库接受受信任凭据

在为AEM WCM启用SSO之前，需要将基础存储库配置为接受AEM WCM提供的受信任凭据。 为此，请配置AEM的repository.xml。

  1. 在安装AEM WCM的文件系统中，打开以下文件：

    /crx-quickstart/repository/repository.xml

  2. 在XML文件中，找到 LoginModule的条目 ，并将trust_credentials_attribute添加到其配置中：

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

  3. 重新启动AEM WCM，使更改生效。

在AEM WCM中启用SSO身份验证

要在AEM WCM中启用SSO，请访问AEM WCM的Apache Felix Web管理控制台(OSGi)中的相关配置条目：

  1. 通过位于https://<AEM-host>:<port>/system/console的URI访问控制台。

  2. 在“配置”菜单中，选择“SSO身份验证处理程序”。 在此示例中，SSO处理函数根据AEM portlet提供的cookie接受所有路径的SSO请求。 您的配置可能会有所不同。

    路径 / 为所有请求启用SSO处理程序
    Cookie名称 cqpsso portlet提供的cookie的名称（在portlet的OSGi控制台中配置）。

  3. 单击 保存 ，以启用SSO。 SSO现在是主要的身份验证方案。

对于AEM WCM收到的每个请求，首先尝试基于SSO的身份验证。 在失败时，执行回退到通常的基本认证方案。 因此，与AEM WCM的正常连接（无SSO）仍然可能。

在AEM Portlet中启用SSO身份验证

为了使基础AEM WCM实例接受SSO请求，必须将portlet的身份验证模式从 Technical 切换 为SSO。

要在AEM Portlet中启用SSO身份验证，请执行以下操作：

  1. 通过位于https://<aem-host>:<port>/system/console的URI访问控制台。

  2. 在“配置”菜单中，从可用配置的列表中选择Day Portal Director Authenticator。

  3. 在“模式”中，选择“SSO”。 保留其他参数的默认值。

    chlimage_1-135

  4. 单击保存以为portlet启用SSO。

    出于测试目的，在AEM WCM中以管理员权限创建同一用户后，请通过门户的管理用户访问portlet。

执行此过程后，请求将使用SSO进行身份验证。 HTTP通信中的典型代码片断显示存在以下特定于SSO和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 -> [ ]

启用PIN身份验证

如果您未使用AEM内容portlet的默认内联编辑功能，但希望门户的创作和管理部分直接在AEM作者实例中位于门户外部，则应启用PIN身份验证。 您还需要更改管理按钮的配置。

要打开网站管理页面或从portlet编辑页面，AEM内容portlet将使用新的pin身份验证。 默认情况下，禁用PIN身份验证，因此，必须在AEM中进行以下配置更改：

  1. 通过在repository.xml文件中添加受信任的信息，在AEM中启用受信任身份验证：

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

  2. 在OSGi配置控制台(默认位于https://localhost:4502/system/console/configMgr)中，从下拉菜单中选择 CQ PIN身份验证处理程序 。

  3. 编辑 URL根路径参数 ，以仅包含单个值 /。

权限

portlet的某些功能受权限保护。 当前用户需要具有此权限才能访问此函数。 预定义了以下权限：

  • “工具栏”:这是查看／使用portlet中工具栏的一般权限。
  • “prefs”:如果用户具有此权限，则允许用户查看／更改portlet的首选项。
  • “cq-author:edit”:使用此权限，用户可以调用内容的编辑视图。
  • "cq-author:预览":使用此权限，用户可以查看预览。
  • "cq-author:siteadmin":通过此权限，用户可以在AEM中打开siteadmin。

管理权限的最佳方法是使用门户角色并为这些权限分配角色。 这可以通过OSGi配置完成。 “Day Portal Director Privilege Manager”可为每个权限配置一组角色。 如果用户具有其中一个角色，则该用户具有相应的权限。

此外，还可以根据每个portlet实例库的访问来定义此角色。 portlet的首选项对话框包含针对上述每个权限的输入字段。 对于每个权限，可以配置以逗号分隔的portlet角色列表。 如果配置了值，则这将覆盖“Day Portal Director Privilege Manager”服务中的全局配置，并且可能需要从此全局设置添加相同的角色，因为这些角色未合并！ 如果未指定值，则使用全局配置。

自定义AEM Portlet应用程序

提供的AEM Portlet应用程序与AEM一样，在Web应用程序中开始OSGi容器。 此架构允许您利用OSGi的所有优势：

  • 易于更新和扩展
  • 在门户服务器不进行任何交互的情况下提供portlet的热更新
  • 轻松自定义portlet

工具栏按钮

工具栏及其按钮是可配置的，并且可以自定义。 您可以向工具栏添加您自己的按钮，或定义在哪个模式下显示的按钮。 每个按钮都是可通过OSGi配置配置的OSGi服务。

OSGi Web控制台列表“配置”选项卡上的所有按 钮配置 。 对于每个按钮，您可以定义显示此按钮的模式。 这允许您通过删除所有模式（例如）来禁用按钮。

默认情况下，AEM内容portlet使用内联编辑功能。 但是，如果您希望切换到AEM作者实例进行编辑，请启用 SiteAdmin按钮和 ContentFinder按钮 ，但禁用“编​辑按钮” ​。 在这种情况下，请确保在AEM中正确配置PIN身份验证。

可以通过portlet的Felix Web控制台安装捆绑包来自定义portlet的工具栏布局，该控制台包含预定义位置的自定义CSS/HTML。

捆绑结构

以下是一个示例包结构：

$ 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

META-INF文件夹包含OSGi要求的MANIFEST.MF文件，以将其标识为包。 其显示如下：

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

HTML/CSS/images位于/com/day/cq/portlet/toolbar/layout文件夹中这一事实由portlet规定，并且无法更改。 同样，MANIFEST.MF中的导入包和导出包标题也必须被称为/com/day/cq/portlet/toolbar/layout。 Bundle-SymbolicName必须是唯一的完全限定的包名称。

您可以使用手动或手动创建此类jar文件等工具构建它，这些jar文件具有本节中所示的相关标题集。

Portlet工具栏视图

portlet的工具栏基本上有两个视图状态。 每个视图和关联按钮都可以用相应的HTML文件进行自定义。

发布视图

发布视图只有一个按钮，可将工具栏切换到管理视图。 发布视图由上一个包中的publish.html文件 表示。 在HTML中，您可以使用以下占位符，在呈现时，这些占位符将由portlet替换为相应的内容：

发布视图占位符

占位符字符串 描述
占位符由“管 理 ”按钮替换，“管理”按钮将portlet状态切换到管理状态。

管理视图

管理视图有四个按钮：“编辑”、“网站”选项卡、“刷新”和“返回”。 管理视图由上一个包中的manage.html文件 表示。 在HTML中，您可以使用以下占位符，在呈现时，这些占位符将由portlet替换为相应的内容：

管理视图占位符

占位符字符串 描述
占位符由“编 辑 ”按钮替换，该按钮在AEM的编辑模式下打开一个包含当前页面的新窗口。
占位符，替换为打开AEM WCM的“网站”选项卡的按钮。
刷新当前视图。
将portlet切换回发布视图。

按钮

按钮无论在哪个视图上显示，都使用在button.html中定义的相同的HTML。

在HTML中，您可以使用以下占位符，在呈现时，这些占位符将由portlet替换为相应的内容：

管理和发布视图按钮

占位符字符串 描述
按钮的名称，例如，作者、返回、刷新​等。
按钮的CSS ID。
按钮目标的URL。
按钮的标签。
Javascript onclick函数 （包含{url}）。

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>

安装自定义布局

要安装自定义布局，请访问portlet的OSGI Web控制台​捆绑包​部分并上传捆绑包。

包

如果您需要上传或创建安装包，请参阅AEM文档中的包管理器以获取详细说明。

所有链接都会重写以在门户上下文中工作。 默认情况下，使用与渲染参数相关的链接。 可以将门户控制器HTML Rewriter配置为改用操作链接。

您还可以为要显示的内容路径定义要查询的其他请求参数。 这很有用，例如，如果有从外部到特定内容的链接。

此外，门户控制器HTML Rewriter可配置一列表为链接重写定义的常规表达式。 例如，如果您有到外部系统的相对链接，则应将这些链接添加到此排除列表。

本地化

AEM内容portlet具有内置的本地化功能，可确保AEM中的内容使用正确的语言。

此操作分两步完成：

  1. 门户目录区域设置检测器通过从门户获取区域设置来检测门户用户的区域设置。 此服务必须在AEM中配置可用语言的列表。
  2. 门户控制器区域设置处理程序处理当前请求的本地化。 它采用所请求内容的路径，例如， /content/geometrixx/en/company.html并根据配置，使用用户的实际区 域设置重写 en。

门户控制器区域设置处理程序可以配置用于检查区域设置信息的路径——通常，这包括路径中区域设置信息下的所有内容以及区域设置信息在路径中的位置。 /content 默认情况下，区域设置处理函数遵循在AEM中重新公用的结构化多语言站点。

如果您的站点没有处理路径中区域设置信息的严格规则，则可以将区域设置处理程序替换为您自己的实现。

可选OSGi服务

可以实施可选的OSGi服务以自定义portlet的各个部分。 每个服务对应一个Java接口。 此接口可以通过portlet中的捆绑实现和部署。

RequestTracker 只要Portlet显示内容，请求跟踪器就会收到通知。 这允许您跟踪portlet的调用情况。
InvocationContextListener 在对portlet的每个请求的开始和结尾处调用的监听器。 监听器可用于更改或添加当前请求的信息。
ErrorHandler 渲染阶段错误的自定义错误处理程序。
HttpProcessor 此服务可用于向AEM的每个http调用添加信息。
PortletAction 向portlet添加自己的操作——可以通过portlet操作链接调用此操作。
PortletDecoratorService 此服务可用于装饰portlet的内容。
资源提供者 添加您自己的资源提供者，以便通过指向客户端的portlet资源链接交付某些资源。
TextMapper 允许您发布处理HTML、CSS和Javascript文件。
工具栏按钮 将您自己的按钮添加到工具栏。
UrlMapper 添加服务以应用自定义URL映射或重写。
UserInfoProvider 添加您自己的用户信息。 此服务可用于从门户获取信息到portlet。

替换默认服务

以下服务在内容portlet中具有默认实现（带有相应的Java界面）。 要进行自定义，需要将包含新服务实现的包部署到portlet应用程序中。

在实施此类服务时，请确保将服 务的service.ranking 属性设置为正值。 默认实现使用排名 0,portlet使用排名最高的服务。

名称 描述 默认行为
身份验证器 向AEM提供身份验证信息 使用可配置的技术用户进行创作和发布。 或者可以使用SSO。
HTMLRewriter 重写链接、图像等 重写指向门户链接的AEM链接，可以通过UrlMapper和TextMapper进行扩展
HttpClientService 处理所有http连接 标准实施
LocaleHandler 处理区域设置信息 重写指向与区域设置相关的内容的链接。
LocaleDetector 检测用户的区域设置。 使用门户提供的区域设置。
PrivilegeManager 检查用户权限 检查用户是否可以编辑内容时对创作实例的访问
ToolbarRenderer 呈现工具栏 添加工具栏功能

Portlet事件

portlet API(JSR-286)指定portlet事件。 AEM内容portlet具有集成桥接器，它将AEM portlet的portlet事件作为OSGi事件分发——这使portlet事件的处理变得可插拔。

如果要处理特定事件，请在部署描述符中声明这些事件为接收（或通过门户服务器配置它），并实现声明EventHandler接口的OSGi服务（请参阅OSGi EventAdmin规范）。

每当发生portlet事件时，都会调用您的处理函数发送特定的OSGi事件。 该处理程序获取所有上下文信息，并可以相应地更新portlet的状态或发送新事件。 基本上，在句柄方法中，可以使用portlet事件阶段的所有功能。

将AEM用作门户

使用Portlet组件将Portlet窗口添加到AEM页面。 您安装到应用程序服务器的共享库使Portlet组件能够检测已部署的Portlet应用程序。

要将AEM用作门户，请执行以下任务:

  1. 安装Portlet组件和共享库。
  2. 将Portlet组件添加到Sidekick。
  3. 配置和部署Web应用程序，该应用程序包含要显示在门户组件中的Portlet。
  4. 将Portlet组件添加到页面，然后选择要显示的Portlet。
注意

仅当AEM部署为Web应用程序时，才可以使用portlet组件。 (请参阅使用应用程序服务器安装AEM。)

安装portlet组件

AEM快速启动JAR文件包含portlet组件文件。 要获取文件(cq-portlet-components.zip)，您可以执行快速启动或提取内容。

  1. 执行或提取Quickstart JAR文件的内容，并相应地找到cq-portlet-components.zip文件：

    • 执行快速启动：crx-quickstart/opt/portal
    • 提取快速入门内容：静态／选择／门户

  2. 打开部署到应用程序服务器的CQ5作者实例的包管理器。 (https://appserverhost:port/cq5author/crx/packmgr)

  3. 使用包管理器 上传和安装 cq-portlets-components.zip包。

    该包将在存储库的/libs/portal/director文件夹中安装cq-portlet-director-sharedlibs-x.x.jar。

  4. 将cq-portlet-director-sharedlibs-x.x.jar复制到硬盘驱动器。 使用任何方式获取文件，例如FileVault或WebDAV客户端。

  5. 将cq-portlet-director-sharedlibs.x.x.x.jar文件移至应用程序服务器的共享库文件夹，以便这些类可用于部署的portlet应用程序。

将Portlet组件添加到Sidekick

将portlet组件添加到段落系统，以便作者可以使用它。

  1. 在Sidekick中，单击标尺图标以进入设计模式。

  2. 在第一 Design of par 段落上方的标题旁，单击“编 辑”。

  3. 在“常 规 ”组件类别中，选中Portlet组件旁边的复选框，然后单击“确定”。

chlimage_1-25

配置和部署Portlet应用程序

将portlet部署到应用程序服务器Web容器，以便它们可用于门户组件。 在部署portlet应用程序之前，您需要配置应用程序，以便它加载AEM门户容器servlet。 此配置使Portlet组件能够访问Portlet。

  1. 提取portlet应用程序WAR文件的内容。

    提示： jar xf nameofapp **.war命令提取文件。

  2. 在文本编辑器中打开web.xml文件。

  3. 在Web应用程序元素中添加以下Servlet配置：

    <servlet>
        <servlet-name>slingportal</servlet-name>
        <servlet-class>org.apache.sling.portal.container.api.ContainerServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
        <servlet-name>slingportal</servlet-name>
        <url-pattern>/SlingPortletInvoker</url-pattern>
</servlet-mapping>

  4. 保存web.xml文件并重新打包WAR文件。

    提示： 该命 jar cvf nameofapp.war * 令将当前目录的内容添加到app.war文件的名称中。

  5. 将portlet应用程序部署到应用程序服务器。 有关信息，请参阅应用程序服务器的相关文档。

将Portlet添加到AEM页面

使用门户组件可向网页添加portlet窗口。 使用组件属性指定要显示的portlet。

  1. 在网页上，将 Portlet 组件从Sidekick中的常规组拖动到页面。

    注意

    将组件拖动到页面后，请重新加载页面以确保其正常工作。

  2. 多次-单击组件以打开Portlet属性。

  3. 在 Portlet Entity （Portlet实体）下拉菜单中，从列表中选择portlet。

  4. 根据您是否要查看portlet的标题栏，选择或清除“隐藏标题栏”复选框。

  5. 在Portlet窗 口字段中 ，根据需要输入唯一的Portlet窗口ID。

    注意

    如果计划在同一页面上多次使用同一Portlet，请为每个Portlet提供一个不同的窗口ID。

  6. 单击​确定。Portlet将显示在您的AEM页面上。

    chlimage_1-136

在Portlet中安装、配置和使用AEM

要访问AEM WCM提供的内容，门户服务器需要与AEM门户Director Portlet相配合。 要执行此操作，请按照本节中提供的步骤安装、配置Portlet并将其添加到门户页面。

默认情况下，portlet连接到localhost:4503处的发布实例和localhost:4502处的作者实例。 这些值可以在部署Portlet期间进行更改。 门户控制器在/libs/portal/directory下作为存储库中的内容可用。 您需要先下载应用程序war文件，然后再使用它。

下载war文件

  1. 使用Webdav或CRXDE Lite导航到/libs/portal/director。

  2. 下 载cq-portlet-webapp.war。

注意

这些过程以Websphere门户为例，尽管它们尽可能通用；请注意，其他Web门户的程序会有所不同。 尽管所有Web门户的步骤基本相同，但您需要为特定Web门户重新设定这些步骤的用途。

安装portlet

安装Portlet:

  1. 以管理员权限登录到门户。

  2. 导航到Web门户的Portlet Management部分。

  3. 单击“安装”并浏览至您下载的AEM Portlet应用程序(cq-portlet-webapp.war)，然后输入有关Portlet的其他重要信息。

    对于其他基本portlet信息，您可以接受默认值或更改值。 如果您接受默认值，则portlet可在https://<wps-host>:<port>/wps/PA_CQ5_Portlet访问。 portlet提供的OSGi管理控制台位于https://<wps-host>:<port>/wps/ PA_CQ5_Portlet/cqbridge/system/console（默认用户名／密码为admin/admin）。

  4. 通过选中该选项或复选框，确保portlet应用程序自动开始，并保存您所做的更改。 您会看到一条消息，指示您的安装成功。

配置Portlet

安装portlet后，您需要配置它，以便它知道基础AEM实例的URL（创作和发布）。 您还可以配置其他选项。

要配置Portlet，请执行以下操作：

  1. 在应用程序服务器的门户管理窗口中，导航到portlet管理，其中列出了所有portlet，然后选择AEM门户控制器portlet。

  2. 根据需要配置portlet。 例如，您可能需要更改创作和发布实例的URL和开始路径的URL。 默认配置在 Portlet首选项中有介绍。

    注意

    如果portlet配置为连接到AEM作者实例和发布在不同于 /​的上下文路径上运行的实例，则您需要在这些AEM实例的Html库管理器配置中启用强制 CQUrlInfo （例如，通过Felix Webconsole）或编辑功能将无法正常工作，并且将不显示首选项对话框。

  3. 在应用程序服务器中保存配置更改。

  4. 导航到Portlet的OSGI管理控制台。 默认位置为 https://<wps-host>:<port>/wps/PA_CQ5_Portlet/cqbridge/system/console/configMgr。 默认用户名／密码为 admin/admin。

  5. 选择Day Portal Director CQ服务器配置 ，并编辑以下值：

    • 作者基本URL:AEM作者实例的基本URL。
    • 发布基本URL:AEM发布实例的基本URL。
    • 作者用作发布:作者实例是否用作发布实例（用于开发）?

    chlimage_1-137

  6. 单击​保存。您现在可以将portlet添加到门户页面并使用门户。

内容URL

当从AEM请求内容时，Portlet将使用当前显示模式（发布或作者）和当前路径来组合完整的URL。 使用默认值时，第一个url为 https://localhost:4503/content/geometrixx/en.portlet.html。 该扩展名 htmlSelector 之前的值会自动添加到URL。

如果portlet切换到帮助模式并且选 appendHelpViewModeAsSelector 择了该模式，则 help 选择器也会附加，例如， https://localhost:4503/content/geometrixx/en.portlet.html.help。 如果Portlet窗口已最大化， appendMaxWindowStateAsSelector 并且选择了该窗口，则选择器也会附加，例如 https://localhost:4503/content/geometrixx/en.portlet.max.help。

可在AEM中评估选择器，而不同的模板可用于不同的选择器。

在AEM中使用内容Url映射

通常，开始路径直接指向AEM中的内容。 但是，如果要在AEM中而不是Portlet首选项中维护开始路径，您可以将开始路径指向AEM中的内容映射，如 /var/portlets。 在这种情况下，在AEM中运行的脚本可以使用portlet中提交的信息来决定哪个url是开始URL。 它应发出指向正确URL的重定向。

将Portlet添加到门户页面

要将portlet添加到门户页面，请执行以下操作：

  1. 请确保您位于应用程序服务器的管理窗口中，并导航到管理页面的位置。 (例如，在WebSphere 6.1中，单击“管 理页面”)。
  2. 选择portlet的名称，然后选择现有页面或创建新页面。
  3. 编辑页面布局。
  4. 选择portlet并将其添加到容器。
  5. 保存更改。

使用Portlet

要访问您添加到portlet的页面，请执行以下操作：

  1. 在portlet的个性化菜单中，将portlet配置为在门户中配置。
  2. 打开配置(Portlet显示在Portlet配置中配置的发布开始URL)，并根据需要进行编辑，然后保存它们。

在此页面上