Práticas recomendadas do workflow workflow-best-practices

Os workflows permitem automatizar as atividades do Adobe Experience Manager (AEM).

Geralmente, eles representam uma grande quantidade do processamento que ocorre em um ambiente de AEM, de modo que, quando as etapas do fluxo de trabalho personalizado não são gravadas de acordo com as práticas recomendadas ou os fluxos de trabalho prontos não são configurados para serem executados da maneira mais eficiente possível, o sistema pode sofrer como resultado.

Portanto, é altamente recomendável planejar suas implementações de workflows com cuidado.

Configuração configuration

Ao configurar processos de fluxo de trabalho (personalizados e/ou prontos para uso), há algumas coisas que devem ser levadas em conta.

Workflows transitórios transient-workflows

Para otimizar cargas altas de ingestão, você pode definir um valor de fluxo de trabalho como transitório.

Quando um workflow é transitório, os dados de tempo de execução relacionados às etapas de trabalho intermediárias não são persistentes no JCR quando são executados (as renderizações de saída são persistentes, é claro).

As vantagens podem incluir:

Ajuste de fluxos de trabalho do DAM tuning-dam-workflows

Para obter diretrizes de ajuste de desempenho para workflows DAM, consulte o Guia de ajuste de desempenho do AEM Assets.

Configurar o número máximo de fluxos de trabalho simultâneos configure-the-maximum-number-of-concurrent-workflows

AEM pode permitir que vários threads de workflow sejam executados simultaneamente. Por padrão, o número de threads é configurado para ser metade do número de núcleos do processador no sistema.

Nos casos em que os workflows que estão sendo executados são exigentes dos recursos do sistema, isso pode significar que pouco resta para AEM usar em outras tarefas, como renderizar a interface do usuário de criação. Como resultado, o sistema pode ficar lento durante atividades como o upload de imagens em massa.

Para resolver esse problema, o Adobe recomenda configurar o número de Máximo de trabalhos paralelos deve estar entre metade e três quartos do número de núcleos do processador no sistema. Isso deve permitir capacidade suficiente para que o sistema continue responsivo ao processar esses workflows.

Para configurar Máximo de trabalhos paralelos, você pode:

Além disso, há uma configuração separada para a variável Fila de Trabalho de Processo Externo do Fluxo de Trabalho Granite. Isso é usado para processos de workflow que iniciam binários externos, como InDesign Server ou Imagem Magick.

Configurar filas de trabalhos individuais configure-individual-job-queues

Em alguns casos, é útil configurar filas de trabalhos individuais para controlar encadeamentos simultâneos ou outras opções de fila, com base em um trabalho individual. Você pode adicionar e configurar uma fila individual no console da Web por meio do Configuração da fila de trabalhos do Apache Sling fábrica. Para encontrar o tópico apropriado para ser listado, execute o modelo de seu fluxo de trabalho e procure-o no Trabalhos Sling console; por exemplo, em http://localhost:4502/system/console/slingevent.

As filas de trabalhos individuais também podem ser adicionadas para fluxos de trabalho transitórios.

Configurar limpeza de workflow configure-workflow-purging

Numa instalação padrão, o AEM fornece um console de manutenção, onde as atividades de manutenção diárias e semanais podem ser programadas e configuradas; por exemplo, em:

http://localhost:4502/libs/granite/operations/content/maintenance.html

Por padrão, a variável Janela de manutenção semanal tem um Limpeza de Fluxo de Trabalho , mas isso precisa ser configurado antes de ser executado. Para configurar limpeza de workflow, um novo Configuração de limpeza de fluxo de trabalho do Adobe Granite deve ser adicionado no console da Web.

Para obter mais detalhes sobre tarefas de manutenção no AEM, consulte o Painel de operações.

Personalização customization

Ao gravar processos de fluxo de trabalho personalizados, alguns itens devem ser considerados.

Localizações locations

As definições de modelos de fluxo de trabalho, iniciadores, scripts e notificações são mantidas no repositório de acordo com o tipo; ou seja, pronto, personalizado, entre outros.

Locais - Modelos de fluxo de trabalho locations-workflow-models

Os modelos de fluxo de trabalho são armazenados no repositório de acordo com o tipo :

Locais - Inicializadores de fluxo de trabalho locations-workflow-launchers

As definições de iniciador de fluxo de trabalho também são armazenadas no repositório de acordo com o tipo :

Locais - Scripts de fluxo de trabalho locations-workflow-scripts

Os scripts de workflow também são armazenados no repositório de acordo com o tipo :

Locais - Notificações de fluxo de trabalho locations-workflow-notifications

As notificações de workflow também são armazenadas no repositório de acordo com o tipo :

Sessões de Processo process-sessions

Como em qualquer desenvolvimento personalizado, sempre é recomendável usar uma sessão de usuário quando possível:

Ao implementar um processo de workflow:

public void execute(WorkItem item, WorkflowSession workflowSession, MetaDataMap args) throws WorkflowException {
        // to obtain a jcr session:
        javax.jcr.Session jcrSession = workflowSession.adaptTo(javax.jcr.Session.class);

        // to obtain a sling resource resolver:
        org.apache.sling.api.resource.ResourceResolver slingResourceResolver = workflowSession.adaptTo(org.apache.sling.api.resource.ResourceResolver.class);

Salvar uma sessão:

Minimizar o número/escopo de iniciadores minimize-the-number-scope-of-launchers

Há um ouvinte que é responsável por todos os inicializadores de fluxo de trabalho registrados:

Criar muitos lançadores fará com que o processo de avaliação seja executado mais lentamente.

Criar um caminho de globalização na raiz do repositório em um único iniciador faria com que o mecanismo de fluxo de trabalho escutasse e avaliasse eventos de criação/modificação em cada nó no repositório. Por esse motivo, é recomendável criar apenas iniciadores necessários e tornar o caminho do globbing o o mais específico possível.

Devido ao impacto desses lançadores no comportamento do fluxo de trabalho, também pode ser útil desativar os iniciadores prontos para uso que não estejam em uso.

Aprimoramentos de configuração para inicializadores configuration-enhancements-for-launchers

O configuração do iniciador foi aprimorado para oferecer suporte ao seguinte:

Não iniciar fluxos de trabalho de outros fluxos de trabalho do-not-start-workflows-from-other-workflows

Os workflows podem carregar uma quantidade significativa de sobrecarga, tanto em termos de objetos criados na memória quanto de nós rastreados no repositório. Por isso, é melhor fazer com que um workflow faça seu processamento sozinho em vez de iniciar workflows adicionais.

Um exemplo disso seria um fluxo de trabalho que implementa um processo de negócios em um conjunto de conteúdo e, em seguida, ativa esse conteúdo. É melhor criar um processo de fluxo de trabalho personalizado que ative cada um desses nós, em vez de iniciar um Ativar conteúdo modelo para cada um dos nós de conteúdo que precisam ser publicados. Essa abordagem exigirá trabalho de desenvolvimento adicional, mas é mais eficiente quando executada do que iniciar uma instância de fluxo de trabalho separada para cada ativação.

Outro exemplo seria um fluxo de trabalho que processa vários nós, cria um pacote de fluxo de trabalho e ativa esse pacote. Em vez de criar o pacote e depois iniciar um fluxo de trabalho separado com o pacote como carga útil, você pode alterar a carga do fluxo de trabalho na etapa que cria o pacote e, em seguida, chamar a etapa para ativar o pacote no mesmo modelo de fluxo de trabalho.

Handler avançado handler-advance

Ao projetar um modelo de fluxo de trabalho, você tem a opção de ativar o avanço do manipulador em suas etapas do fluxo de trabalho. Como alternativa, você pode adicionar código à etapa do fluxo de trabalho para determinar qual etapa deve ser executada em seguida e, em seguida, executá-la.

Recomenda-se usar o handler advance, pois oferece melhor desempenho.

Estágios do Fluxo de Trabalho workflow-stages

Você pode definir estágios do workflow, atribua tarefas/etapas a um estágio de fluxo de trabalho específico.

Essas informações são usadas para exibir o progresso de um workflow quando você clica no Informações do fluxo de trabalho guia de um item de trabalho da Caixa de entrada. Os modelos de fluxo de trabalho existentes podem ser editados para adição de estágios.

Etapa Ativar processo da página activate-page-process-step

O Ativar processo de página Essa etapa ativará páginas para você, mas não encontrará automaticamente quaisquer ativos do DAM referenciados e os ativará também.

Isso é algo que deve ser lembrado se você planeja usar essa etapa como parte de um modelo de fluxo de trabalho.

Considerações sobre atualização upgrade-considerations

Ao atualizar sua instância:

Ferramentas do sistema system-tools

Há muitas ferramentas de sistema disponíveis para ajudar com monitoramento, manutenção e solução de problemas de workflows. Todos os URLs de exemplo abaixo usam localhost:4502, mas deve estar disponível em qualquer instância do autor ( <hostname>:<port>).

Console de Manuseio de Trabalho do Sling sling-job-handling-console

http://localhost:4502/system/console/slingevent

O console Sling Job Handling mostrará:

Ferramenta Relatório de Fluxo de Trabalho workflow-report-tool

A ferramenta de relatório do workflow está sendo removida na versão 6.3 para evitar a degradação do desempenho.

MBean de operações de manutenção de fluxo de trabalho workflow-maintenance-operations-mbean

http://localhost:4502/system/console/jmx/com.adobe.granite.workflow:type=Maintenance

O MBean de manutenção de workflow expõe várias rotinas de manutenção úteis, como limpar workflows concluídos e recuperar estatísticas de workflow.

Informações adicionais further-information

Para obter mais informações, consulte: