Práticas recomendadas de workflow workflow-best-practices

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

Geralmente representam uma grande quantidade do processamento que ocorre em um ambiente AEM, de modo que, quando as etapas personalizadas do fluxo de trabalho não são gravadas de acordo com as práticas recomendadas ou os fluxos de trabalho prontos para uso 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 as implementações dos 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 lembradas.

Workflows transitórios transient-workflows

Para otimizar altas cargas de assimilação, você pode definir um 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 mantidos no JCR quando executados (as representações de saída são mantidas).

As vantagens podem incluir:

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

Para obter diretrizes de ajuste de desempenho para fluxos de trabalho do DAM, consulte o Guia de Ajuste de Desempenho do AEM Assets.

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

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

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

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

Para configurar o Máximo de Trabalhos Paralelos, você pode:

Além disso, há uma configuração separada para a Fila de trabalhos do processo externo do fluxo de trabalho do Granite. Isso é usado para processos de fluxo de trabalho que iniciam binários externos, como InDesign Server ou Image Magick.

Configurar Filas de Trabalhos Individuais configure-individual-job-queues

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

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

Configurar a limpeza de fluxo de trabalho configure-workflow-purging

Em uma instalação padrão, o AEM fornece um console de manutenção em que 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 Janela de Manutenção Semanal tem uma tarefa Limpeza de Fluxo de Trabalho, mas ela precisa ser configurada para ser executada. Para configurar as remoções de fluxo de trabalho, uma nova Configuração de remoção de fluxo de trabalho do Adobe Granite deve ser adicionada ao console da Web.

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

Personalização customization

Ao escrever processos de fluxo de trabalho personalizados, há algumas coisas que devem ser lembradas.

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, prontas para uso, personalizadas, entre outras.

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 - Iniciadores de fluxo de trabalho locations-workflow-launchers

As definições do 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 fluxo de trabalho 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 fluxo de trabalho 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 a sessão de um 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);

Salvando uma sessão:

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

Há um ouvinte responsável por todos os iniciadores de fluxo de trabalho registrados:

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

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

Devido ao impacto desses inicializadores no comportamento do fluxo de trabalho, também pode ser útil desativar os inicializadores predefinidos que não estão em uso.

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

A configuração personalizada do inicializador foi aprimorada para oferecer suporte ao seguinte:

Não iniciar workflows a partir de outros workflows do-not-start-workflows-from-other-workflows

Os workflows podem transportar uma quantidade significativa de sobrecarga, tanto em termos de objetos criados na memória quanto de nós rastreados no repositório. Por esse motivo, é melhor ter um workflow fazendo seu processamento dentro de si mesmo do que 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 modelo Ativar conteúdo para cada um dos nós de conteúdo que precisam ser publicados. Essa abordagem exigirá trabalho de desenvolvimento adicional, mas é mais eficiente ao ser 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 iniciar um fluxo de trabalho separado com o pacote como a carga, você pode alterar a carga do fluxo de trabalho na etapa que cria o pacote e chamar a etapa para ativar o pacote no mesmo modelo de fluxo de trabalho.

Avanço do manipulador handler-advance

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

É recomendável usar o avanço do manipulador, pois ele oferece melhor desempenho.

Estágios do fluxo de trabalho workflow-stages

Você pode definir estágios de fluxo de trabalho e atribuir tarefas/etapas a um estágio de fluxo de trabalho específico.

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

Etapa do processo de ativação da página activate-page-process-step

A etapa Ativar processo de página ativará as páginas para você, mas não encontrará automaticamente nenhum ativo DAM referenciado e os ativará também.

Isso é algo para ter em mente 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 no monitoramento, manutenção e solução de problemas de workflows. Todos os URLs de exemplo abaixo usam localhost:4502, mas devem estar disponíveis em qualquer instância de autor ( <hostname>:<port>).

Console de manuseio de trabalhos do Sling sling-job-handling-console

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

O console Manuseio de trabalhos do Sling mostrará:

Ferramenta Relatório de fluxo de trabalho workflow-report-tool

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

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

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

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

Informações adicionais further-information

Para obter mais informações, consulte: