文档AEM 6.4开发指南

扩展多站点管理器 extending-the-multi-site-manager

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 开发人员
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

本页可帮助您扩展多站点管理器的功能：

  • 了解MSM Java API的主要成员。
  • 创建可在转出配置中使用的新同步操作。
  • 修改默认语言和国家/地区代码。
NOTE
本页应结合以下内容阅读：
CAUTION
创作网站时会使用多站点管理器及其API，因此这些管理器仅用于在创作环境中使用。

Java API概述 overview-of-the-java-api

多站点管理包含以下包：

主MSM API对象进行如下交互(另请参阅 使用的术语):

chlimage_1-35

  • Blueprint
    A Blueprint (如 Blueprint配置)指定Live Copy可从中继承内容的页面。

    chlimage_1-36

    • Blueprint配置的使用( Blueprint)是可选的，但是：

      • 允许作者使用 转出 （明确）将修改推送到从此源继承的Live Copy中)。
      • 允许作者使用 创建网站;这允许用户轻松选择语言并配置Live Copy的结构。
      • 为任何生成的Live Copy定义默认转出配置。

  • LiveRelationship 的 LiveRelationship 指定live copy分支中的资源与其等效源/blueprint资源之间的连接（关系）。

    • 在实现继承和转出时会使用关系。
    • LiveRelationship 对象提供对转出配置的访问（引用）( RolloutConfig)、 LiveCopy和 LiveStatus 与关系相关的对象。
    • 例如，将在 /content/copy/us 从的源/blueprint中 /content/we-retail/language-masters. 资源 /content/we.retail/language-masters/en/jcr:content 和 /content/copy/us/en/jcr:content 形成关系。

  • LiveCopy 包含关系的配置详细信息( LiveRelationship)。

    • 使用 LiveCopy 类，用于访问页面路径、源/Blueprint页面的路径、转出配置以及子页面是否也包含在 LiveCopy.
    • A LiveCopy 每次创建节点时 创建网站 或 创建Live Copy 中，将使用。

  • LiveStatus 对象提供对 LiveRelationship. 使用查询Live Copy的同步状态。

  • LiveAction 是对转出中涉及的每个资源执行的操作。

    • LiveActions仅由RolloutConfigs生成。

  • LiveActionFactory 创建 LiveAction 给定的对象 LiveAction 配置。 配置作为资源存储在存储库中。

  • RolloutConfig 包含 LiveActions，用于触发时。 的 LiveCopy 会继承 RolloutConfig 结果出现在 LiveRelationship.

    • 首次设置Live Copy时还会使用RolloutConfig（这会触发LiveActions）。

创建新的同步操作 creating-a-new-synchronization-action

创建要与转出配置一起使用的自定义同步操作。 在 已安装的操作 不满足您的特定应用程序要求。 为此，请创建两个类：

的 LiveActionFactory 创建实例 LiveAction 给定配置的类：

  • LiveAction 类包括以下方法：

    • getName:返回操作的名称该名称用于引用操作，例如在转出配置中。
      • execute:执行操作的任务。

  • LiveActionFactory 类包括以下成员：

    • LIVE_ACTION_NAME:包含关联名称的字段 LiveAction. 此名称必须与 getName 方法 LiveAction 类。
    • createAction:创建实例 LiveAction. 可选 Resource 参数可用于提供配置信息。
    • createsAction:返回关联的 LiveAction.

访问LiveAction配置节点 accessing-the-liveaction-configuration-node

使用 LiveAction 配置节点，用于存储影响 LiveAction 实例。 存储库中存储 LiveAction 配置对 LiveActionFactory 对象。 因此，您可以将属性添加到的配置节点，并在 LiveActionFactory 实施。

例如， LiveAction 需要存储blueprint作者的名称。 配置节点的属性包括用于存储信息的Blueprint页面的属性名称。 在运行时， LiveAction 从配置中检索属性名称，然后获取属性值。

的参数 LiveActionFactory.createAction 方法是 Resource 对象。 此 Resource 对象表示 cq:LiveSyncAction 转出配置中此实时操作的节点；请参阅 创建转出配置. 与使用配置节点时一样，您应该将其调整为 ValueMap 对象：

public LiveAction createAction(Resource resource) throws WCMException {
        ValueMap config;
        if (resource == null || resource.adaptTo(ValueMap.class) == null) {
            config = new ValueMapDecorator(Collections.<String, Object>emptyMap());
        } else {
            config = resource.adaptTo(ValueMap.class);
        }
        return new MyLiveAction(config, this);
}

访问目标节点、源节点和LiveRelationship accessing-target-nodes-source-nodes-and-the-liverelationship

以下对象作为 execute 方法 LiveAction 对象：

  • A Resource 表示Live Copy源的对象。

  • A Resource 表示Live Copy目标的对象。

  • 的 LiveRelationship live copy的对象。

  • 的 autoSave 值指示 LiveAction 应保存对存储库所做的更改。

  • 重置值表示转出重置模式。

从这些对象中，您可以获取有关 LiveCopy. 您还可以使用 Resource 获取对象 ResourceResolver, Session和 Node 对象。 这些对象可用于处理存储库内容：

在以下代码的第一行中，源是 Resource 源页面的对象：

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);
NOTE
的 Resource 参数可能 null 或 Resources 不适应 Node 对象，如 NonExistingResource 对象。

创建新转出配置 creating-a-new-rollout-configuration

当安装的转出配置不符合您的应用程序要求时，创建转出配置：

然后，在Blueprint或Live Copy页面上设置转出配置时，您可以使用新的转出配置。

NOTE
另请参阅 自定义汇总的最佳实践.

创建转出配置 create-the-rollout-configuration

要创建新的转出配置，请执行以下操作：

  1. 开放CRXDE Lite;例如：
    http://localhost:4502/crx/de

  2. 导航至：
    /apps/msm/<your-project>/rolloutconfigs

    note note
    NOTE
    这是您项目的自定义版本：
    /libs/msm/wcm/rolloutconfigs
    如果这是您的第一个配置，则必须创建。
    note note
    NOTE
    您不得更改/libs路径中的任何内容。
    这是因为/libs的内容在您下次升级实例时被覆盖（而且当您应用修补程序或功能包时，很可能会被覆盖）。
    配置和其他更改的推荐方法是：
    • 在/apps下重新创建所需项（即/libs中存在的项）
    • 在/apps中进行任何更改

  3. 在此下 创建 具有以下属性的节点：

    • 名称:转出配置的节点名称。 md#installed-synchronization-actions)，例如 contentCopy 或 workflow.
    • 类型: cq:RolloutConfig

  4. 将以下属性添加到此节点：

    • 名称: jcr:title

      类型: String
      值:将在UI中显示的标识标题。

    • 名称: jcr:description

      类型: String
      值:可选描述。

    • 名称: cq:trigger

      类型: String
      值:的 转出触发器 。 从以下位置选择：

      • rollout
      • modification
      • publish
      • deactivate

  5. 单击 全部保存.

将同步操作添加到转出配置 add-synchronization-actions-to-the-rollout-configuration

转出配置存储在 转出配置节点 创建于 /apps/msm/<your-project>/rolloutconfigs 节点。

添加类型的子节点 cq:LiveSyncAction 向转出配置添加同步操作。 同步操作节点的顺序决定了操作的执行顺序。

  1. 仍在CRXDE Lite中，请选择 转出配置 节点。

    例如：
    /apps/msm/myproject/rolloutconfigs/myrolloutconfig

  2. 创建 具有以下节点属性的节点：

    • 名称:同步操作的节点名称。
      名称必须与 操作名称 在 同步操作，例如 contentCopy 或 workflow.
    • 类型: cq:LiveSyncAction

  3. 根据需要添加和配置任意数量的同步操作节点。 重新排列操作节点，使其顺序与您希望其发生的顺序匹配。 最顶层的操作节点首先出现。

  4. 单击 全部保存.

创建和使用简单的LiveActionFactory类 creating-and-using-a-simple-liveactionfactory-class

按照本节中的步骤开发 LiveActionFactory 并在转出配置中使用它。 这些过程使用Maven和Eclipse来开发和部署 LiveActionFactory:

  1. 创建Maven项目 然后导入Eclipse。
  2. 添加依赖项 到POM文件。
  3. 实施 LiveActionFactory 界面 并部署OSGi包。
  4. 创建转出配置.
  5. 创建Live Copy.

Maven项目和Java类的源代码可在公共Git存储库中使用。

GITHUB上的代码

您可以在GitHub上找到此页面的代码

创建Maven项目 create-the-maven-project

以下过程要求您将adobe-public配置文件添加到Maven设置文件。

  1. 打开终端或命令行会话并更改目录以指向创建项目的位置。

  2. 输入以下命令：

    code language-xml 
    mvn archetype:generate -DarchetypeGroupId=com.day.jcr.vault -DarchetypeArtifactId=multimodule-content-package-archetype -DarchetypeVersion=1.0.0 -DarchetypeRepository=adobe-public-releases

  3. 在交互提示时指定以下值：

    • groupId: com.adobe.example.msm
    • artifactId: MyLiveActionFactory
    • version: 1.0-SNAPSHOT
    • package: MyPackage
    • appsFolderName: myapp
    • artifactName: MyLiveActionFactory package
    • packageGroup: myPackages

  4. 启动Eclipse和 导入Maven项目.

将依赖项添加到POM文件 add-dependencies-to-the-pom-file

添加依赖项，以便Eclipse编译器可以引用 LiveActionFactory 代码。

  1. 从Eclipse项目资源管理器中，打开文件：

    MyLiveActionFactory/pom.xml

  2. 在编辑器中，单击 pom.xml 选项卡，然后找到 project/dependencyManagement/dependencies 中。

  3. 在 dependencyManagement 元素，然后保存文件。

    code language-xml 
     <dependency>
  <groupId>com.day.cq.wcm</groupId>
  <artifactId>cq-msm-api</artifactId>
  <version>5.6.2</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.api</artifactId>
  <version>2.4.3-R1488084</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>com.day.cq.wcm</groupId>
  <artifactId>cq-wcm-api</artifactId>
  <version>5.6.6</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.commons.json</artifactId>
  <version>2.0.6</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>com.day.cq</groupId>
  <artifactId>cq-commons</artifactId>
  <version>5.6.4</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.jcr.jcr-wrapper</artifactId>
  <version>2.0.0</version>
  <scope>provided</scope>
 </dependency>
 <dependency>
  <groupId>com.day.cq</groupId>
  <artifactId>cq-commons</artifactId>
  <version>5.6.4</version>
  <scope>provided</scope>
 </dependency>

  4. 从中打开包的POM文件 项目资源管理器 at MyLiveActionFactory-bundle/pom.xml.

  5. 在编辑器中，单击 pom.xml 选项卡，然后找到项目/依赖关系部分。 在依赖关系元素中添加以下XML，然后保存文件：

    code language-xml 
     <dependency>
  <groupId>com.day.cq.wcm</groupId>
  <artifactId>cq-msm-api</artifactId>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.api</artifactId>
 </dependency>
 <dependency>
  <groupId>com.day.cq.wcm</groupId>
  <artifactId>cq-wcm-api</artifactId>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.commons.json</artifactId>
 </dependency>
 <dependency>
  <groupId>com.day.cq</groupId>
  <artifactId>cq-commons</artifactId>
 </dependency>
 <dependency>
  <groupId>org.apache.sling</groupId>
  <artifactId>org.apache.sling.jcr.jcr-wrapper</artifactId>
 </dependency>
 <dependency>
  <groupId>com.day.cq</groupId>
  <artifactId>cq-commons</artifactId>
 </dependency>

实施LiveActionFactory implement-liveactionfactory

以下 LiveActionFactory 类实现 LiveAction 记录有关源页面和目标页面的消息，并复制 cq:lastModifiedBy 属性。 实时操作的名称是 exampleLiveAction.

  1. 在Eclipse项目资源管理器中，右键单击 MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm 包并单击 新建 > 类. 对于 名称，输入 ExampleLiveActionFactory 然后单击 完成.

  2. 打开 ExampleLiveActionFactory.java 文件，请使用以下代码替换内容，然后保存文件。

    code language-java 
    package com.adobe.example.msm;

import java.util.Collections;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.api.resource.ValueMap;
import org.apache.sling.api.wrappers.ValueMapDecorator;
import org.apache.sling.commons.json.io.JSONWriter;
import org.apache.sling.commons.json.JSONException;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import javax.jcr.Node;
import javax.jcr.RepositoryException;
import javax.jcr.Session;

import com.day.cq.wcm.msm.api.ActionConfig;
import com.day.cq.wcm.msm.api.LiveAction;
import com.day.cq.wcm.msm.api.LiveActionFactory;
import com.day.cq.wcm.msm.api.LiveRelationship;
import com.day.cq.wcm.api.WCMException;

@Component(metatype = false)
@Service
public class ExampleLiveActionFactory implements LiveActionFactory<LiveAction> {
 @Property(value="exampleLiveAction")
 static final String actionname = LiveActionFactory.LIVE_ACTION_NAME;

 public LiveAction createAction(Resource config) {
  ValueMap configs;
  /* Adapt the config resource to a ValueMap */
        if (config == null || config.adaptTo(ValueMap.class) == null) {
            configs = new ValueMapDecorator(Collections.<String, Object>emptyMap());
        } else {
            configs = config.adaptTo(ValueMap.class);
        }

  return new ExampleLiveAction(actionname, configs);
 }
 public String createsAction() {
  return actionname;
 }
 /************* LiveAction ****************/
 private static class ExampleLiveAction implements LiveAction {
  private String name;
  private ValueMap configs;
  private static final Logger log = LoggerFactory.getLogger(ExampleLiveAction.class);

  public ExampleLiveAction(String nm, ValueMap config){
   name = nm;
   configs = config;
  }

  public void execute(Resource source, Resource target,
    LiveRelationship liverel, boolean autoSave, boolean isResetRollout)
      throws WCMException {

   String lastMod = null;

   log.info(" *** Executing ExampleLiveAction *** ");

   /* Determine if the LiveAction is configured to copy the cq:lastModifiedBy property */
   if ((Boolean) configs.get("repLastModBy")){

    /* get the source's cq:lastModifiedBy property */
    if (source != null && source.adaptTo(Node.class) !=  null){
     ValueMap sourcevm = source.adaptTo(ValueMap.class);
     lastMod = sourcevm.get(com.day.cq.wcm.msm.api.MSMNameConstants.PN_PAGE_LAST_MOD_BY, String.class);
    }

    /* set the target node's la-lastModifiedBy property */
    Session session = null;
    if (target != null && target.adaptTo(Node.class) !=  null){
     ResourceResolver resolver = target.getResourceResolver();
     session = resolver.adaptTo(javax.jcr.Session.class);
     Node targetNode;
     try{
      targetNode=target.adaptTo(javax.jcr.Node.class);
      targetNode.setProperty("la-lastModifiedBy", lastMod);
      log.info(" *** Target node lastModifiedBy property updated: {} ***",lastMod);
     }catch(Exception e){
      log.error(e.getMessage());
     }
    }
    if(autoSave){
     try {
      session.save();
     } catch (Exception e) {
      try {
       session.refresh(true);
      } catch (RepositoryException e1) {
       e1.printStackTrace();
      }
      e.printStackTrace();
     }
    }
   }
  }
  public String getName() {
   return name;
  }

  /************* Deprecated *************/
  @Deprecated
  public void execute(ResourceResolver arg0, LiveRelationship arg1,
    ActionConfig arg2, boolean arg3) throws WCMException {
  }
  @Deprecated
  public void execute(ResourceResolver arg0, LiveRelationship arg1,
    ActionConfig arg2, boolean arg3, boolean arg4)
      throws WCMException {
  }
  @Deprecated
  public String getParameterName() {
   return null;
  }
  @Deprecated
  public String[] getPropertiesNames() {
   return null;
  }
  @Deprecated
  public int getRank() {
   return 0;
  }
  @Deprecated
  public String getTitle() {
   return null;
  }
  @Deprecated
  public void write(JSONWriter arg0) throws JSONException {
  }
 }
}

  3. 使用终端或命令会话，将目录更改为 MyLiveActionFactory 目录（Maven项目目录）。 然后，输入以下命令：

    code language-shell 
    mvn -PautoInstallPackage clean install

    AEM error.log 文件应指示包已启动。

    例如， http://localhost:4502/system/console/status-slinglogs.

    code language-xml 
    13.08.2013 14:34:55.450 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent RESOLVED
13.08.2013 14:34:55.451 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent STARTING
13.08.2013 14:34:55.451 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle BundleEvent STARTED
13.08.2013 14:34:55.453 *INFO* [OsgiInstallerImpl] com.adobe.example.msm.MyLiveActionFactory-bundle Service [com.adobe.example.msm.ExampleLiveActionFactory,2188] ServiceEvent REGISTERED
13.08.2013 14:34:55.454 *INFO* [OsgiInstallerImpl] org.apache.sling.audit.osgi.installer Started bundle com.adobe.example.msm.MyLiveActionFactory-bundle [316]

创建示例转出配置 create-the-example-rollout-configuration

创建使用 LiveActionFactory :

  1. 创建和配置 使用标准过程转出配置 — 并使用属性：

    • 标题:转出配置示例
    • 名称:examplolloutconfig
    • cq:trigger: publish

将实时操作添加到示例转出配置 add-the-live-action-to-the-example-rollout-configuration

配置您在上一步骤中创建的转出配置，以便它使用 ExampleLiveActionFactory 类。

  1. 开放CRXDE Lite;例如， http://localhost:4502/crx/de.

  2. 在下创建以下节点 /apps/msm/rolloutconfigs/examplerolloutconfig/jcr:content:

    • 名称: exampleLiveAction
    • 类型: cq:LiveSyncAction

  3. 单击 全部保存.

  4. 选择 exampleLiveAction 节点并添加以下属性：

    • 名称: repLastModBy
    • 类型: Boolean
    • 值: true

    此属性指示 ExampleLiveAction 类 cq:LastModifiedBy 属性应从源复制到目标节点。

  5. 单击 全部保存.

创建Live Copy create-the-live-copy

创建Live Copy We.Retail引用站点的英语/产品分支的“页面”中，使用您的转出配置：

  • 来源: /content/we-retail/language-masters/en/products

  • 转出配置:转出配置示例

激活 产品 （英语）页面，并观察 LiveAction 类生成：

16.08.2013 10:53:33.055 *INFO* [Thread-444535] com.adobe.example.msm.ExampleLiveActionFactory$ExampleLiveAction  *** ExampleLiveAction has been executed.***
16.08.2013 10:53:33.055 *INFO* [Thread-444535] com.adobe.example.msm.ExampleLiveActionFactory$ExampleLiveAction  *** Target node lastModifiedBy property updated: admin ***

更改语言名称和默认国家/地区 changing-language-names-and-default-countries

AEM使用一组默认的语言和国家/地区代码。

  • 默认语言代码为ISO-639-1定义的小写字母双字母代码。
  • 默认国家/地区代码为ISO 3166定义的小写或大写双字母代码。

MSM使用存储的语言和国家/地区代码列表来确定与页面语言版本名称关联的国家/地区名称。 您可以根据需要更改列表的以下方面：

  • 语言标题
  • 国家/地区名称
  • 语言的默认国家/地区(对于代码，例如 en, de，等等)

语言列表存储在 /libs/wcm/core/resources/languages 节点。 每个子节点表示语言或语言国家/地区：

  • 节点的名称是语言代码(例如 en 或 de)或language_country代码(例如 en_us 或 de_ch)。

  • 的 language 节点的属性存储代码语言的全名。

  • 的 country 节点的属性存储代码的国家/地区的全名。

  • 当节点名称仅包含语言代码(例如 en)，则国家/地区属性为 *，以及其他 defaultCountry 属性会存储语言国家/地区的代码，以指示要使用的国家/地区。

chlimage_1-38

要修改语言，请执行以下操作：

  1. 在Web浏览器中打开CRXDE Lite;例如， http://localhost:4502/crx/de

  2. 选择 /apps 文件夹，单击 创建，则 创建文件夹。

    命名新文件夹 wcm.

  3. 重复上一步骤以创建 /apps/wcm/core 文件夹树。 创建类型的节点 sling:Folder 在名为 resources.

  4. 右键单击 /libs/wcm/core/resources/languages 节点，单击 复制.

  5. 右键单击 /apps/wcm/core/resources 文件夹，单击 粘贴. 根据需要修改子节点。

  6. 单击 全部保存.

  7. 单击 工具, 操作 then Web控制台. 在此控制台中，单击 OSGi，则 配置.

  8. 找到并单击 Day CQ WCM语言管理器，并更改 语言列表 to /apps/wcm/core/resources/languages，然后单击 保存.

    chlimage_1-40

在页面属性（触屏优化UI）上配置MSM锁定 configuring-msm-locks-on-page-properties-touch-enabled-ui

创建自定义页面资产时，您可能需要考虑新资产是否有资格转出到任何Live Copy。

例如，如果添加了两个新页面属性：

  • 联系电子邮件:

    • 无需推出此属性，因为此属性在每个国家/地区（或品牌等）都将有所不同。

  • 关键可视样式：

    • 项目要求是，此资产将由所有国家/地区（或品牌等）共同使用，因此（通常）应推出此资产。

然后，您需要确保：

  • 联系电子邮件:

  • 关键可视样式：

    • 确保在触屏优化UI中，除非取消继承，否则不允许编辑此属性，您还可以恢复继承；可通过单击链/断链链接来控制此连接，该链/断链链接可切换以指示连接状态。

页面属性是否受到转出的控制，因此在编辑时是否受取消/恢复继承的控制，将由对话框属性控制：

  • cq-msm-lockable

    • 适用于触屏优化UI对话框中的项目

    • 将在对话框中创建链链接符号

    • 仅允许在取消继承（链式链接断开）时进行编辑

    • 仅适用于资源的第一个子级

    • 类型: String

    • 值:持有所考虑物业之名称（与物业价值相若） name;例如，请参阅

      /libs/foundation/components/page/cq:dialog/content/items/tabs/items/basic/items/column/items/title/items/title

When cq-msm-lockable 已定义，断开/关闭链将通过以下方式与MSM交互：

  • 如果的值为 cq-msm-lockable 为：

    • 相对 (例如， myProperty 或 ./myProperty)

      • 它将从中添加和删除资产 cq:propertyInheritanceCancelled.

    • 绝对 (例如， /image)

      • 断开链将通过添加 cq:LiveSyncCancelled 混合到 ./image 和设置 cq:isCancelledForChildren to true.
      • 关闭链将还原继承。
NOTE
cq-msm-lockable适用于要编辑的资源的第一个子级别，并且它在任何更深层的上级级别上不起作用，无论该值是定义为绝对值还是相对值。
NOTE
重新启用继承时，Live Copy页面属性不会自动与源属性同步。 如果需要，您可以手动请求同步。
recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e