Configurar a sincronização da Live Copy configuring-live-copy-synchronization

Execute as seguintes tarefas para controlar como e quando as live copies são sincronizadas com seu conteúdo de origem.

  • Decida se as configurações de implantação existentes atendem aos seus requisitos ou se é necessário criar um ou mais.
  • Especifique as configurações de implantação a serem usadas para suas live copies.

Configurações de implantação instaladas e personalizadas installed-and-custom-rollout-configurations

Esta seção fornece informações sobre as configurações de implantação instaladas e as ações de sincronização que elas usam, e como criar configurações personalizadas, se necessário.

CAUTION
A atualização ou alteração de uma configuração de implantação pronta para uso (instalada) não é recomendada. Se houver um requisito para uma ação ativa personalizada, ela deverá ser adicionada em uma configuração de implantação personalizada.

Acionadores de implantação rollout-triggers

Cada configuração de implantação usa um acionador de implantação que ocasiona a implantação. As configurações de implantação podem usar um dos seguintes acionadores:

  • Na implantação: o comando Implantação é usado na página de blueprint ou o comando Sincronizar é usado na página de live copy.

  • Em modificação: a página de origem é modificada.

  • Em ativação: a página de origem é ativada.

  • Em desativação: a página de origem é desativada.

NOTE
O uso do acionador Ao modificar pode afetar o desempenho. Consulte Práticas recomendadas do MSM para obter mais informações.

Configurações de implantação instaladas installed-rollout-configurations

A tabela a seguir lista as configurações de implantação instaladas com AEM. A tabela inclui as ações de acionador e de sincronização de cada configuração de implantação. Se as ações de configuração de implantação instaladas não atenderem aos seus requisitos, você poderá criar uma configuração de implantação.

Nome
Descrição
Acionar
Ações de Sincronização

consulte também Ações de Sincronização Instaladas
Configuração de implantação padrão
A configuração de implantação padrão que permite iniciar o processo de implantação com estímulos de implantação e executa as ações: criar, atualizar, excluir conteúdo e ordenar os nós filhos.
Na implantação
contentUpdate
contentCopy
contentDelete
referencesUpdate
productUpdate
orderChildren
Acionar com a ativação do blueprint
Publica a live copy quando a origem é publicada.
No modo de ativação
targetActivate
Desligar com a desativação do blueprint
Desativa a live copy quando a origem é desativada.
Ao desativar
targetDeactivate
Forçar modificação

Envia o conteúdo para a live copy quando a origem é modificada.

Use essa configuração de implantação com moderação, pois ela usa o acionador Ao modificar.

Em modificação
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
Forçar modificação (superficial)

Envia o conteúdo para a live copy quando a página do blueprint é modificada, sem atualizar referências (por exemplo, para cópias superficiais).

Use essa configuração de implantação com moderação, pois ela usa o acionador Ao modificar.

Em modificação
contentUpdate
contentCopy
contentDelete
orderChildren
Promover lançamento
Configuração de implantação padrão para a promoção de páginas de lançamento.
Na implantação
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship
Configuração de implantação do conteúdo da página de catálogo
Aplica modelos de página para um blueprint do catálogo.
Na implantação
contentUpdate
contentCopy
contentDelete
referencesUpdate
productCreateUpdate
orderChildren
Configuração de implantação da atualização da página de catálogo
Aplica propriedades de direcionamento de um blueprint do catálogo. Deve ser executado após a Configuração de implantação do conteúdo da página de catálogo.
Na implantação
catalogRolloutHooks
Configuração de implantação da DPS Publications
Configuração de implantação da publicação do DPS, que permite iniciar o processo de implantação no acionador de implantação e excluir as propriedades de ligação do FolioProducer na implantação inicial
Na implantação
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
dpsMetadataFilter
Configuração de implantação do catálogo herdado (5.6.0)
Obsoleto. Use o Catalog Generator em vez do MSM para implantações de catálogos.
Na implantação
editProperties

Ações de Sincronização Instaladas installed-synchronization-actions

A tabela a seguir lista as ações de sincronização instaladas com o AEM. Se as ações instaladas não atenderem aos seus requisitos, você poderá Criar uma Nova Ação de Sincronização.

Nome da ação
Descrição
Propriedades
contentCopy
Quando os nós da origem não existem na live copy, o copia os nós para a live copy. Configure o serviço de Ação de cópia de conteúdo MSM CQ para especificar os tipos de nó, itens de parágrafo e propriedades de página a serem excluídos.
contentDelete
Exclui nós da live copy que não existem na origem. Configure o serviço de Ação de Exclusão de Conteúdo MSM CQ para especificar os tipos de nó, itens de parágrafo e propriedades de página a serem excluídos.
contentUpdate
Atualiza o conteúdo da live copy com as alterações da origem. Configure o serviço de Ação de Atualização de Conteúdo MSM CQ para especificar os tipos de nó, itens de parágrafo e propriedades de página a serem excluídos.
editProperties

Edita propriedades da live copy. A propriedade editMap determina quais propriedades são editadas e seus valores. O valor da propriedade editMap deve usar o seguinte formato:

[property_name_1]#[current_value]#[novo_valor],
[property_name_2]#[current_value]#[novo_valor],
... ,
[property_name_n]#[current_value]#[novo_valor]

Os itens current_value e new_value são expressões regulares.

Por exemplo, considere o seguinte valor para editMap:

sling:resourceType#/(contentpage|homepage)#/
mobilecontentpage,
cq:template#/contentpage#/mobilecontentpage

Esse valor edita as propriedades dos nós de live copy da seguinte maneira:

  • As propriedades sling:resourceType definidas como contentpage ou homepage estão definidas como mobilecontentpage.
  • As propriedades cq:template definidas como contentpage estão definidas como mobilecontentpage.
editMap: (String) identifica a propriedade, o valor atual e o novo valor. Consulte a Descrição para obter informações.
notificar
Envia um evento de página informando que a página foi implantada. Para ser notificado, é necessário primeiro assinar os eventos de implantação.
orderChildren
Na live copy, ela ordena os filhos (nós), com base na ordem no blueprint
referencesUpdate

Na live copy, essa ação de sincronização atualiza referências como links.
Ele procura caminhos nas páginas da live copy que apontam para um recurso dentro do blueprint. Quando encontrado, ele atualiza o caminho para apontar para o recurso relacionado dentro da live copy (em vez do blueprint). As referências que têm destinos fora do blueprint não são alteradas.

Configure o serviço de Ação de Atualização de Referências MSM CQ para especificar os tipos de nó, itens de parágrafo e propriedades de página a serem excluídos.

targetVersion

Cria uma versão da live copy.

Essa ação deve ser a única ação de sincronização incluída em uma configuração de implementação.

targetActivate

Ativa a live copy.

Essa ação deve ser a única ação de sincronização incluída em uma configuração de implementação.

targetDeactivate

Desativa a live copy.

Essa ação deve ser a única ação de sincronização incluída em uma configuração de implementação.

fluxo de trabalho

Inicia o fluxo de trabalho definido pela propriedade de direcionamento (somente para páginas) e toma a live copy como carga.

O caminho de destino é o caminho do nó do modelo.

target: (String) O caminho para o modelo de fluxo de trabalho.
obrigatório

Define a permissão de várias ACLs na página da live copy como somente leitura para um grupo de usuários específico. As seguintes ACLs são configuradas:

  • ActionSet.ACTION_NAME_REMOVE
  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Use esta ação somente para páginas.

target: (String) A ID do grupo para o qual você está definindo permissões.
mandatoryContent

Define a permissão de várias ACLs na página da live copy como somente leitura para um grupo de usuários específico. As seguintes ACLs são configuradas:

  • ActionSet.ACTION_NAME_SET_PROPERTY
  • ActionSet.ACTION_NAME_ACL_MODIFY

Use esta ação somente para páginas.

target: (String) A ID do grupo para o qual você está definindo permissões.
mandatoryStructure
Define a permissão da ACL ActionSet.ACTION_NAME_REMOVE na página da live copy como somente leitura para um grupo de usuários específico. Use esta ação somente para páginas.
target: (String) A ID do grupo para o qual você está definindo permissões.
VersionCopyAction
Se a página de blueprint/origem tiver sido publicada pelo menos uma vez, o cria uma página de live copy usando a versão publicada. Observação: essa ação só está disponível para criar uma página de live copy com base em uma página de origem publicada, não para atualizar uma página de live copy existente.
AçãoDeMovimentaçãoDePágina

A PageMoveAction se aplica quando uma página foi movida no blueprint.

A ação copia, em vez de mover, a página da Live Copy (relacionada) do local anterior à movimentação para o local posterior.

PageMoveAction não altera a página da Live Copy no local antes de mover. Portanto, para configurações de implantação consecutivas, ela tem o status de um LiveRelationship sem blueprint.

Configure o serviço de Ação de movimentação de página MSM CQ para especificar os tipos de nó, itens de parágrafo e propriedades de página a serem excluídos.

Essa ação deve ser a única ação de sincronização incluída em uma configuração de implementação.

prop_referenceUpdate: (booleano) defina como verdadeiro para atualizar referências. O padrão é verdadeiro.
productCreateUpdate

Cria ou atualiza recursos de Produto em um catálogo. Esta ação deve ser usada em uma das seguintes situações:

  • Geração ou implantação de um catálogo (ou seção de catálogo)
  • Um usuário restaura a herança da sincronização de um componente de produto.
markLiveRelationship
Indica que existe um relacionamento dinâmico para conteúdo criado na inicialização.
catalogRolloutHooks
Executa ganchos de implantação específicos de geração de catálogo. Chama os métodos executePageRolloutHooks e executeProductRolloutHooks do CatalogGenerator.
Consulte com.adobe.cq.commerce.pim.api.CatalogGenerator nos Javadocs AEM.
productUpdate
Atualiza páginas de produto em uma live copy de um catálogo de produtos

Criação de uma configuração de implantação creating-a-rollout-configuration

Você pode criar uma configuração de implantação quando as configurações instaladas não atenderem aos requisitos do aplicativo:

A nova configuração de implantação está então disponível ao definir configurações de implantação em uma página de blueprint ou Live Copy.

Excluir propriedades e tipos de nó da sincronização excluding-properties-and-node-types-from-synchronization

Você pode configurar vários serviços OSGi que suportam ações de sincronização correspondentes para que eles não afetem tipos de nó e propriedades específicos. Por exemplo, muitas propriedades e nós secundários relacionados ao funcionamento interno do AEM não devem ser incluídos em uma live copy. Somente o conteúdo relevante para o usuário da página deve ser copiado.

Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter mais detalhes e as práticas recomendadas.

A tabela a seguir lista as ações de sincronização para as quais você pode especificar os nós a serem excluídos. A tabela fornece os nomes dos serviços a serem configurados usando o console da Web e o PID para configurar usando um nó de repositório.

Ação de sincronização
Nome do serviço no Console da web
PID do serviço
contentCopy
Ação de cópia de conteúdo MSM CQ
com.day.cq.wcm.msm.impl.actions.ContentCopyActionFactory
contentDelete
Ação de exclusão de conteúdo MSM CQ
com.day.cq.wcm.msm.impl.actions.ContentDeleteActionFactory
contentUpdate
Ação de atualização de conteúdo do MSM CQ
com.day.cq.wcm.msm.impl.actions.ContentUpdateActionFactory
AçãoDeMovimentaçãoDePágina
Ação de movimentação de página MSM CQ
com.day.cq.wcm.msm.impl.actions.PageMoveActionFactory
referencesUpdate
Ação de atualização de referências MSM CQ
com.day.cq.wcm.msm.impl.actions.ReferencesUpdateActionFactory

A tabela a seguir descreve as propriedades que você pode configurar:

Propriedade do console da Web / propriedade OSGi
Descrição

Nodetypes Excluídos

cq.wcm.msm.action.excludednodetypes

Uma expressão regular que corresponde aos tipos de nó que serão excluídos da ação de sincronização.

Itens de parágrafo excluídos

cq.wcm.msm.action.excludedparagraphitems

Uma expressão regular que corresponde aos itens de parágrafo que serão excluídos da ação de sincronização.

Propriedades da página excluída

cq.wcm.msm.action.excludedprops

Uma expressão regular que corresponde às propriedades de página que serão excluídas da ação de sincronização.

Tipos de nó Mixin ignorados

cq.wcm.msm.action.ignoredMixin

Disponível somente para Ação de atualização de conteúdo MSM CQ. Uma expressão regular que corresponde aos nomes dos tipos de nó mixin que serão excluídos da ação de sincronização.
NOTE
Na interface clássica, o ícone de bloqueio exibido na caixa de diálogo Propriedades da página para páginas do Live Copy não reflete a configuração da propriedade Propriedades da página excluídas. O ícone de bloqueio aparece mesmo para propriedades que são excluídas da ação de sincronização.

Ação de atualização de conteúdo do MSM CQ - Exclusões cq-msm-content-update-action-exclusions

Várias propriedades e tipos de nó são excluídos por padrão. Eles são definidos na configuração OSGi da Ação de atualização de conteúdo do MSM CQ, em Propriedades da página excluída.

Por padrão, as propriedades que correspondem às seguintes expressões regulares são excluídas (ou seja, não são atualizadas) na implantação:

Ação de atualização de conteúdo MSM CQ

É possível alterar as expressões definindo a lista de exclusões conforme necessário.

Por exemplo, se você quiser que o Título da página seja incluído nas alterações consideradas para implementação, remova jcr:title das exclusões. Por exemplo, com o regex:

jcr:(?!(title)$).*

Configurar sincronização para atualizar referências configuring-synchronization-for-updating-references

Você pode configurar vários serviços OSGi que oferecem suporte às ações de sincronização correspondentes relacionadas à atualização de referências.

Ao trabalhar com AEM, há vários métodos de gerenciamento das definições de configuração desses serviços; consulte Configurar OSGi para obter mais detalhes e as práticas recomendadas.

A tabela a seguir lista as ações de sincronização para as quais você pode especificar a atualização de referência. A tabela fornece os nomes dos serviços a serem configurados usando o console da Web e o PID para configurar usando um nó de repositório.

Propriedade do console da Web / propriedade OSGi
Descrição

Atualizar referência entre LiveCopies aninhadas

cq.wcm.msm.impl.action.referencesupdate.prop_updateNested

Disponível somente para a Ação de atualização de referências MSM CQ. Selecione esta opção (Console da Web) ou defina esta propriedade boolean como true (configuração do repositório) para substituir referências que se destinam a qualquer recurso que esteja dentro da ramificação da Live Copy mais elevada.

Atualizar páginas de referência

cq.wcm.msm.impl.actions.pagemove.prop_referenceUpdate

Disponível somente para a Ação de movimentação de página MSM CQ. Selecione esta opção (Console da Web) ou defina esta propriedade boolean como true (configuração do repositório) para atualizar todas as referências para usar a página original para fazer referência à página Live Copy.

Especificar as configurações de implementação a serem usadas specifying-the-rollout-configurations-to-use

O MSM permite especificar conjuntos de configurações de implantação usados com frequência e, quando necessário, você pode substituí-los por live copies específicas. O MSM fornece vários locais para especificar as configurações de implementação a serem usadas. O local determina se a configuração se aplica a uma live copy específica.

A seguinte lista de locais onde você pode especificar as configurações de implantação a serem usadas descreve como o MSM determina quais configurações de implantação usar para uma live copy:

  • Propriedades da página de Live Copy: Quando uma página de Live Copy é configurada para usar uma ou mais configurações de implantação, o MSM usa essas configurações.
  • Propriedades da página de blueprint: Quando uma live copy é baseada em um blueprint, e a página de live copy não está definida com uma configuração de implantação, a configuração associada à página de origem do blueprint é usada.
  • Propriedades da página principal da Live Copy: Quando nenhuma página de Live Copy ou página de origem do blueprint é definida com uma configuração de implantação, a configuração que se aplica à página principal da página de Live Copy é usada.
  • Padrão do sistema: Quando a configuração de implantação da página pai da live copy não pode ser determinada, a configuração padrão do sistema é usada.

Por exemplo, um blueprint usa o site de referência We.Retail como conteúdo de origem. Um site é criado a partir do blueprint. Cada item na lista a seguir descreve um cenário diferente com relação ao uso de configurações de implantação:

  • Nenhuma das páginas do blueprint ou das páginas de live copy está definida para usar uma configuração de implantação. O MSM usa a configuração de implantação padrão do sistema para todas as páginas de live copy.
  • A página raiz do site de referência We.Retail está configurada com várias configurações de implantação. O MSM usa essas configurações de implantação para todas as páginas de live copy.
  • A página raiz do site de referência We.Retail está configurada com várias configurações de implantação, e a página raiz do site de live copy está configurada com um conjunto diferente de configurações de implantação. O MSM usa as configurações de implantação definidas na página raiz do site de live copy.

Definir as configurações de implementação de uma página de Live Copy setting-the-rollout-configurations-for-a-live-copy-page

Defina uma página de live copy com as configurações de implantação a serem usadas quando a página de origem for implantada. As páginas secundárias herdam a configuração por padrão. Ao definir a configuração de implantação a ser usada, você substituirá a configuração que a página de live copy herdará da página principal.

Você também pode definir as configurações de implantação para uma página de live copy ao criar a live copy.

  1. Use o console Sites para selecionar a página de live copy.

  2. Selecione Propriedades na barra de ferramentas.

  3. Abra a guia Live Copy.

    A seção Configuração mostra as configurações de implementação que a página herda.

    Configuração

  4. Se necessário, ajuste o sinalizador Herança da Live Copy. Se essa opção for marcada, a configuração da live copy terá efeito em todas as tarefas derivadas.

  5. Limpe a propriedade Herdar configurações de implantação da página principal e selecione uma ou mais configurações de implantação na lista.

    As configurações de implantação selecionadas aparecem abaixo da lista suspensa.

    Configurações de implantação selecionadas

  6. Clique em Salvar.

Definir a configuração de implantação de uma página do blueprint setting-the-rollout-configuration-for-a-blueprint-page

Configure uma página de blueprint com as configurações de implantação a serem usadas quando a página de blueprint for implantada.

As páginas secundárias da página do blueprint herdam a configuração. Ao definir a configuração de implantação a ser usada, você pode estar substituindo a configuração que a página herdará da página principal.

  1. Use o console Sites para selecionar a página raiz do blueprint.
  2. Selecione Propriedades na barra de ferramentas.
  3. Abra a guia Blueprint.
  4. Selecione uma ou mais configurações de implantação usando o seletor suspenso.
  5. Mantenha suas atualizações com Salvar.

Definir a configuração de implementação padrão do sistema setting-the-system-default-rollout-configuration

Especifique uma configuração de implantação a ser usada como padrão do sistema. Para especificar o padrão, configure o serviço OSGi:

  • Gerente de relacionamento dinâmico do WCM CQ do dia
    o PID do serviço é com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Configure o serviço usando o Console da Web ou um nó de repositório.

  • No console da Web, o nome da propriedade a ser configurada é Configuração de implantação padrão.
  • Ao usar um nó de repositório, o nome da propriedade a ser configurada é liverelationshipmgr.relationsconfig.default.

Defina esse valor de propriedade como o caminho da configuração de implementação a ser usada como padrão do sistema. O valor padrão é /libs/msm/wcm/rolloutconfigs/default, que é a Configuração de implantação padrão.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2