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

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Execute as seguintes tarefas para controlar como e quando as cópias em tempo real são sincronizadas com o conteúdo de origem.

  • Decida se as configurações de implementação existentes atendem aos seus requisitos ou se é necessário criar um ou mais.
  • Especifique as configurações de implementação a serem usadas para suas cópias dinâmicas.

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

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

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

Acionadores de implementação rollout-triggers

Cada configuração de implementação usa um acionador de implementação que faz com que a implementação ocorra. As configurações de implementação podem usar um dos seguintes acionadores:

  • Na implantação: O Implantação é usado na página de impressão azul ou na variável 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 implementação instaladas installed-rollout-configurations

A tabela a seguir lista as configurações de implementação instaladas com o AEM. A tabela inclui as ações de acionador e de sincronização de cada configuração de implementação. Se as ações de configuração de implementação instaladas não atenderem aos seus requisitos, você poderá criar uma nova configuração de implementaçã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 implementação padrão que permite que o processo de implementação comece com estímulos de implementaçã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

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

Use essa configuração de implementação com moderação, pois usa o acionador Em modificação .

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

Força o conteúdo à Live Copy quando a página do blueprint é modificada, sem atualizar referências (por exemplo, para cópias superficiais).

Use essa configuração de implementação com moderação, pois usa o acionador Em modificação .

Em modificação
contentUpdate
contentCopy
contentDelete
orderChildren
Promover lançamento
Configuração de implementação padrão para a promoção de páginas de inicialização.
Na implantação
contentUpdate
contentCopy
contentDelete
referencesUpdate
orderChildren
markLiveRelationship
Configuração de implantação de 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 destino a partir 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 de publicação do DPS que permite iniciar o processo de implantação no acionador de implantação, enquanto exclui as propriedades de vinculaçã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 a API Catalog Generator em vez do MSM para implementaçõ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 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, 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 as propriedades da live copy. A propriedade editMap determina quais propriedades são editadas e seu valor. O valor da propriedade editMap deve usar o seguinte formato:

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

O current_value e new_value itens 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 da live copy da seguinte maneira:

  • O sling:resourceType propriedades definidas como contentpage ou homepage estão definidas como mobilecontentpage.
  • As propriedades cq:template definidas como contentpage sã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 que a página foi distribuída. Para ser notificado, é necessário primeiro assinar eventos de distribuição.
orderChildren
Na Live Copy, 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 pesquisa caminhos nas páginas de 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 destino (somente para páginas) e toma a Live Copy como carga útil.

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

target: (String) O caminho para o modelo de workflow.
mandatory

Define a permissão de várias ACLs na página de Live Copy como somente leitura para um grupo de usuários específico. As seguintes ACLs estã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 de Live Copy como somente leitura para um grupo de usuários específico. As seguintes ACLs estã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 de 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 do blueprint/origem tiver sido publicada pelo menos uma vez, o criará 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.
PageMoveAction

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

A ação copia em vez de mover a página LiveCopy (relacionada) do local antes de mover para o local depois.

A PageMoveAction não altera a página LiveCopy no local antes da movimentação. Portanto, para RolloutConfigurations consecutivas, ele tem o status de um LiveRelationhip 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 true para atualizar referências. O padrão é verdadeiro.
productCreateUpdate

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

  • Gerar ou implantar um catálogo (ou seção de catálogo)
  • Um usuário restaura a herança de sincronização de um componente de produto.
markLiveRelationship
Indica que existe uma relação ativa para o conteúdo criado para inicialização.
catalogRolloutHooks
Executa ganchos de implementaçã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 no AEM Javadocs.
productUpdate
Atualiza páginas de produtos em uma live copy de um catálogo de produtos

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

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

A nova configuração de implementação estará disponível para você ao definir configurações de implementação em um blueprint ou página de 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 subnós relacionados ao funcionamento interno da 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, existem vários métodos de gestão das definições de configuração para esses serviços; see Configuração do 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 configuração 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
PageMoveAction
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

Tipos de nó excluídos

cq.wcm.msm.action.excludednodetypes

Uma expressão regular que corresponde aos nomes dos 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 Ação de atualização de conteúdo do MSM CQ. Uma expressão regular que corresponde aos nomes dos tipos de nó mixin a serem excluídos da ação de sincronização.
NOTE
Na interface clássica, o ícone de bloqueio que aparece na caixa de diálogo Propriedades da página para páginas do LiveCopy não reflete a configuração da propriedade Propriedades de página excluídas . O ícone de bloqueio aparece mesmo para propriedades que são excluídas da ação de sincronização.
NOTE
Na interface habilitada para toque, veja também Configurando bloqueios de MSM nas propriedades da página).

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ídas por padrão, elas são definidas na configuração OSGi de Ação de atualização de conteúdo do MSM CQ, sob 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:

chlimage_1-18

É 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, existem vários métodos de gestão das definições de configuração para esses serviços; see Configuração do 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 configuração 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 essa opção (Console da Web) ou defina essa propriedade booleana como true (configuração do repositório) para substituir referências que direcionem qualquer recurso que esteja na ramificação da LiveCopy mais importante.

Atualizar páginas de referência

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

Disponível somente para Ação de movimentação de página MSM CQ. Selecione essa opção (Console da Web) ou defina essa propriedade booleana como true (configuração do repositório) para atualizar quaisquer referências para usar a página original para, em vez disso, fazer referência à página LiveCopy.

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

O MSM permite que você especifique conjuntos de configurações de implementação que são usadas geralmente e, quando necessário, você pode substituí-los por cópias ativas 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 implementação a serem usadas descreve como o MSM determina quais configurações de implementaçã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 implementação, o MSM usa essas configurações.
  • Propriedades da página do blueprint: Quando uma live copy é baseada em um blueprint, e a página de Live Copy não está configurada com uma configuração de implementação, a configuração de implementação associada à página de origem do blueprint é usada.
  • Propriedades da página principal da Live Copy: Quando nem a página de Live Copy nem a página de origem do blueprint são configuradas com uma configuração de implementação, a configuração de implementação que se aplica à página pai da página de Live Copy é usada.
  • Padrão do sistema: Quando a configuração de implementação da página pai da Live Copy não pode ser determinada, a configuração de implementaçã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 relacionado ao uso de configurações de implementação:

  • Nenhuma das páginas do blueprint ou da Live Copy é configurada para usar uma configuração de implementação. O MSM usa a configuração de implementação padrão do sistema para todas as páginas de Live Copy.
  • A página raiz do site de referência We.Retail é configurada com várias configurações de implementação. O MSM usa essas configurações de implementação para todas as páginas de Live Copy.
  • A página raiz do site de referência We.Retail é configurada com várias configurações de implementação e a página raiz do site de Live Copy é configurada com um conjunto diferente de configurações de implementação. O MSM usa as configurações de implementação configuradas 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

Configure uma página de Live Copy com as configurações de implementação a serem usadas quando a página de origem for distribuída. As páginas secundárias herdam a configuração por padrão. Ao configurar a configuração de implementação a ser usada, você está substituindo a configuração que a página de Live Copy herda de seu pai.

Você também pode configurar as configurações de implementação de uma página de Live Copy quando criar a live copy.

  1. Use o 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.

    chlimage_1-19

  4. Se necessário, ajuste o sinalizador de Herança da Live Copy. Se marcada, a configuração da live copy é efetiva para todos os filhos.

  5. Limpe o Herdar Configuração De Implantação Do Pai , em seguida, selecione uma ou mais configurações de implementação na lista.

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

    chlimage_1-20

  6. Clique ou toque em Salvar.

Configuração de implantação para uma página do Blueprint setting-the-rollout-configuration-for-a-blueprint-page

Configure uma página do blueprint com as configurações de implementação a serem usadas quando a página do blueprint for distribuída.

Observe que as páginas filhas da página do blueprint herdam a configuração. Ao configurar a configuração de implementação a ser usada, você pode estar substituindo a configuração que a página herda de seu pai.

  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 implementaçã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 implementaçã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 de serviço é
    com.day.cq.wcm.msm.impl.LiveRelationshipManagerImpl

Configure o serviço usando a variável Console da Web ou nó do 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
5ce3024a-cbea-458b-8b2f-f9b8dda516e8