Show Menu
TÓPICOS×

Execução de um fluxo de trabalho

Sobre a execução do fluxo de trabalho

Um workflow é sempre iniciado manualmente. No entanto, uma vez iniciado, ele pode permanecer inativo, dependendo das informações especificadas em uma atividade do Agendador .
A Adobe recomenda que os clientes priorizem execuções de fluxo de trabalho e executem até 20 execuções simultâneas de fluxo de trabalho para atingir de forma consistente o desempenho máximo em sua instância. Mais de vinte execuções de fluxo de trabalho simultâneas podem ser planejadas e serão executadas sequencialmente por padrão. Você pode ajustar as configurações padrão para o número máximo de execuções simultâneas de fluxo de trabalho enviando um ticket para o Atendimento ao cliente.
Ações relacionadas à execução (iniciar, parar, pausar etc.) são processos assíncronos : o comando é salvo e entrará em vigor assim que o servidor estiver disponível para aplicá-lo.
Em um fluxo de trabalho, o resultado de cada atividade geralmente é enviado para a seguinte atividade por meio de uma transição, representada por uma seta.
Uma transição não será encerrada se não estiver vinculada a uma atividade de destino.
Um fluxo de trabalho que contém transições não terminadas ainda pode ser executado: uma mensagem de aviso será gerada e o fluxo de trabalho pausará assim que chegar à transição, mas isso não gerará um erro. Você também pode iniciar um fluxo de trabalho sem ter concluído completamente o design e pode concluí-lo conforme progride.
Depois que uma atividade é executada, o número de registros enviados na transição é exibido acima dela.
Você pode abrir transições para verificar se os dados enviados estão corretos durante ou após a execução do fluxo de trabalho. É possível exibir os dados e a estrutura de dados.
Por padrão, somente os detalhes da última transição do fluxo de trabalho podem ser acessados. Para poder acessar os resultados das atividades anteriores, é necessário verificar a opção Keep interim results na seção Execution das propriedades do fluxo de trabalho antes de iniciar o fluxo de trabalho.
Essa opção consome muita memória e foi projetada para ajudar a construir um fluxo de trabalho e garantir que ele esteja configurado e se comportando corretamente. Deixe-o desmarcado em instâncias de produção.
Quando uma transição estiver aberta, você poderá editar sua transição Label ou vincular uma Segment code a ela. Para fazer isso, edite os campos correspondentes e confirme suas modificações.

Controle de um fluxo de trabalho da REST API

Usando a REST API, você pode iniciar , pausar , retomar e parar um fluxo de trabalho.
Você pode encontrar mais detalhes e exemplos de chamadas REST na documentação da API.

Ciclo de vida

O ciclo de vida de um fluxo de trabalho inclui três etapas principais e cada etapa está vinculada a um status e a uma cor:
  • Edição (cinza)
    Esta é a fase de design inicial de um fluxo de trabalho (consulte Criação de um fluxo de trabalho ). O fluxo de trabalho ainda não é manipulado pelo servidor e pode ser modificado sem nenhum risco.
  • Em andamento (azul)
    Quando a fase de design inicial estiver concluída, o fluxo de trabalho poderá ser iniciado e será manipulado pelo servidor.
  • Concluído (verde)
    Um fluxo de trabalho é concluído quando não há mais nenhuma tarefa em andamento ou quando um operador parou explicitamente a instância.
Depois de iniciado, um fluxo de trabalho também pode ter dois outros status:
  • Aviso (amarelo)
    O fluxo de trabalho não pôde ser concluído ou foi pausado usando os botões ou .
  • Errado (vermelho)
    Ocorreu um erro quando um fluxo de trabalho foi executado. O fluxo de trabalho foi interrompido e o usuário deve executar uma ação. Para saber mais sobre esse erro, use o botão para acessar o log do fluxo de trabalho (consulte Monitoramento ).
A lista de atividades de marketing permite que você exiba todos os fluxos de trabalho e seus status. Para obter mais informações, consulte Gerenciamento de atividades de marketing.

Comandos de execução

Os ícones na barra de ações permitem iniciar, rastrear e modificar a execução de um fluxo de trabalho. Consulte Barra de ação .
As opções disponíveis são as seguintes:
Início
O botão inicia a execução de um fluxo de trabalho, que assume o status Em andamento (azul). Se o fluxo de trabalho foi pausado, ele será retomado, caso contrário, ele será iniciado e as atividades iniciais serão ativadas.
O início é um processo assíncrono: a solicitação é salva e será processada o mais rápido possível pelo mecanismo de execução do fluxo de trabalho.
Pausar
O botão pausa a execução. O fluxo de trabalho assume o status Aviso (amarelo). Nenhuma nova atividade será ativada até que seja retomada, mas as operações em andamento não serão suspensas.
Parar
O botão para um fluxo de trabalho que está sendo executado, que assumirá o status Concluído (verde). As operações em andamento são interrompidas, se possível, e as importações ou consultas SQL em andamento são imediatamente canceladas. Não é possível retomar do fluxo de trabalho a partir do mesmo local em que ele foi interrompido.
Reiniciar
O botão envolve parar e reiniciar um fluxo de trabalho. Na maioria dos casos, isso permite reiniciar mais rapidamente. Também pode ser útil automatizar a reinicialização depois que a interrupção levar um determinado tempo, pois o botão só estará disponível quando a interrupção for efetiva.
Quando uma ou várias atividades em um fluxo de trabalho são selecionadas, há outras ações que você pode realizar, como:
Execução imediata
O botão inicia quaisquer atividades pendentes selecionadas o mais rápido possível.
Execução normal
O botão reativa todas as atividades pausadas ou desativadas.
Execução suspensa
O botão pausa o fluxo de trabalho na atividade selecionada: esta tarefa, bem como todos os que a sucedem (na mesma ramificação) não são executados.
Nenhuma execução
O botão desativa quaisquer atividades selecionadas.
As ações rápidas permitem que você acesse ações diferentes referentes a uma atividade específica e apareçam quando uma atividade é selecionada.

Monitoramento

O ícone abre o log do fluxo de trabalho e o menu de tarefas.
O histórico do fluxo de trabalho é salvo pela duração especificada nas opções de execução do fluxo de trabalho (consulte as propriedades do fluxo de trabalho). Durante esse período, todas as mensagens são salvas, mesmo após uma reinicialização. Se você não quiser salvar as mensagens de uma execução anterior, é necessário limpar o histórico clicando no botão.
A Log guia contém o histórico de execução de todas as atividades ou atividades selecionadas. Indica as operações efetuadas e os erros de execução por ordem cronológica.
A Tasks guia detalha a sequência de execução das atividades. Clique em uma tarefa para obter mais informações.
Nestas duas listas:
  • Clique no contador para ver o número total de atividades de acordo com o filtro aplicado. O contador é exibido por padrão se o número de elementos na lista for menor que 30.
  • O Configure list botão permite escolher as informações exibidas, definir a ordem das colunas e classificar a lista.
  • Você pode usar filtros para encontrar as informações de que precisa mais rapidamente. Use o campo de pesquisa para procurar um texto específico nos nomes das atividades do fluxo de trabalho (por exemplo: "query") e registros.

Gerenciamento de erros

Quando ocorre um erro, o fluxo de trabalho é pausado e a atividade que estava sendo executada quando o erro foi encontrado pisca em vermelho.
O status do fluxo de trabalho fica vermelho e o erro é registrado no registro.
Você pode configurar o fluxo de trabalho para que ele não pause e continue a execução sem erros. Para fazer isso, vá para as propriedades do fluxo de trabalho por meio do botão e, na Execution seção, selecione a opção Ignorar no campo Em caso de erro .
Nesse caso, a tarefa errada é abortada. Esse modo é especialmente adequado para fluxos de trabalho projetados para tentar a operação novamente mais tarde (ações periódicas).
Você pode aplicar essa configuração individualmente para cada atividade. Para fazer isso, selecione uma atividade e abra-a usando a ação rápida . Em seguida, selecione o modo de gerenciamento de erros na guia Opções de execução. Consulte Opções de execução da atividade.
A Execution seção das propriedades do fluxo de trabalho também permite que você defina uma série de Consecutive errors itens autorizados antes da execução do fluxo de trabalho ser suspensa automaticamente. Enquanto esse número não for atingido, os elementos errados serão ignorados e as outras ramificações do fluxo de trabalho serão executadas normalmente. Se esse número for atingido, o fluxo de trabalho será suspenso e os supervisores do fluxo de trabalho serão notificados automaticamente (notificação por email e no aplicativo). Consulte Propriedades do fluxo de trabalho e notificações do Adobe Campaign.
Os supervisores também podem ser definidos nas propriedades de execução do fluxo de trabalho.

Propriedades do workflow

Para modificar as opções de execução de um fluxo de trabalho, use o botão para acessar as propriedades do fluxo de trabalho e selecione a Execution seção.
O Default affinity campo permite forçar a execução de um fluxo de trabalho ou de uma atividade de fluxo de trabalho em uma máquina específica.
No History in days campo, especifique a duração após a qual o histórico deve ser expurgado.
Você pode optar por marcar as opções Save SQL queries in the log e Execute in the engine (do not use in production) , se necessário.
Marque a Keep interim results opção se desejar visualizar os detalhes das transições. Aviso: verificar essa opção pode retardar significativamente a execução do fluxo de trabalho.
O Severity campo permite especificar um nível de prioridade para executar fluxos de trabalho na instância do Adobe Campaign. Os fluxos de trabalho críticos serão executados primeiro.
O Supervisors campo é onde você pode definir o grupo de pessoas a serem notificadas (notificação por email e no aplicativo) se o fluxo de trabalho encontrar um erro. Se nenhum grupo for definido, ninguém será notificado. Para obter mais informações sobre notificações do Adobe Campaign, consulte notificações do Adobe Campaign.
O In case of error campo permite especificar a ação a ser executada caso a atividade encontre um erro. Há duas opções disponíveis para isso:
  • Suspenda o processo : o fluxo de trabalho é suspenso automaticamente. O status do fluxo de trabalho é então Errado e a cor associada fica vermelha. Depois que o problema for resolvido, reinicie o fluxo de trabalho.
  • Ignorar : a atividade não é executada e, como resultado, nenhuma das atividades a seguir (no mesmo ramo). Isso pode ser útil para tarefas recorrentes. Se a ramificação tiver um programador colocado em upstream, isso deverá ser acionado na próxima data de execução.
    Ao selecionar essa opção, você também pode definir um número de Consecutive errors autorizados:
    • Se o número especificado for 0 , ou enquanto o número especificado não for atingido, as atividades que encontram erros serão ignoradas. As outras ramificações de fluxo de trabalho são executadas normalmente.
    • Se o número especificado for atingido, todo o fluxo de trabalho será suspenso e se tornará Erroneous . Se os supervisores tiverem sido definidos, eles serão automaticamente notificados por email.

Propriedades da atividade

Propriedades gerais de uma atividade

Cada atividade tem uma Properties guia. Essa guia permite modificar os parâmetros gerais da atividade, especialmente o rótulo e a ID. Configurar essa guia é opcional.

Gerenciando as transições de saída de uma atividade

Por padrão, certas atividades não têm uma transição de saída. Você pode adicionar um da Transitions guia ou da Properties guia da atividade para aplicar outros processos à sua população no mesmo fluxo de trabalho.
Dependendo das atividades, você pode adicionar vários tipos de transições de saída:
  • Transição padrão: população calculada pela atividade
  • Transição sem população: esse tipo de transição de saída pode ser adicionado para continuar o fluxo de trabalho e não contém nenhuma população para não consumir nenhum espaço desnecessário no sistema.
  • Rejeita: população rejeitada. Por exemplo, se os dados de entrada da atividade não puderam ser processados porque estavam incorretos ou incompletos.
  • Complemento: população restante após a execução da atividade. Por exemplo, se uma atividade de segmentação estiver configurada para salvar apenas uma porcentagem da população de entrada.
Se aplicável, especifique um Segment code para a transição de saída da atividade. Esse código de segmento permitirá identificar de onde vêm os subconjuntos da população-alvo e poderá, posteriormente, servir para fins de personalização de mensagens.

Opções de execução da atividade

Na tela de propriedades da atividade, há uma Advanced options guia que permite definir o modo de execução e o comportamento da atividade em caso de erros.
Para acessar essas opções, selecione uma atividade em um fluxo de trabalho e abra-a usando o botão na barra de ações.
O Execution campo permite definir a ação a ser executada quando a tarefa for iniciada. Há três opções para isso:
  • Normal : a atividade é executada normalmente.
  • Habilitar, mas não executar : a atividade é pausada e, consequentemente, qualquer processo futuro que se suceda. Isso pode ser útil se você quiser estar presente quando a tarefa for iniciada.
  • Não ativar : a atividade não é executada e, consequentemente, nem todas as atividades subsequentes (no mesmo ramo).
O In case of error campo permite especificar a ação a ser executada caso a atividade encontre um erro. Há duas opções disponíveis para isso:
  • Suspenda o processo : o fluxo de trabalho é suspenso automaticamente. O status do fluxo de trabalho é então Errado e a cor associada fica vermelha. Depois que o problema for resolvido, reinicie o fluxo de trabalho.
  • Ignorar : a atividade não é executada e, como resultado, nenhuma das atividades a seguir (no mesmo ramo). Isso pode ser útil para tarefas recorrentes. Se a ramificação tiver um programador colocado em upstream, isso deverá ser acionado na próxima data de execução.
O Behavior campo permite definir o procedimento a ser seguido se tarefas assíncronas forem usadas. Há duas opções disponíveis para isso:
  • Várias tarefas autorizadas : várias tarefas podem ser executadas ao mesmo tempo, mesmo que a primeira não tenha sido concluída.
  • A tarefa atual tem prioridade : quando uma tarefa estiver em andamento, isso terá prioridade. Enquanto uma tarefa estiver em andamento, nenhuma outra tarefa será executada.
O Max. execution duration campo permite especificar uma duração, como "30s" ou "1h". Se a atividade não for concluída depois que a duração especificada tiver expirado, um alerta será acionado. Isso não afeta o funcionamento do fluxo de trabalho.
O Affinity campo permite forçar a execução de um fluxo de trabalho ou de uma atividade de fluxo de trabalho em uma máquina específica. Para fazer isso, você deve especificar uma ou várias afinidades para o fluxo de trabalho ou atividade em questão.
O Time zone campo permite selecionar o fuso horário da atividade. O Adobe Campaign permite gerenciar as diferenças de tempo entre vários países na mesma instância. A configuração aplicada é configurada quando a instância é criada.
O campo Comentário é um campo gratuito que permite adicionar uma observação.