Ação Aguardar mensagem

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Pause um fluxo até que ele receba uma mensagem específica da API de fluxo. Especifique a mensagem de cadeia de caracteres que retoma a execução do fluxo e, opcionalmente, forneça um valor de tempo limite para retomar o fluxo se nenhuma mensagem for recebida após um período específico.

    Funções e disponibilidade

    Disponível como uma ação principal de Workflow Studio ServiceNow. Usuários com a função flow_designer ou admin podem adicionar uma ação a um fluxo e definir detalhes de configuração.

    Entradas

    Forneça um valor para cada entrada necessária para sua ação. Para adicionar valores dinâmicos, você também pode arrastar cápsulas do painel Dados ou selecioná-las no seletor de cápsulas.

    Mensagem
    Tipo de dados: String

    A cadeia de caracteres de texto que o fluxo está aguardando para receber da API SendMessage(). A ação usa esta mensagem para retomar a execução do fluxo. Para obter mais informações sobre a API SendMessage(), consulte FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Habilitar tempo limite
    Tipo de dados: True/False
    Opção para limitar a quantidade de tempo que o fluxo aguarda a conclusão da ação antes de continuar.
    Nota:
    Use Habilitar tempo limite opção para ajudar a impedir que o fluxo aguarde infinitamente. Se a mensagem não for recebida, um valor de tempo limite especificará quando o sistema pode ignorar a ação Aguardar mensagem e ir para o próximo item no fluxo. Você deve definir um valor de duração para habilitar um tempo limite.
    Duração
    Tipo de dados: Duration

    Quantidade de tempo que o fluxo espera antes de continuar quando Habilitar tempo limite a opção está selecionada. Insira o tempo de espera em horas, minutos e segundos. Se você deixar este campo em branco, o fluxo não aguardará.

    Saídas

    Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em seu fluxo.

    Carga
    Tipo de dados: String

    Uma cadeia de caracteres de texto retornada pela API SendMessage(). O fluxo primário pode usar valores de carga como entradas para outras ações ou lógica de fluxo.

    Estado
    Tipo de dados: Choice
    O status de conclusão da ação como um valor numérico.
    • 0 (sucesso)
    • 1 (erro)

    Diretrizes gerais

    Use estas diretrizes gerais ao criar fluxos que aguardam por uma mensagem.
    Converta atividades em espera de evento de fluxo de trabalho usando esta ação
    Converta fluxos de trabalho clássicos que usam a atividade Aguardar evento WF em fluxos que usam a ação Aguardar mensagem. Você pode usar o nome do evento como o texto da mensagem que retoma o fluxo.
    Use o método SendMessage() para criar mensagens
    Crie mensagens para fluxos de espera usando o método SendMessage(). Se você quiser que o fluxo gere a mensagem para retomar a execução, crie uma ação personalizada com uma etapa de script para gerar a mensagem. Como alternativa, crie alguma lógica de script que seja executada fora do fluxo, como um evento para gerar a mensagem. Para obter mais informações sobre a API SendMessage(), consulte FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Aguarde a mensagem ser executada Voltar para a lógica de fluxo

    Detalhes da execução da ação Aguardar mensagem no estado Aguardando. As outras etapas do fluxo estão no estado Não Executar.

    Neste fluxo de exemplo, o estado de aprovação determina se a ação Aguardar mensagem deve ser executada. Se o estado de aprovação for Ignorado ou Rejeitado, o fluxo aguardará uma mensagem da API SendMessage() antes de continuar. Você pode usar esta lógica para corrigir uma solicitação de aprovação rejeitada e reenviá-la para aprovação.

    Neste exemplo, Fred Luddy rejeitou a aprovação e solicitou mais informações. Para retomar o fluxo, alguém precisa lidar com os comentários de Fred e executar a API SendMessage() para enviar a mensagem apropriada Retomar fluxo .

    Detalhes da execução da ação Aguardar mensagem no estado Concluído. A carga tem um valor de tempo de execução de reenviado para aprovação.

    Depois de corrigir a solicitação de mudança, alguém executou a API SendMessage() para enviar a mensagem Retomar fluxo E também enviam ao fluxo um valor de Carga de Reenviado para aprovação . Para obter mais informações sobre a API SendMessage(), consulte FlowAPI - sendMessage(String contextSysID, String message, String payload).

    Como o valor da mensagem da API correspondeu às condições da ação Aguardar mensagem, a execução do fluxo foi retomada. Nesse caso, o fluxo usou um bloco de lógica Voltar para fluxo para executar novamente a ação Solicitar aprovação.

    Fluxo de atividades de exemplo de um registro de mudança com o texto reenviado para aprovação.

    Este é o log de atividades da solicitação de mudança. O valor da carga Reenviado para aprovação foi adicionado ao Comentários adicionais campo.