DocumentaçãoAEMGuia do usuário

Fluxos de trabalho de replicação de árvore no AEM as a Cloud Service tree-replication-workflows

Última atualização: 27 de maio de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Admin

Quando você deve publicar uma grande ramificação da árvore de conteúdo, a publicação padrão página por página pode ser lenta e consumir muitos recursos. O AEM as a Cloud Service fornece abordagens baseadas em fluxo de trabalho que replicam hierarquias profundas de conteúdo em partes gerenciáveis, pausam quando as filas de replicação estão ocupadas e reiniciam se forem interrompidas.

Use a Etapa do Fluxo de Trabalho de Ativação da Árvore para a replicação em massa da árvore. É a abordagem recomendada para cargas grandes. O Fluxo de Trabalho da Árvore de Conteúdo de Publicação permanece documentado para referência, mas foi descontinuado em favor da etapa de Ativação da Árvore.

Para outros tópicos de replicação, consulte Replicação.

Etapa do fluxo de trabalho de ativação da árvore tree-activation

A etapa do fluxo de trabalho de Ativação em árvore destina-se a replicar com desempenho uma hierarquia profunda de nós de conteúdo. Ele faz uma pausa automaticamente quando a fila fica muito grande para permitir que outras replicações prossigam em paralelo com a latência mínima.

Criar um Modelo de Fluxo de Trabalho que use a etapa de processo TreeActivation:

  1. Na página inicial do AEM as a Cloud Service, acesse Ferramentas - Fluxo de trabalho - Modelos.

  2. Na página Modelos de fluxo de trabalho, pressione Criar no canto superior direito da tela.

  3. Adicione um título e um nome ao modelo. Para obter mais informações, consulte Criando Modelos de Fluxo de Trabalho.

  4. Selecione o modelo criado na lista e pressione Editar

  5. Na janela a seguir, exclua a Etapa exibida por padrão

  6. Arraste e solte a Etapa do processo no fluxo do modelo atual:

    Etapa do processo

  7. Selecione a etapa do processo no fluxo e selecione Configurar pressionando o ícone de chave inglesa.

  8. Selecione a guia Processo, selecione Publish Content Tree na lista suspensa e marque a caixa de seleção Avanço do manipulador

    Treeactivation

  9. Defina quaisquer parâmetros adicionais no campo Argumentos. Vários argumentos separados por vírgula podem ser agrupados. Por exemplo:

    enableVersion=false,agentId=publish,chunkSize=50,maxTreeSize=500000,dryRun=false,filters=onlyModified,maxQueueSize=10

    note
    NOTE
    Para obter a lista de parâmetros, consulte a seção Parâmetros abaixo.

  10. Pressione Concluído para salvar o modelo de fluxo de trabalho.

Parâmetros

Nome
padrão
descrição
caminho
caminho raiz do qual iniciar
agentId
publicação
Agente que recebe a replicação (publish ou preview)
tamanhoParte
50
Número de caminhos a serem agrupados em uma única replicação
maxTreeSize
500000
Número máximo de nós para uma árvore ser considerada pequena
maxQueueSize
10
Número máximo de itens na fila de replicação
enableVersion
falso
Ativar controle de versão
dryRun
falso
Quando definido como verdadeiro, a replicação não é realmente chamada
userId
somente para trabalho. No workflow, o usuário que chama o workflow é usado
filtros
Lista de nomes de filtro de nó. Consulte os filtros compatíveis abaixo

Filtros de Suporte

Nome
Descrição
onlyModified
Nós: novos e pré-existentes que foram modificados desde a última publicação
onlyAtivated
Nós: publicados antes da última publicação

Retomar suporte

O fluxo de trabalho processa o conteúdo em partes, cada uma representando um subconjunto do conteúdo completo a ser publicado. Se o workflow for interrompido pelo sistema, ele continuará de onde parou.

Progresso do Fluxo de Trabalho de Monitoramento

  1. Na página inicial do AEM as a Cloud Service, vá para Ferramentas - Geral - Trabalhos.

  2. Examine a linha correspondente ao seu fluxo de trabalho. A coluna progress fornece uma indicação do andamento da replicação. Por exemplo, ele pode exibir 41/564 e, após a atualização, pode ser atualizado para 52/564.

    Progresso da Treeactivation

  3. Selecionar a linha e abri-la fornecerá detalhes adicionais sobre o status da execução do workflow.

    Detalhes do status de Treeactivation

Fluxo de trabalho de publicação da árvore de conteúdo publish-content-tree-workflow

NOTE
Esse recurso está obsoleto em favor da etapa de Ativação da árvore, que tem um desempenho mais alto, e pode ser incluído em um fluxo de trabalho personalizado.
Clique aqui para saber mais sobre este recurso obsoleto.

Você pode acionar uma replicação em árvore ao escolher Ferramentas - Fluxo de trabalho - Modelos e copiar o modelo de fluxo de trabalho pronto para uso Publicar árvore de conteúdo, conforme mostrado abaixo:

O Cartão De Fluxo De Trabalho De Publicação Da Árvore De Conteúdo

Não chame o modelo original. Em vez disso, primeiro copie o modelo e chame essa cópia.

Como todos os fluxos de trabalho, também é possível chamá-lo por meio da API. Para obter mais informações, consulte Interação programática com fluxos de trabalho.

Como alternativa, você pode criar um Modelo de Fluxo de Trabalho que use a etapa de processo Publish Content Tree.

  1. Na página inicial do AEM as a Cloud Service, acesse Ferramentas - Fluxo de trabalho - Modelos.

  2. Na página Modelos de fluxo de trabalho, pressione Criar no canto superior direito da tela.

  3. Adicione um título e um nome ao modelo. Para obter mais informações, consulte Criando Modelos de Fluxo de Trabalho.

  4. Selecione o modelo criado na lista e pressione Editar

  5. Na janela a seguir, arraste e solte a etapa do processo no fluxo do modelo atual:

    Etapa do processo

  6. Selecione a etapa do processo no fluxo e selecione Configurar pressionando o ícone de chave inglesa.

  7. Selecione a guia Processo, selecione Publish Content Tree na lista suspensa e marque a caixa de seleção Avanço do manipulador

    Treeactivation

  8. Defina quaisquer parâmetros adicionais no campo Argumentos. Vários argumentos separados por vírgula podem ser agrupados. Por exemplo:

    enableVersion=true,agentId=publish,includeChildren=true

    note
    NOTE
    Para obter a lista de parâmetros, consulte a seção Parâmetros abaixo.

  9. Pressione Concluído para salvar o modelo de fluxo de trabalho.

Parâmetros

  • includeChildren (valor booleano, padrão: false). O valor false significa que somente o caminho é publicado; true significa que os filhos também são publicados.

  • replicateAsParticipant (valor booleano, padrão: false). Se configurado como true, a replicação está usando o userid do principal que executou a etapa do participante.

  • enableVersion (valor booleano, padrão: false). Esse parâmetro determina se uma nova versão será criada na replicação.

  • agentId (valor da string; o valor padrão significa que apenas os agentes para publicação são usados). Especifique explicitamente o agente de destino, por exemplo, publish para o nível de publicação em tempo real ou preview para o nível de visualização.

  • filters (valor da cadeia de caracteres; o valor padrão significa que todos os caminhos estão ativados). Os valores disponíveis são:

    • onlyActivated - ativar somente as páginas que (já) foram ativadas. Atua como uma forma de reativação.
    • onlyModified - ativar apenas os caminhos que já estejam ativados e tenham uma data de modificação posterior à data de ativação.
    • O conteúdo acima pode ser ORed com uma barra vertical “|”. Por exemplo, onlyActivated|onlyModified.

Logs

Quando a etapa do fluxo de trabalho de ativação da árvore é iniciada, ela registra os parâmetros de configuração no nível de log INFO. Quando os caminhos são ativados, uma declaração INFO também é registrada.

Uma declaração INFO final é registrada depois que a etapa do fluxo de trabalho replica todos os caminhos.

Além disso, você pode aumentar o nível de log dos registradores abaixo de com.day.cq.wcm.workflow.process.impl para DEBUG/TRACE para obter ainda mais informações de log.

Se houver erros, a etapa do fluxo de trabalho será encerrada com um WorkflowException, que envolve a Exceção subjacente.

A seguir estão exemplos de logs gerados durante um exemplo de fluxo de trabalho de publicação da árvore de conteúdo:

code language-none 
21.04.2021 19:14:55.566 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.treeactivation.TreeActivationWorkflowProcess TreeActivation options: replicateAsParticipant=false(userid=workflow-process-service), agentId=publish, chunkSize=100, filter=, enableVersion=false
code language-none 
21.04.2021 19:14:58.541 [cm-p123-e456-aem-author-797aaaf-wkkqt] *INFO* [JobHandler: /var/workflow/instances/server60/2021-04-20/brian-tree-replication-test-2_1:/content/wknd/us/en/adventures] com.day.cq.wcm.workflow.process.impl.ChunkedReplicator closing chunkedReplication-VolatileWorkItem_node1_var_workflow_instances_server60_2021-04-20_brian-tree-replication-test-2_1, 17 paths replicated in 2971 ms
recommendation-more-help
experience-manager-cloud-service-help-main-toc