Extensão do Gerenciador de vários sites

Esta página ajuda a estender as funcionalidades do Multi Site Manager:

• Saiba mais sobre os principais membros da API Java MSM.
• Crie uma nova ação de sincronização que pode ser usada em uma configuração de implantação.
• Modifique o idioma padrão e os códigos de país.

Visão geral da API Java

O Gerenciamento de vários sites consiste nos seguintes pacotes:

• com.day.cq.wcm.msm.api
• com.day.cq.wcm.msm.commons

Os principais objetos de API MSM interagem da seguinte maneira (consulte também Termos usados):

• Blueprint

  Uma Blueprint (como na configuração doblueprint) especifica as páginas a partir das quais uma live copy pode herdar conteúdo.

  

  • O uso de uma configuração de blueprint ( Blueprint) é opcional, mas:

    • Permite que o autor use a opção Rollout na origem (para (explicitamente) modificações de envio para cópias online herdadas dessa origem).
    • Permite que o autor use Criar site; isso permite que o usuário selecione facilmente os idiomas e configure a estrutura da live copy.
    • Define a configuração padrão de implementação para qualquer cópia online resultante.

• LiveRelationship O LiveRelationship especifica a conexão (relação) entre um recurso no ramo de live copy e seu recurso equivalente de origem/blueprint.

  • Os relacionamentos são usados ao realizar herança e implantação.

  • LiveRelationship os objetos fornecem acesso (referências) às configurações de implantação ( RolloutConfig) LiveCopye aos LiveStatus objetos relacionados ao relacionamento.

  • Por exemplo, uma cópia ao vivo é criada em /content/copy/us a partir da fonte/blueprint em /content/we-retail/language-masters. Os recursos /content/we.retail/language-masters/en/jcr:content e /content/copy/us/en/jcr:content formam uma relação.

• LiveCopy LiveCopy contém os detalhes de configuração para os relacionamentos ( LiveRelationship) entre os recursos de live copy e seus recursos de origem/blueprint.

  • Use a LiveCopy classe para acessar o caminho da página, o caminho da página de origem/blueprint, as configurações de implementação e se as páginas secundárias também estão incluídas no LiveCopy.

  • Um LiveCopy nó é criado sempre que Criar site ou Criar Live Copy é usado.

• LiveStatus

  LiveStatus objetos fornecem acesso ao status de tempo de execução de um LiveRelationship. Use para query do status de sincronização de uma live copy.

• LiveAction

  Uma ação LiveAction é executada em cada recurso que está envolvido na implementação.

  • O LiveActions é gerado somente por RolloutConfigs.

• LiveActionFactory

  Cria LiveAction objetos com uma LiveAction configuração. As configurações são armazenadas como recursos no repositório.

• RolloutConfig O RolloutConfig contém uma lista de LiveActions, a ser usada quando acionada. O LiveCopy herda o RolloutConfig e o resultado está presente no LiveRelationship.

  • A configuração de uma live copy pela primeira vez também usa um RolloutConfig (que aciona o LiveActions).

Criando uma Nova Ação de Sincronização

Crie ações de sincronização personalizadas para usar com suas configurações de implementação. Crie uma ação de sincronização quando as ações instaladas não atenderem aos requisitos específicos do aplicativo. Para fazer isso, crie duas classes:

• Uma implementação da interface com.day.cq.wcm.msm.api.LiveAction que executa a ação.
• Um componente OSGI que implementa a interface com.day.cq.wcm.msm.api.LiveActionFactory e cria instâncias da sua LiveAction classe.

O LiveActionFactory cria instâncias da LiveAction classe para uma determinada configuração:

• LiveAction as classes incluem os seguintes métodos:

  • getName: Retorna o nome da ação O nome é usado para fazer referência à ação, por exemplo, em configurações de implantação.
  • execute: Executa as tarefas da ação.

• LiveActionFactory as classes incluem os seguintes membros:

  • LIVE_ACTION_NAME: Um campo que contém o nome do associado LiveAction. Esse nome deve coincidir com o valor retornado pelo getName método da LiveAction classe.

  • createAction: Cria uma instância do LiveAction. O Resource parâmetro opcional pode ser usado para fornecer informações de configuração.

  • createsAction: Retorna o nome do associado LiveAction.

Acessar o nó de configuração do LiveAction

Use o nó LiveAction de configuração no repositório para armazenar informações que afetam o comportamento do tempo de execução da LiveAction instância. O nó no repositório que armazena a LiveAction configuração está disponível para o LiveActionFactory objeto em tempo de execução. Portanto, você pode adicionar propriedades ao nó de configuração e usá-las na sua LiveActionFactory implementação, conforme necessário.

Por exemplo, um usuário LiveAction precisa armazenar o nome do autor do blueprint. Uma propriedade do nó de configuração inclui o nome da propriedade da página de blueprint que armazena as informações. No tempo de execução, o LiveAction recupera o nome da propriedade da configuração e obtém o valor da propriedade.

O parâmetro do [LiveActionFactory](https://helpx.adobe.com/br/experience-manager/6-5/sites/developing/using/reference-materials/javadoc/com/day/cq/wcm/msm/api/LiveActionFactory.html).createAction método é um Resource objeto. Esse Resource objeto representa o cq:LiveSyncAction nó para essa ação em tempo real na configuração de implantação; consulte Criação de uma configuraçãode implantação. Como de costume ao usar um nó de configuração, você deve adaptá-lo a um ValueMap objeto:

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);
}

Acessar nós de Público alvo, nós de origem e o LiveRelationship

Os seguintes objetos são fornecidos como parâmetros do execute método do LiveAction objeto:

• Um Resource objeto que representa a origem do Live Copy.

• Um Resource objeto que representa o público alvo do Live Copy.

• O objeto LiveRelationship da live copy.

• O autoSave valor indica se as alterações LiveAction devem ser salvas no repositório.

• O valor reset indica o modo de redefinição de implantação.

Desses objetos, você pode obter todas as informações sobre os LiveCopy. Também é possível usar os Resource objetos para obter ResourceResolver, Sessione Node objetos. Esses objetos são úteis para manipular o conteúdo do repositório:

Na primeira linha do código a seguir, source é o Resource objeto da página de origem:

ResourceResolver resolver = source.getResourceResolver();
Session session = resolver.adaptTo(javax.jcr.Session.class);
Node sourcenode = source.adaptTo(javax.jcr.Node.class);

Creating a New Rollout Configuration

Crie uma configuração de implementação quando as configurações de implementação instaladas não atenderem aos requisitos do aplicativo:

• Criar a configuração de implementação.
• Adicionar ações de sincronização à configuração de implementação.

A nova configuração de implementação estará disponível para você quando definir configurações de implementação em um blueprint ou página de Live Copy.

Create the Rollout Configuration

Para criar uma nova configuração de implantação:

1. Abrir o CRXDE Lite; por exemplo:
   http://localhost:4502/crx/de

2. Vá até :
   /apps/msm/<your-project>/rolloutconfigs

   Observação

   Esta é a versão personalizada do projeto de:
   /libs/msm/wcm/rolloutconfigs
   Deve ser criado se esta for a sua primeira configuração.

   Observação

   Você não deve alterar nada no caminho /libs.
   Isso ocorre porque o conteúdo de /libs é substituído na próxima vez que você atualizar sua instância (e pode muito bem ser substituído quando você aplicar uma correção ou um pacote de recursos).
   O método recomendado para configuração e outras alterações é:

   • Recrie o item necessário (isto é, como ele existe em /libs) em /apps
   • Faça quaisquer alterações em /apps

3. Em Criar um nó com as seguintes propriedades:

   • Nome: O nome do nó da configuração de implantação. md#installed-synchronization-actions), por exemplo contentCopy ou workflow.
   • Tipo: cq:RolloutConfig

4. Adicione as seguintes propriedades a este nó:

   • Nome: jcr:title

     Tipo: String
     Valor: Um título de identificação que será exibido na interface do usuário.

   • Nome: jcr:description

     Tipo: String
     Valor: Uma descrição opcional.

   • Nome: cq:trigger

     Tipo: String
     Valor: O Acionador de implantação a ser usado. Selecionar de:

     • rollout
     • modification
     • publish
     • deactivate

5. Clique em Salvar tudo.

Add Synchronization Actions to the Rollout Configuration

As configurações de implantação são armazenadas abaixo do nó de configuração de implantação criado no /apps/msm/<your-project>/rolloutconfigs nó.

Adicione nós secundários do tipo cq:LiveSyncAction para adicionar ações de sincronização à configuração de implementação. A ordem dos nós de ação de sincronização determina a ordem em que as ações ocorrem.

1. Ainda no CRXDE Lite, selecione o nó Configuração de implantação.

   Por exemplo:
   /apps/msm/myproject/rolloutconfigs/myrolloutconfig

2. Crie um nó com as seguintes propriedades de nó:

   • Nome: O nome do nó da ação de sincronização.
     O nome deve ser igual ao Nome da ação na tabela em Ações desincronização, por exemplo contentCopy ou workflow.
   • Tipo: cq:LiveSyncAction

3. Adicione e configure quantos nós de ação de sincronização forem necessários. Reorganize os nós de ação para que sua ordem corresponda à ordem em que você deseja que ocorram. O nó de ação mais alto ocorre primeiro.

Criar e usar uma classe simples do LiveActionFactory

Siga os procedimentos desta seção para desenvolver um LiveActionFactory e usá-lo em uma configuração de implementação. Os procedimentos usam Maven e Eclipse para desenvolver e implantar o LiveActionFactory:

1. Crie o projeto maven e importe-o para o Eclipse.
2. Adicione dependências ao arquivo POM.
3. Implemente a LiveActionFactory interface e implante o pacote OSGi.
4. Criar a configuração de implementação.
5. Crie a live copy.

O projeto Maven e o código-fonte da classe Java estão disponíveis no repositório Git público.

CÓDIGO NO GITHUB

Você pode encontrar o código desta página no GitHub

• Abra o projeto experienceemanager-java-msmrollout no GitHub
• Baixar o projeto como um arquivo ZIP

Criar o projeto Maven

O procedimento a seguir requer que você tenha adicionado o perfil adobe-public ao arquivo de configurações Maven.

• Para obter informações sobre o perfil adobe-public, consulte Obtenção do plug-in Content Package Maven
• Para obter informações sobre o arquivo de configurações Maven, consulte a Referência deconfigurações Maven.

1. Abra um terminal ou uma sessão de linha de comando e altere o diretório para apontar para o local onde o projeto deve ser criado.

2. Digite o seguinte comando:

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

3. Especifique os seguintes valores no prompt interativo:

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

4. Start Eclipse e importe o projetoMaven.

Adicionar dependências ao arquivo POM

Adicione dependências para que o compilador do Eclipse possa fazer referência às classes usadas no LiveActionFactory código.

1. No Explorador de projetos do Eclipse, abra o arquivo:

   MyLiveActionFactory/pom.xml

2. No editor, clique na pom.xml guia e localize a project/dependencyManagement/dependencies seção.

3. Adicione o XML a seguir dentro do dependencyManagement elemento e salve o arquivo.

    <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. Abra o arquivo POM para o pacote do Project Explorer em MyLiveActionFactory-bundle/pom.xml.

5. No editor, clique na pom.xml guia e localize a seção projeto/dependências. Adicione o XML a seguir dentro do elemento dependências e salve o arquivo:

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

Implementação do LiveActionFactory

A LiveActionFactory classe a seguir implementa um relatório LiveAction cq:lastModifiedBy que registra mensagens sobre as páginas de origem e público alvo e copia a propriedade do nó de origem para o nó público alvo. O nome da ação ao vivo é exampleLiveAction.

1. No Eclipse Project Explorer, clique com o botão direito do mouse no MyLiveActionFactory-bundle/src/main/java/com.adobe.example.msm pacote e clique em Novo > Classe. Para o Nome, digite ExampleLiveActionFactory e clique em Concluir.

2. Abra o ExampleLiveActionFactory.java arquivo, substitua o conteúdo pelo seguinte código e salve o arquivo.

   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. Usando o terminal ou a sessão de comando, altere o diretório para o MyLiveActionFactory diretório (o diretório do projeto Maven). Em seguida, insira o seguinte comando:

   mvn -PautoInstallPackage clean install
   

   O arquivo AEM error.log deve indicar que o pacote foi iniciado.

   Por exemplo, https://localhost:4502/system/console/status-slinglogs.

   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

Crie a configuração de implantação MSM que usa a LiveActionFactory que você criou:

1. Crie e configure uma Configuração de implantação com o procedimento padrão - e usando as propriedades:

   • Título: Exemplo de configuração de implantação
   • Nome: examplerolloutconfig
   • cq:trigger: publish

Adicionar a ação ao vivo à configuração de implantação de exemplo

Configure a configuração de implantação criada no procedimento anterior para que ela use a ExampleLiveActionFactory classe.

1. Abrir o CRXDE Lite; por exemplo, https://localhost:4502/crx/de.

2. Crie o seguinte nó em /apps/msm/rolloutconfigs/examplerolloutconfig/jcr:content:

   • Nome: exampleLiveAction
   • Tipo: cq:LiveSyncAction

3. Clique em Salvar tudo.

4. Selecione o exampleLiveAction nó e adicione a seguinte propriedade:

   • Nome: repLastModBy
   • Tipo: Boolean
   • Valor: true

   Essa propriedade indica à ExampleLiveAction classe que a cq:LastModifiedBy propriedade deve ser replicada da origem para o nó do público alvo.

5. Clique em Salvar tudo.

Criar a Live Copy

Crie uma cópia ao vivo da ramificação Inglês/Produtos do Site de Referência We.Retail usando a configuração de lançamento:

• Fonte: /content/we-retail/language-masters/en/products

• Configuração de implantação: Exemplo de configuração de implantação

Ative a página Produtos (inglês) da ramificação de origem e observe as mensagens de registro geradas pela LiveAction classe:

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

Alteração de nomes de idiomas e países padrão

O AEM usa um conjunto padrão de códigos de idioma e país.

• O código de idioma padrão é o código de duas letras minúsculas, conforme definido pela ISO-639-1.
• O código padrão do país é o código de duas letras em minúsculas ou maiúsculas, conforme definido pela ISO 3166.

O MSM usa uma lista armazenada de códigos de idioma e país para determinar o nome do país associado ao nome da versão de idioma da sua página. Você pode alterar os seguintes aspectos da lista, se necessário:

• Títulos de idioma
• Nomes de países
• Países padrão para idiomas (para códigos como en, de, entre outros)

A lista de idioma é armazenada abaixo do /libs/wcm/core/resources/languages nó. Cada nó filho representa um idioma ou um país de idioma:

• O nome do nó é o código do idioma (como en ou de) ou o código language_country (como en_us ou de_ch).

• A language propriedade do nó armazena o nome completo do idioma para o código.

• A country propriedade do nó armazena o nome completo do país para o código.

• Quando o nome do nó consiste apenas em um código de idioma (como en), a propriedade country é *e uma defaultCountry propriedade adicional armazena o código do idioma-país para indicar o país a ser usado.

Para modificar os idiomas:

1. Abra o CRXDE Lite no navegador da Web; por exemplo, https://localhost:4502/crx/de

2. Selecione a /apps pasta e clique em Criar, em seguida, em Criar pasta.

   Nomeie a nova pasta wcm.

3. Repita a etapa anterior para criar a árvore de /apps/wcm/core pastas. Crie um nó do tipo sling:Folder em core chamado resources.

4. Clique com o botão direito do mouse no /libs/wcm/core/resources/languages nó e clique em Copiar.

5. Clique com o botão direito do mouse na /apps/wcm/core/resources pasta e clique em Colar. Modifique os nós secundários conforme necessário.

6. Clique em Salvar tudo.

7. Clique em Ferramentas, Operações e Console da Web. Nesse console, clique em OSGi e em Configuração.

8. Localize e clique em Day CQ WCM Language Manager, altere o valor da Lista de idioma para /apps/wcm/core/resources/languagese clique em Salvar.

   

Configuração de bloqueios MSM em propriedades da página (interface habilitada para toque)

Ao criar uma propriedade de página personalizada, talvez seja necessário considerar se a nova propriedade deve ser qualificada para implantação em qualquer cópia ao vivo.

Por exemplo, se duas novas propriedades de página estiverem sendo adicionadas:

• Email de contato:

  • Esta propriedade não precisa ser distribuída, pois será diferente em cada país (ou marca, etc.).

• Estilo visual principal:

  • O requisito do projeto é que essa propriedade seja distribuída como é (normalmente) comum a todos os países (ou marcas, etc.).

Em seguida, é necessário garantir que:

• Email de contato:

  • Está excluído das propriedades distribuídas; consulte Excluindo propriedades e tipos de nó da sincronização.

• Estilo visual principal:

  • Certifique-se de que você não tem permissão para editar essa propriedade na interface habilitada para toque, a menos que a herança seja cancelada, e também de que você possa reinstalar a herança; isso é controlado ao clicar nos links de cadeia/cadeia quebrada que alternam para indicar o status da conexão.

Se uma propriedade de página está sujeita a implantação e, portanto, sujeita a cancelamento/reinstalação da herança durante a edição, é controlada pela propriedade de diálogo:

• cq-msm-lockable

  • é aplicável a itens em uma caixa de diálogo de interface habilitada para toque

  • criará o símbolo de elo de cadeia na caixa de diálogo

  • permite a edição somente se a herança for cancelada (o link da cadeia está quebrado)

  • aplica-se somente ao primeiro nível filho do recurso

  • Tipo: String

  • Valor: seja titular do nome da propriedade em questão (e seja comparável ao valor da propriedade name; por exemplo, consulte

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

Quando cq-msm-lockable tiver sido definida, a quebra/fechamento da cadeia interagirá com a MSM da seguinte forma:

• if the value of cq-msm-lockable is:

  • Relativo (por exemplo, myProperty ou ./myProperty)

    • ela adicionará e removerá a propriedade de cq:propertyInheritanceCancelled.

  • Absoluto (por exemplo, /image)

    • a quebra da cadeia cancelará a herança adicionando a combinação cq:LiveSyncCancelled ao ./image e definindo cq:isCancelledForChildren como true.

    • fechar a cadeia reverterá a herança.