Sinal externo external-signal

Descrição description

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

Contexto de uso context-of-use

A atividade External signal é usada para organizar e orquestrar diferentes processos que fazem parte da mesma jornada do cliente para workflows diferentes. Ele permite iniciar um workflow a partir de outro, permitindo oferecer suporte a jornadas de clientes mais complexas, além de poder monitorar e reagir melhor em caso de problemas.

A atividade External signal foi projetada para ser colocada como a primeira atividade de um workflow. Ela pode ser acionado a partir da atividade End de outro workflow ou de uma chamada à API REST (para obter mais informações, consulte a documentação sobre APIs).

Quando acionados, os parâmetros externos podem ser definidos e estar disponíveis nas variáveis de eventos de workflow. O processo para chamar um workflow com parâmetros externos está detalhado nesta seção.

NOTE
A atividade não pode ser acionada com mais frequência do que a cada 10 minutos.

Observe que uma atividade External signal pode ser acionada a partir de vários eventos diferentes. Nesse caso, o evento External signal é acionado assim que um dos workflows de origem ou uma chamada à API é executada. Não é necessário que todos os workflows de origem sejam concluídos.

Tópicos relacionados

Configuração configuration

Ao configurar um sinal externo, é importante primeiro configurar a atividade External signal no workflow de destino. Quando essa configuração for concluída, a External signal atividade desse workflow ficará disponível para configurar a atividade End do workflow de origem.

  1. Arraste e solte uma atividade External signal no workflow de destino.

  2. Selecione e abra a atividade usando o botão das ações rápidas exibidas.

  3. Edite o rótulo da atividade. Esse rótulo é necessário ao configurar o workflow de origem que aciona External signal.

    Se quiser chamar o workflow com parâmetros, use a área Parameters para declará-los. Para obter mais informações, consulte esta página.

  4. Confirme a configuração da atividade, adicione qualquer outra atividade necessária e salve o workflow.

    note note
    NOTE
    Se quiser acionar o workflow de destino a partir de outro workflow, continue com as etapas a seguir. Se quiser acionar o workflow de destino a partir de uma chamada à API REST, consulte a documentação sobre APIs para obter mais detalhes.
  5. Abra o workflow de origem e selecione uma atividade End. Se não houver uma atividade End disponível, adicione uma após a última atividade de uma ramificação do workflow.

    Algumas atividades não têm transição de saída por padrão. Na guia Properties dessas atividades, é possível adicionar uma transição de saída.

    Por exemplo, em uma atividade Update data, acesse a guia Transitions e marque a opção Add an outbound transition without the population. Essa opção permite adicionar uma transição que não contém dados e não consome espaço desnecessário no sistema. Ela é usada apenas para conectar a atividade extra End, que aciona o workflow de destino.

  6. Na guia External signal da atividade End, selecione o workflow de destino, bem como a atividade External signal a ser acionada dentro desse workflow.

    Ao definir uma End atividade para acionar outro workflow, seu ícone é atualizado com um símbolo de sinal adicional.

    Se quiser chamar o workflow com parâmetros, use a área Parameters and values. Para obter mais informações, consulte esta página.

  7. Salve o workflow de origem.

Depois que a atividade End do workflow de origem ou da chamada à API REST for executada, o workflow de destino será automaticamente acionado a partir da atividade External signal.

NOTE
O workflow de destino deve ser iniciado manualmente antes de poder ser acionado. Quando iniciado, o External activity é ativado e aguarda o sinal do workflow de origem.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff