Show Menu
TÓPICOS×

Sinal externo

Descrição

A External signal atividade aciona um fluxo de trabalho quando algumas condições são atendidas com êxito em outro fluxo de trabalho ou a partir de uma chamada REST API.

Contexto de utilização

A External signal atividade é usada para organizar e orquestrar diferentes processos que fazem parte da mesma jornada do cliente em fluxos de trabalho diferentes. Ele permite iniciar um fluxo de trabalho a partir de outro, permitindo suportar jornadas de clientes mais complexas, ao mesmo tempo que pode monitorar e reagir melhor em caso de problema.
A External signal atividade é projetada para ser colocada como a primeira atividade de um fluxo de trabalho. Ele pode ser acionado a partir da End atividade de outro fluxo de trabalho ou de uma chamada REST API (para obter mais informações, consulte a documentação da API).
Quando acionados, os parâmetros externos podem ser definidos e estar disponíveis nas variáveis de eventos do fluxo de trabalho. O processo para chamar um fluxo de trabalho com parâmetros externos está detalhado nesta seção .
A atividade não pode ser acionada com mais frequência do que a cada 10 minutos.
Observe que uma External signal atividade pode ser acionada a partir de vários eventos diferentes. Nesse caso, o External signal é acionado assim que um dos fluxos de trabalho de origem ou uma chamada de API é executada. Não requer que todos os fluxos de trabalho de origem sejam concluídos.

Configuração

Ao configurar um sinal externo, é importante primeiro configurar a External signal atividade no fluxo de trabalho de destino. Quando essa configuração for concluída, a External signal atividade desse fluxo de trabalho ficará disponível para configurar a End atividade do fluxo de trabalho de origem.
  1. Arraste e solte uma External signal atividade em seu fluxo de trabalho de destino.
  2. Selecione a atividade e abra-a usando o botão das ações rápidas que aparecem.
  3. Edite o rótulo da atividade. Esse rótulo é necessário ao configurar o fluxo de trabalho de origem que aciona o External signal .
    Se você quiser chamar o fluxo de trabalho com parâmetros, use a Parameters área para declará-los. Para obter mais informações, consulte esta seção .
  4. Confirme a configuração de sua atividade, adicione qualquer outra atividade necessária e salve seu fluxo de trabalho.
    Se você quiser acionar o fluxo de trabalho de destino a partir de outro fluxo de trabalho, continue com as etapas a seguir. Se desejar acionar o fluxo de trabalho de destino a partir de uma chamada REST API, consulte a documentação da API para obter mais detalhes.
  5. Abra o fluxo de trabalho de origem e selecione uma End atividade. Se não houver nenhuma End atividade disponível, adicione uma após a última atividade de uma ramificação do fluxo de trabalho.
    Algumas atividades não têm nenhuma transição de saída por padrão. Na Properties guia dessas atividades, é possível adicionar uma transição de saída.
    Por exemplo, em uma Update data atividade, vá para a Transitions guia e marque a opção Add an outbound transition without the population . Essa opção permite adicionar uma transição que não contenha dados e não consuma espaço desnecessário no sistema. É usado apenas para conectar a atividade extra End que aciona o fluxo de trabalho de destino.
  6. Na External signal guia da End atividade, selecione o fluxo de trabalho de destino, bem como a External signal atividade a ser acionada dentro desse fluxo de trabalho.
    Quando você define uma End atividade para acionar outro fluxo de trabalho, seu ícone é atualizado com um símbolo de sinal adicional.
    Se você quiser chamar o fluxo de trabalho com parâmetros, use a Parameters and values área. Para obter mais informações, consulte esta seção .
  7. Salve o fluxo de trabalho de origem.
Depois que a End atividade do fluxo de trabalho de origem ou a chamada REST API é executada, o fluxo de trabalho de destino é automaticamente disparado da External signal atividade.
O fluxo de trabalho de destino deve ser iniciado manualmente antes de poder ser acionado. Quando iniciado, o External activity é ativado e aguarda o sinal do fluxo de trabalho de origem.

Exemplo

O exemplo a seguir ilustra a External signal atividade em um caso de uso típico. Uma importação de dados é executada em um fluxo de trabalho de origem. Quando a importação for concluída e o banco de dados for atualizado, um segundo fluxo de trabalho será acionado. Esse segundo fluxo de trabalho é usado para atualizar um agregado nos dados importados.
O fluxo de trabalho de origem é apresentado da seguinte maneira:
  • Uma atividade Carregar arquivo carrega um arquivo contendo novos dados de compra. Observe que o banco de dados foi estendido de acordo com esse procedimento, pois os dados de compra não estão presentes por padrão no datamart.
    Por exemplo:
    tcode;tdate;customer;product;tamount
    aze123;21/05/2015;dannymars@example.com;A2;799
    aze124;28/05/2015;dannymars@example.com;A7;8
    aze125;31/07/2015;john.smith@example.com;A7;8
    aze126;14/12/2015;john.smith@example.com;A10;4
    aze127;02/01/2016;dannymars@example.com;A3;79
    aze128;04/03/2016;clara.smith@example.com;A8;149
    
    
  • Uma atividade de Reconciliação cria os links entre os dados importados e o banco de dados para que os dados de transações sejam conectados corretamente aos perfis e produtos.
  • Uma atividade de dados Atualizar dados Update insere e atualiza o recurso Transações do banco de dados com os dados recebidos.
  • Uma End atividade aciona o fluxo de trabalho de destino, que é usado para atualizar agregados.
O fluxo de trabalho de destino é apresentado da seguinte forma:
  • Uma External signal atividade aguarda a conclusão com êxito do fluxo de trabalho de origem.
  • Uma atividade de Consulta direciona perfis e os enriquece com uma coleção definida para recuperar a data da última compra.
  • Uma atividade Atualizar dados armazena os dados adicionais em um campo personalizado dedicado. Observe que o recurso de perfil foi estendido para adicionar o campo Data da última compra.