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.
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.
-
Arraste e solte uma atividade External signal no workflow de destino.
-
Selecione e abra a atividade usando o botão das ações rápidas exibidas.
-
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.
-
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. -
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.
-
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.
-
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.