Configurar e personalizar workflows id181AI0OJ0RO
Os workflows permitem automatizar as atividades do Adobe Experience Manager (AEM). Um fluxo de trabalho consiste em uma série de etapas executadas em uma ordem específica. Você pode definir uma atividade distinta para executar em cada etapa. Por exemplo, você pode enviar uma notificação por email a todos os revisores em um grupo quando uma revisão de tópico é criada. Ou envie uma notificação para o editor quando uma tarefa de geração de saída for concluída.
Para obter mais informações sobre workflows no AEM, consulte:
-
Aplicando e participando de fluxos de trabalho: Trabalhando com fluxos de trabalho.
-
Criação de modelos de fluxo de trabalho e extensão da funcionalidade do fluxo de trabalho: Desenvolvimento e extensão de Fluxos de Trabalho.
-
Melhorando o desempenho de fluxos de trabalho que usam recursos significativos do servidor: Processamento de Fluxo de Trabalho Simultâneo.
As seções neste tópico guiarão você pelas várias personalizações que podem ser feitas nos fluxos de trabalho padrão enviados no AEM Guides.
Personalizar fluxo de trabalho de revisão id176NE0C00HS
A equipe de criação de conteúdo de cada organização trabalha de maneira específica para atender às suas necessidades de negócios. Em algumas organizações há um editor dedicado, enquanto outras poderiam ter um sistema automatizado de revisão editorial em vigor. Por exemplo, em uma organização, um fluxo de trabalho típico de criação e publicação pode incluir tarefas como: sempre que um autor é concluído com a criação de conteúdo, ele vai automaticamente para os revisores e, quando a revisão é concluída, vai para o editor para gerar a saída final. No AEM, as atividades que você realiza em seu conteúdo e ativos podem ser combinadas no formato de um processo e mapeadas para um fluxo de trabalho de AEM. Para obter mais informações sobre fluxos de trabalho no AEM, consulte Administrar fluxos de trabalho na documentação do AEM.
O AEM Guides permite personalizar o workflow de revisão padrão. Você pode usar os quatro processos personalizados relacionados à revisão a seguir com outros fluxos de trabalho de criação ou publicação.
-
Criar Revisão: esse processo prepara os metadados necessários para criar uma tarefa de revisão. Por exemplo, atribuirá permissão de revisão aos revisores, definirá o status dos tópicos como em revisão, definirá as linhas do tempo de revisão e muito mais. Dos quatro processos, esse é o único processo obrigatório que deve ser incluído no fluxo de trabalho personalizado. No seu workflow, você pode optar por incluir ou excluir os outros três processos.
-
Atribuir Tarefa de Revisão: esse processo cria a tarefa de revisão e envia a notificação da tarefa para o iniciador e os revisores.
-
Enviar Email de Revisão: esse processo envia o email de revisão para o iniciador e os revisores.
-
Agendar Trabalho para Fechar Revisão: esse processo garante que o processo de revisão seja concluído ao atingir o prazo final.
Quando você está criando um fluxo de trabalho de revisão personalizado, a primeira tarefa é definir os metadados necessários para o processo Criar revisão. Para fazer isso, você pode criar um script ECMA. Uma amostra do script ECMA que atribui os metadados é fornecida abaixo:
var workflowdata=workItem.getWorkflowData();
workflowdata.getMetaDataMap().put("initiator","admin");
workflowdata.getMetaDataMap().put("operation","AEM_REVIEW");
workflowdata.getMetaDataMap().put("orgTopics","/content/dam/xml-solution/review.xml");
workflowdata.getMetaDataMap().put("payloadJson","{\"base\":\"/content/dam/xml-solution\",\"asset\":[\"/content/dam/xml-solution/review.xml\"],\"referrer\":\""}");
workflowdata.getMetaDataMap().put("deadline","2017-06-27T13:19:00.000+05:30");
workflowdata.getMetaDataMap().put("title","Review through custom workflow");
workflowdata.getMetaDataMap().put("description","Initiate this review process using the AEM workflow");
workflowdata.getMetaDataMap().put("assignee","user-one", "user-two");
workflowdata.getMetaDataMap().put("status","1");
workflowdata.getMetaDataMap().put("projectPath","/content/projects/review");
workflowdata.getMetaDataMap().put("startTime", System.currentTimeMillis());
Você pode criar esse script no nó /etc/workflows/scripts
. A tabela a seguir descreve as propriedades que estão sendo atribuídas por esse script ECMA:
initiator
operation
AEM_REVIEW
.orgTopics
payloadJson
-
base
: caminho da pasta pai que contém o tópico enviado para revisão.-
asset
: caminho do tópico enviado para revisão.-
referrer
: deixe em branco.deadline
yyyy-MM-dd'T'HH:mm:ss.SSSXXX
.title
description
assignee
status
startTime
System.currentTimeMillis()
para obter a hora atual do sistema.Depois de criar o script, chame-o antes de chamar o processo Criar revisão no workflow. Em seguida, dependendo das suas necessidades, você poderá chamar os outros processos de workflow de revisão.
Remover o fluxo de trabalho de revisão da configuração de limpeza
Para melhorar o desempenho do mecanismo de fluxo de trabalho, você pode remover regularmente do repositório AEM as instâncias concluídas do fluxo de trabalho. Se você estiver usando as configurações padrão do AEM, todas as instâncias de fluxo de trabalho concluídas serão excluídas após um período específico. Isso também resulta em todos os workflows de revisão para serem removidos do repositório AEM.
Você pode impedir a limpeza automática dos fluxos de trabalho de revisão removendo o modelo de fluxo de trabalho de revisão (information) da configuração de limpeza automática. Você precisa usar a Configuração de limpeza de fluxos de trabalho do Adobe Granite para remover os modelos de fluxos de trabalho de revisão da lista de limpeza automática.
Na Configuração de limpeza de fluxos de trabalho do Adobe Granite, certifique-se de listar pelo menos um fluxo de trabalho que possa ser limpo com segurança. Por exemplo, você pode usar qualquer um dos workflows a seguir criados pelo AEM Guides:
- /etc/workflow/models/publishditamap/jcr:content/model
- /etc/workflow/models/post-dita-project-creation-tasks/ jcr:content/model
Adicionar um fluxo de trabalho na Configuração de limpeza de fluxo de trabalho do Adobe Granite garante que o AEM remova apenas os fluxos de trabalho listados na configuração. Isso impede que o AEM remova as informações do fluxo de trabalho de revisão.
Para obter mais detalhes sobre como configurar a Configuração de limpeza de fluxos de trabalho do Adobe Granite, consulte Administração de instâncias de fluxos de trabalho na documentação do AEM.
Personalizar modelos de email
Vários workflows do AEM Guides usam notificações por email. Por exemplo, se você iniciar uma tarefa de revisão, uma notificação por email será enviada aos revisores. No entanto, para garantir que a notificação por email seja enviada, é necessário habilitar essa funcionalidade no AEM. Para habilitar a notificação por email no AEM, consulte o artigo Configurando a Notificação por Email na documentação do AEM.
O AEM Guides contém um conjunto de modelos de email que podem ser personalizados. Execute as seguintes etapas para personalizar esses modelos:
-
Faça logon no AEM e abra o modo CRXDE Lite.
-
Na guia Navegador, vá para o seguinte local:
/libs/fmdita/mail
note note NOTE Não faça nenhuma personalização nos arquivos de configuração padrão disponíveis no nó libs
. Você deve criar uma sobreposição do nólibs
no nóapps
e atualizar os arquivos necessários somente no nóapps
. -
A pasta de e-mail contém os seguintes modelos personalizáveis:
table 0-row-2 1-row-2 2-row-2 3-row-2 Nome do arquivo de modelo Descrição closereview.html Esse template de email é usado quando uma tarefa de revisão é fechada. createreview.html Esse template de email é usado quando uma nova tarefa de revisão é criada. reviewapproval.css Esse arquivo CSS contém o estilo dos modelos de email.
Personalizar fluxo de trabalho de geração de pós-saída id17A6GI004Y4
O AEM Guides oferece a flexibilidade de especificar um fluxo de trabalho de geração de pós-saída. Você pode executar algumas tarefas de pós-processamento na saída gerada usando o AEM Guides. Por exemplo, você pode querer aplicar algumas tags CQ na saída de AEM Site gerada, ou definir determinadas propriedades na saída de PDF, ou pode querer enviar um email para um conjunto de usuários depois que a saída for gerada.
Você pode criar um novo modelo de fluxo de trabalho para usar como um fluxo de trabalho de geração pós-saída. Quando um workflow de geração pós-saída é acionado, o workflow de geração de saída compartilha informações contextuais por meio do mapa de metadados do workflow, que você pode usar para executar o processamento na saída gerada. A tabela a seguir descreve as informações contextuais compartilhadas como metadados:
outputName
generatedPath
outputType
outputTitle
outputHistoryPath
isSuccess
logPath
generatedTime
initiator
Para usar os metadados de geração de saída, você pode criar um script ECMA ou um pacote OSGi. Uma amostra do script ECMA que usa os metadados é fornecida abaixo:
/etc/workflows/scripts
.var session = workflowSession.getSession(); // Obtain session object to read/write the repository.
var payload = workItem.getWorkflowData().getPayload().toString(); // Get the workflow payload (the ditamap file on which the generation was triggered)
var metadata = workItem.getWorkflowData().getMetaDataMap(); // Get the workflow metadata object
var generatedPath = metadata.get("generatedPath"); // supplied by AEM Guides
var username = metadata.get("initiator"); // supplied by AEM Guides
var successful = metadata.get("isSuccess"); // supplied by AEM Guides
var title = metadata.get("outputTitle"); // supplied by AEM Guides
var subject = "Output Generation Finished";
var message = "Generation of output " + title + " just finished " +
(successful ? "successfully. " : "unsuccessfully. ");
message += "It was triggered by " + username;
if (successful) {
message += "<br/><br/>The path to the generated output is " +
generatedPath;
}
/*
MailerAPI.sendMail("dl-docs-authors", subject, message);
*/
Depois de criar o script, chame o script personalizado no fluxo de trabalho. Em seguida, dependendo das suas necessidades, você poderá chamar os outros processos de workflow. Depois de criar o fluxo de trabalho personalizado, chame Finalizar geração de Post como a última etapa do processo de fluxo de trabalho. A etapa Finalizar Geração de Post garante que o status da tarefa de geração de saída seja atualizado para Concluído na conclusão do processo de geração de saída. Depois de criar um fluxo de trabalho personalizado de geração pós-saída, você pode configurá-lo com qualquer uma das predefinições de geração de saída. Selecione o fluxo de trabalho necessário na propriedade Executar Fluxo de Trabalho de Geração de Post da predefinição necessária. Quando você executa uma tarefa de geração de saída usando a predefinição de saída configurada, o status da tarefa (na guia Saída) muda para Post-Processing.
Personalizar o fluxo de trabalho Atualizar ativo id18C3D0I0B5Z
Por padrão, o fluxo de trabalho Atualizar ativo do DAM é acionado sempre que você cria ou atualiza qualquer ativo AEM (XML ou não XML). Por exemplo, ao criar ou atualizar um tópico, o fluxo de trabalho Ativo de atualização do DAM é executado. O fluxo de trabalho Ativo de atualização do DAM tenta extrair metadados relevantes do Assets. O Fluxo de trabalho de atualização de ativos não tem etapas para extrair metadados relevantes de um arquivo DITA e o fluxo de trabalho Ativo de atualização do DAM gera muitos logs no momento da execução. Se quiser evitar os logs extras, você poderá configurar o workflow para ignorar todo o processamento de arquivos XML.
Execute as seguintes etapas para personalizar o fluxo de trabalho do Ativo de atualização do DAM:
-
abra a página Iniciadores do fluxo de trabalho.
O URL padrão para acessar a página Iniciadores de fluxo de trabalho é:
code language-http http://<server name>:<port>/libs/cq/workflow/admin/console/content/launchers.html
-
Na lista de inicializadores de fluxo de trabalho, abra as propriedades do fluxo de trabalho Ativo de atualização do DAM.
-
Adicione uma condição com a seguinte expressão:
code language-json jcr:content/metadata/dc:format!=application/xml
-
Clique em Salvar e fechar
Configurar o fluxo de trabalho XML de pós-processamento id18CJB03J0Y4
O AEM Guides cria vários workflows que permitem trabalhar com conteúdo DITA no AEM. Por exemplo, há fluxos de trabalho que são executados quando você faz upload de conteúdo DITA ou atualiza conteúdo existente. Esses workflows analisam documentos DITA e executam várias tarefas, como configurar os metadados, adicionar predefinições de saída padrão a novos mapas DITA e outras tarefas relacionadas.
As seguintes propriedades regulam como o AEM Guides executa os fluxos de trabalho de pós-processamento:
com.adobe.fmdita.postprocess.PostProcessObservation
com.adobe.fmdita.config.ConfigManager
O valor padrão é 1.