Workflow Studio tipos de gatilho de fluxo

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 15 min. de leitura

    • Cada tipo de gatilho define quando um fluxo começa e os dados iniciais disponíveis para ele. Existem gatilhos para operações de registro, datas e operações de aplicação.​

    Gatilhos de registro

    Use gatilhos de registro para iniciar um fluxo quando um registro for criado ou atualizado.

    Gatilho Descrição
    Criação em Inicia um fluxo quando um registro é criado em uma tabela específica que não é do sistema.
    Nota:
    Alguns tipos de registro comuns, como solicitações, têm seus próprios gatilhos dedicados. Consulte os tipos de gatilho de aplicação para obter uma lista de registros de aplicações que têm gatilhos dedicados.
    Atualização em Inicia um fluxo quando um registro é atualizado em uma tabela específica que não é do sistema. É necessário selecionar quando executar o fluxo.
    • Para cada mudança exclusiva: aciona o fluxo para cada atualização exclusiva de um campo que não seja do sistema mesmo se o fluxo estiver em execução.
      Nota:
      O sistema armazena um histórico de todas as mudanças em um registro e determina se a mudança é exclusiva. Por exemplo, se o campo Estado de um registro de incidente for modificado de Em andamento para Em espera, o fluxo poderá ser executado. No entanto, se o campo Estado mudar novamente para Em andamento, o fluxo não poderá ser executado.
      Nota:
      Os fluxos que têm um gatilho de registro que é executado para cada mudança exclusiva podem produzir recursões quando executados em uma sessão não interativa. Quando este tipo de fluxo faz uma mudança no registro de gatilho, a mudança atende às condições de gatilho de fluxo e causa uma recursão.
    • Uma vez: aciona o fluxo uma vez durante a vida útil do registro.
    • Somente se não estiver em execução: aciona o fluxo para cada mudança exclusiva de registro se o fluxo não estiver em execução nesse registro no momento. Esse comportamento é igual à opção Sempre nas versões anteriores.
    • Para cada atualização: aciona o fluxo sempre que o registro é atualizado, não importa se já havia ou se há no momento contextos em execução para o fluxo.
    Criado ou atualizado Inicia um fluxo quando um registro é criado ou atualizado em uma tabela específica que não seja do sistema. É necessário selecionar quando executar o fluxo.
    • Para cada mudança exclusiva: aciona o fluxo para cada atualização exclusiva de um campo que não seja do sistema mesmo se o fluxo estiver em execução.
      Nota:
      O sistema armazena um histórico de todas as mudanças em um registro e determina se a mudança é exclusiva. Por exemplo, se o campo Estado de um registro de incidente for modificado de Em andamento para Em espera, o fluxo poderá ser executado. No entanto, se o campo Estado mudar novamente para Em andamento, o fluxo não poderá ser executado.
      Nota:
      Os fluxos que têm um gatilho de registro que é executado para cada mudança exclusiva podem produzir recursões quando executados em uma sessão não interativa. Quando este tipo de fluxo faz uma mudança no registro de gatilho, a mudança atende às condições de gatilho de fluxo e causa uma recursão.
    • Uma vez: aciona o fluxo uma vez durante a vida útil do registro.
    • Somente se não estiver em execução: aciona o fluxo para cada mudança exclusiva de registro se o fluxo não estiver em execução nesse registro no momento. Esse comportamento é igual à opção Sempre nas versões anteriores.
    • Para cada atualização: aciona o fluxo sempre que o registro é atualizado, não importa se já havia ou se há no momento contextos em execução para o fluxo.
    Nota:
    Os fluxos que incluem ações de aprovação só devem executar o gatilho uma vez. Nos casos em que você precisar atualizar e reenviar uma aprovação, considere usar um Volte para a lógica de fluxo para solicitar aprovação novamente.

    Gatilhos REST

    Use gatilhos REST para iniciar um fluxo após uma solicitação específica da REST API.

    Nota:
    Este recurso requer um IntegrationHub Assinatura empresarial. Para obter mais informações, consulte Request Integration Hub.
    Gatilho Descrição
    API REST - Assíncrono Inicie um fluxo a partir de uma chamada de API de entrada ou webhook de um sistema externo. Configure as condições de início do gatilho sem precisar escrever ou manter código personalizado. Para obter mais informações, consulte REST API .

    Gatilhos agendados

    Use gatilhos agendados para iniciar um fluxo após uma data e hora específicas ou repetidamente em intervalos agendados. Os gatilhos agendados usam o fuso horário da instância para determinar quando iniciar um fluxo.
    Nota:
    Como os fluxos são processados de forma assíncrona, um fluxo com um gatilho agendado pode não ser executado no horário agendado exato em que as condições do gatilho foram atendidas. Por exemplo, se um fluxo agendado for acionado durante o horário comercial principal, o sistema poderá ter que processar outros eventos na fila antes de executar o fluxo agendado.
    Gatilho Descrição
    Diariamente Inicia um fluxo em um horário específico todos os dias.
    Semanalmente Inicia um fluxo em um horário específico a cada semana.
    Mensalmente Inicia um fluxo em um horário específico todos os meses.
    Executar uma vez Inicia um fluxo uma vez em um horário específico, mas não se repete. Se você selecionar uma data ou hora passada, o sistema programará o fluxo para ser executado assim que possível.
    Repetir Inicia um fluxo em intervalos regulares definidos por você.

    Gatilhos da aplicação

    Use gatilhos de aplicação para iniciar um fluxo quando as condições específicas da aplicação forem atendidas.

    Gatilho Descrição
    Mensagem do Kafka Inicia um fluxo quando há uma mensagem em um tópico em seu ambiente Kafka. Para obter mais informações, consulte Crie um fluxo com um gatilho Mensagem Kafka.
    MetricBase Inicia um fluxo quando um MetricBase o gatilho foi atendido. Requer o. MetricBase aplicação. Para obter mais informações, consulte Crie um fluxo com um MetricBase gatilho.
    Análise proativa Inicia um fluxo quando a pontuação de KPI da Análise proativa ou os valores de limite de KPI são atendidos. Requer um Performance Analytics Assinatura da Análise proativa. Para obter mais informações, consulte Crie um fluxo com um gatilho de Análise proativa.
    Catálogo de serviços Inicia um fluxo de um Catálogo de serviços solicitação de item. Para obter mais informações, consulte Crie um fluxo com um Catálogo de serviços gatilho.
    Nota:
    Catálogo de serviços não são compatíveis com variáveis de catálogo como parte da condição do gatilho. Em vez disso, obtenha ou crie variáveis do catálogo no corpo principal do fluxo.
    Tarefa de ANS Inicia um fluxo a partir de um registro de definição de ANS. Para obter mais informações, consulte Criar um fluxo com um gatilho de Tarefa de ANS.

    Gatilhos de e-mail de entrada

    Inicie um fluxo quando sua instância receber um e-mail.

    Os fluxos de e-mail de entrada têm prioridade sobre as ações de e-mail de entrada. Se você criar fluxos com gatilhos de e-mail de entrada, os e-mails serão processados primeiro pelos gatilhos de e-mail de entrada antes de serem processados por ações de e-mail de entrada.

    Com ações de e-mail de entrada, você não tem controle total sobre o processamento de anexos de e-mail ou a atribuição do registro de destino de um e-mail. Ao criar um fluxo com um gatilho de e-mail de entrada, você pode executar essas ações com o. Ação Mover anexos de e-mail para registro e o. Associar registro à ação de e-mail. Para maior controle sobre anexos de e-mail, você também pode usar o. Ação Pesquisar anexos de e-mail para acessar um anexo específico como uma cápsula de dados.

    Embora você possa processar um e-mail de entrada com várias ações de e-mail de entrada, não é possível processar um e-mail de entrada com vários fluxos por padrão. É necessária uma configuração adicional. Para obter informações sobre como interromper o processamento em ações de e-mail de entrada, consulte Especificando a ordem de processamento de e-mails de entrada .

    Para obter mais informações sobre como executar vários fluxos em um e-mail de entrada, consulte Permitir que vários gatilhos processem um e-mail de entrada.

    O diagrama a seguir mostra como os e-mails de entrada são processados por gatilhos de e-mail de entrada. Após o e-mail ser classificado como resposta, encaminhamento ou novo e-mail, o sistema tenta corresponder o e-mail a um gatilho de e-mail de entrada ativo. Se o e-mail atender às condições de um gatilho de e-mail de entrada, o fluxo será executado. Se os problemas de fluxo pararem de processar, o processamento do e-mail será concluído. Se o fluxo não emitir interromper o processamento, o sistema avaliará as condições de mais gatilhos de e-mail de entrada. Se não houver mais gatilhos de e-mail de entrada para avaliar, o sistema tentará corresponder o e-mail a uma ação de e-mail de entrada ativa.

    Figura 1. Processando e-mails com gatilhos de e-mail de entrada
    Processando e-mails no gatilho E-mail de entrada
    Importante:
    Os fluxos de e-mail de entrada usam o remetente do e-mail como o usuário que inicia a sessão. Se o sistema não reconhecer o remetente, o fluxo de e-mail de entrada será executado como o usuário Convidado. Definir o fluxo de e-mail de entrada para ser executado como o usuário que inicia a sessão garante que as ações de fluxo sejam limitadas pelos controles de acesso do usuário. Se o usuário da iniciação precisar de privilégios elevados por algum motivo, faça com que o fluxo de e-mails de entrada chame um subfluxo que seja executado com as funções necessárias. Para testar os controles de acesso de um fluxo de e-mail de entrada, represente um usuário de e-mail de entrada típico e acione manualmente o fluxo.

    Gatilhos do spoke

    Os spokes podem ter gatilhos externos condicionais e orientados por eventos ou webhooks que começam a partir de aplicações de terceiros. Os webhooks atuam como gatilhos que fornecem os dados para um fluxo. Por exemplo, quando você cria um problema de nível P1 em uma aplicação de acompanhamento de ocorrências de terceiros, ele atualiza o registro do banco de dados de incidentes no ServiceNow instância. Para implementar este fluxo, siga estas etapas:
    1. Set up a flow
    2. Set up external trigger endpoints.

    Opções avançadas

    Especifique os requisitos de sessão do usuário necessários para iniciar um fluxo no Opções avançadas seção.
    Quando executar o fluxo

    Determine o tipo de sessão que pode acionar o fluxo, se o fluxo deve ser executado quando acionado por determinados usuários e quais tabelas podem acionar o fluxo.

    Tabela 1. Opções do menu suspenso da sessão interativa
    Opção Descrição
    Executar somente para sessão não interativa Fluxo acionado somente em sessões não interativas. Consulte Sessões não interativas .
    Executar somente para sessão interativa do usuário Fluxo acionado somente em sessões interativas.
    Executar para sessões interativas e não interativas Fluxo que é acionado em todas as sessões.
    Tabela 2. Opções do menu suspenso do usuário
    Opção Descrição
    Não executar se acionado pelos usuários a seguir Fluxo que não é acionado para uma lista selecionada de usuários. Selecione o ícone Adicionar usuário ( Ícone Adicionar usuário) para adicionar usuários à lista.
    Executar somente se acionado pelos usuários a seguir Fluxo que é acionado somente para uma lista selecionada de usuários. Selecione o ícone Adicionar usuário ( Ícone Adicionar usuário) para adicionar usuários à lista.
    Executar para qualquer usuário Fluxo que é executado para qualquer usuário.
    Tabela 3. Opções do menu suspenso de tabela
    Opção Descrição
    Executar somente na tabela atual Fluxo acionado somente para a tabela selecionada.
    Executar nas tabelas atuais e estendidas Fluxo acionado para a tabela selecionada e todas as tabelas estendidas.
    Onde executar o fluxo

    Determine se o fluxo deve ser executado em segundo plano ou na sessão atual.

    Opção Descrição
    Executar fluxo em segundo plano (padrão) Fluxo executado de forma assíncrona em segundo plano. Use esta opção para fluxos que não exigem atualizações imediatas e para permitir que outros processos do sistema sejam executados ao mesmo tempo.
    Executar fluxo em primeiro plano Fluxo que é executado de forma síncrona na sessão atual. Use esta opção para fornecer atualizações imediatas a um usuário final. Por exemplo, se um fluxo abrir uma tarefa após o encerramento da tarefa anterior, use esta opção para abrir a próxima tarefa imediatamente após um usuário fechar uma.
    Nota:
    A execução de um fluxo em primeiro plano pode bloquear o thread da sessão atual e impedir a entrada do usuário até que o fluxo seja concluído. Evite executar fluxos em primeiro plano quando eles contiverem ações que não podem ser interrompidas, como ações que executam script. Ações ou lógica de fluxo que pausam um fluxo não bloquearão uma sessão.

    Cápsulas de dados disponíveis por tipo de gatilho

    Os designers de fluxo têm acesso a cápsulas de dados do gatilho.

    Tipo de gatilho Cápsulas de dados disponíveis
    Registro
    [Rótulo da tabela] Registro
    Um objeto que contém o registro de acionamento.
    Campos Mudados
    Uma matriz de objetos que contém os valores de campo que foram alterados. Esta cápsula de dados só está disponível para o. Atualizado ou Criado ou Atualizado tipos de gatilho.
    Nota:
    Para processar o. Campos alterados pílula de dados de matriz, você precisará usar Para cada lógica de fluxo . Para obter mais informações sobre como trabalhar com cápsulas de dados de matriz, consulte Dados complexos.
    [Rótulo da tabela] Tabela
    O SYS ID da tabela que contém o registro do gatilho.
    Executar Datas/horários de início
    Objeto de data/hora que armazena quando o fluxo começou no fuso horário local do sistema. Use esta cápsula de dados para passar um valor de data/hora para outras ações e etapas, como a ação Criar registro ou Atualizar registro.
    Executar horários de início UTC
    Cadeia de caracteres de data/hora que armazena quando o fluxo começou no Tempo universal coordenado (UTC). Use esta cápsula de dados para passar dados para fluxos legados que esperam cadeias de caracteres de data/hora UTC.
    API REST - Assíncrono
    Parâmetros de caminho
    Um objeto que contém parâmetros de caminho na solicitação de entrada.
    Parâmetros de Consulta
    Um objeto que contém parâmetros de consulta na solicitação de entrada.
    Solicitar Cabeçalhos
    Um objeto que contém cabeçalhos na solicitação de entrada.
    Corpo da Solicitação
    Objeto de dados complexo que define a estrutura do corpo da solicitação de entrada. Para obter mais informações sobre objetos complexos, consulte Dados complexos.
    Data
    Executar Datas/horários de início
    Objeto de data/hora que armazena quando o fluxo começou no fuso horário local do sistema. Use esta cápsula de dados para passar um valor de data/hora para outras ações e etapas, como a ação Criar registro ou Atualizar registro.
    Executar horários de início UTC
    Cadeia de caracteres de data/hora que armazena quando o fluxo começou no Tempo universal coordenado (UTC). Use esta cápsula de dados para passar dados para fluxos legados que esperam cadeias de caracteres de data/hora UTC.
    Tarefa de ANS
    Registro de ANS de tarefa
    Um objeto que contém o registro ANS da tarefa de acionamento.
    sla_flow_inputs
    Um objeto que contém valores de definição de ANS de tarefa.
    E-mail de Entrada
    Registro de E-mail
    Um objeto que contém o registro de E-mail de acionamento.
    [Rótulo da tabela] Tabela
    O SYS ID da tabela associada ao e-mail de destino.
    Corpo do texto
    Uma cadeia de caracteres que contém o corpo da mensagem de e-mail.
    Assunto
    Uma cadeia de caracteres que contém o assunto da mensagem de e-mail.
    Registro do usuário
    Um objeto que contém o usuário que enviou o e-mail de acionamento. Se o remetente não tiver um registro de usuário associado, a cápsula de dados listará o objeto para o usuário Convidado.
    Endereço de origem
    Uma cadeia de caracteres que contém o endereço de e-mail do remetente.
    Base de métrica
    Registro de definição de gatilho do MetricBase
    Um objeto que contém o registro de definição de gatilho MetricBase de acionamento.
    Nível
    O valor inteiro do nível do gatilho MetricBase.
    Hora do Evento de Métrica
    O valor de data/hora de quando o evento de métrica ocorreu.
    Registro
    Um objeto que contém o registro para o qual os eventos de métrica foram coletados.
    Catálogo de serviços
    Registro de item solicitado
    Um objeto que contém o registro de item solicitado de acionamento.
    Executar Datas/horários de início
    Objeto de data/hora que armazena quando o fluxo começou no fuso horário local do sistema. Use esta cápsula de dados para passar um valor de data/hora para outras ações e etapas, como a ação Criar registro ou Atualizar registro.
    Executar horários de início UTC
    Cadeia de caracteres de data/hora que armazena quando o fluxo começou no Tempo universal coordenado (UTC). Use esta cápsula de dados para passar dados para fluxos legados que esperam cadeias de caracteres de data/hora UTC.
    Nome da tabela
    O nome da tabela que contém o item do catálogo solicitado.
    Mensagem do Kafka
    Mensagens
    Uma matriz de objetos que contém as mensagens recebidas do tópico Kafka. Cada mensagem tem as cápsulas de dados a seguir.
    • Cabeçalhos: Uma matriz de cabeçalhos, com cada cabeçalho contendo uma chave e um valor. O par Chave-Valor fornece informações adicionais sobre a mensagem. A Chave e o Valor são cadeias de caracteres.
    • Carga: Uma cadeia de caracteres que contém o texto da mensagem.
    • Chave: Uma chave que identifica a ordem de inserção da mensagem. As mensagens com a mesma chave são processadas em ordem.

    Diretrizes gerais

    Siga estas diretrizes gerais ao criar gatilhos de registro.

    Determine se o fluxo precisa de um gatilho ou entrada de variável
    Os fluxos sempre são executados quando as condições do gatilho são atendidas. Os gatilhos sempre fornecem os mesmos dados que a entrada para fluxos. Se você precisar de entrada de variável para iniciar um fluxo, crie um subfluxo .
    Adicione condições para especificar quais valores de registro iniciam seu fluxo
    Iniciar um fluxo somente quando necessário consome menos recursos do sistema do que iniciar um fluxo, pausá-lo e aguardar para retomar o fluxo até que uma condição de registro específica se aplique. Em vez de criar um fluxo que começa com uma ação Aguardar condição, redesenhe o fluxo para incluir a condição de espera como parte do gatilho de registro.
    Crie condições exclusivas para gatilhos de registro na mesma tabela
    Para evitar que os fluxos se substituam, crie condições exclusivas para cada fluxo em execução na mesma tabela. Se vários fluxos na mesma tabela tiverem as mesmas condições de filtro, não há como saber a ordem em que os fluxos são executados. O uso de condições também ajuda a otimizar o desempenho do fluxo, retornando um conjunto de registros mais preciso e menor.
    Ignorar registros adicionados ou atualizados por conjuntos de importação e atualização
    Os gatilhos de registro ignoram registros adicionados ou atualizados aplicando um conjunto de atualizações ou importando um arquivo XML. Essas operações se aplicam a toda a aplicação ou tabela em vez de um registro individual.
    Substitua gatilhos de registro nas tabelas do Catálogo de serviços por gatilhos da aplicação Catálogo de serviços
    O Designer de fluxo não exibe mais tabelas do Catálogo de serviços como opções para gatilhos de registro. Em vez disso, crie fluxos que usam o tipo de gatilho da aplicação Catálogo de serviços.
    Verifique se os usuários que acionam um fluxo têm acesso para acionar dados de condição
    Como os fluxos normalmente são executados como o usuário que os aciona, verifique se os usuários têm acesso a todos os dados especificados nas condições do gatilho. Evite criar condições de gatilho para tabelas relacionadas às quais usuários comuns não têm acesso. Se as condições do gatilho de fluxo exigirem acesso a dados restritos por função, execute seus fluxos com a função necessária para acessar esses dados.