Gatilhos

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Os gatilhos especificam quando começar a executar seu playbook.

    Em Playbooks, os gatilhos indicam quando o playbook deve começar a ser executado. Cada gatilho tem um tipo e condições que, quando atendidos, iniciam a execução do ativado playbook.

    Você pode escolher um gatilho ao criar um playbook em Workflow Studio. Comece adicionando um gatilho, que define o tipo de gatilho. Em seguida, defina condições e outras opções para refinar o gatilho para que ele seja disparado de uma forma que faça sentido para o seu processo de negócios. Para obter mais informações, consulte Criação de uma definição de processo.

    Se não houver gatilhos adequados ao seu caso de uso, você poderá criar sua própria definição de gatilho. Para obter mais informações, consulte Criação de uma definição de gatilho.

    Figura 1. Como os gatilhos funcionam
    Quando as condições especificadas no gatilho forem atendidas em qualquer lugar na Now Platform, seu automatizado playbook começará a ser executado.

    Tipos de gatilho

    No registro de definição de gatilho [sys_pd_trigger_definition], você pode escolher um tipo de gatilho, que determina quando o gatilho é disparado. Esses tipos de gatilho representam operações de registro que podem ocorrer no Now Platform®. Os seguintes tipos de gatilho estão disponíveis em sua instância por padrão:

    Registro Criado
    O playbook é executado quando um usuário cria um registro em qualquer lugar no Now Platform.
    Registro atualizado
    O playbook é executado quando um usuário atualiza um registro existente em qualquer lugar no Now Platform.
    Registro criado ou atualizado
    O playbook é executado quando um usuário cria um registro ou atualiza um registro existente em qualquer lugar no Now Platform.
    Nota:
    Os gatilhos são disparados somente para operações de registro interativas ou feitas por usuários. Os gatilhos não são disparados para operações de registro não interativas. Para obter mais informações, consulte Sessões não interativas.

    Condições para execução

    Depois de adicionar um gatilho ao playbook, você pode definir condições e outras opções que determinam quando e como o gatilho é disparado.

    Opção Ação
    Condições Use o Construtor de condições para criar condições de campo para quando playbook for executado. Consulte Construtor de condições.
    Executar meu processo Escolha uma opção para quando o seu playbook for executado. As opções incluem:
    • Uma vez: aciona o playbook uma vez durante a vida útil do registro de entrada de acionamento.
    • Para cada mudança exclusiva: aciona o playbook para cada atualização exclusiva em umcampo que não seja do sistema, mesmo se o fluxo estiver em execução. 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 mudar de Em andamento para Em espera, o playbook será executado. No entanto, se o campo Estado mudar novamente para Em andamento, o playbook não será executado.
      Nota:
      Playbooks que têm um gatilho que é executado para cada mudança exclusiva pode produzir recursões quando executado em uma sessão não interativa. Quando esses playbooks fazem uma mudança no registro do gatilho, a mudança atende às condições do gatilho de playbooke causa uma recursão.
    • Somente se não estiver em execução: aciona o playbook para cada mudança exclusiva se uma execução de processo não estiver em execução.
    • Para cada atualização: aciona o playbook sempre que o registro de entrada é atualizado, independentemente de já haver ou não haver execuções de processo em execução.
    Executar em estendido Selecione esta opção para acionar o playbook em tabelas que se estendem a partir da tabela selecionada. Por exemplo, se você habilitar esta opção e selecionar a tabela Item de configuração [cmdb_ci], seu playbook será executado quando ocorrerem operações de registro no servidor [cmdb_ci_server], no computador [cmdb_ci_computer] e em outras tabelas estendidas. Para obter mais informações, consulte Table extension and classes.

    Considerações de design

    Consulte estas considerações de design ao trabalhar com gatilhos:
    Criar condições de filtro exclusivas para gatilhos de registro na mesma tabela
    Para impedir que os playbooks se substituam, crie condições de filtro exclusivas para cada playbook que é executado na mesma tabela. Se vários playbooks na mesma tabela tiverem o mesmo filtro, não haverá como saber a ordem em que os playbooks serão executados.
    Evite duplicar gatilhos usados em Workflow Studio fluxos
    Os gatilhosPlaybooks não substituem os gatilhos Workflow Studio. Para ambas as aplicações, quando as condições do gatilho são atendidas, os processos automatizados são executados.
    Ignorar registros adicionados ou atualizados por conjuntos para importação e atualização
    Os gatilhos de registro ignoram os registros que foram adicionados ou atualizados aplicando um conjunto de atualizações ou importando um arquivo XML. Essas operações se aplicam à aplicação ou tabela inteira em vez de a um registro individual.