Criar um gatilho

Crie gatilhos para automatizar o fluxo de trabalho da sua empresa definindo um conjunto de ações executadas automaticamente quando uma alteração específica ocorre. Gatilhos são associados com tabelas individuais e podem ser configurados para registrar alterações ou limites de métricas.

Observação

Somente Administradores, Gerentes Profissionais ou Usuários Profissionais do aplicativo Resultados podem criar e editar gatilhos.

Criar um gatilho em registros

Defina um conjunto de ações executadas automaticamente quando ocorrerem alterações nos registros. Você precisa criar a tabela contendo os registros antes de definir o gatilho.

Vá até a janela de configuração do gatilho

  1. Abra o aplicativo Resultados.
  2. Vá para a coleção e análise que contém a tabela que deseja atualizar.
  3. Para a tabela que você quer automatizar, clique no número na coluna Gatilhos.
  4. Opcional. Para editar a ordem de execução para vários gatilhos existentes, arraste cada gatilho até o local apropriado da lista. Os gatilhos são executados de cima para baixo na ordem especificada.
  5. Clique em Novo na caixa de diálogo Automatizar. A janela de configuração do gatilho é aberta.
    Observação

    Para editar um gatilho criado anteriormente, clique no nome dele.

Defina o gatilho

  1. Insira o nome para o gatilho na caixa de diálogo. O limite de caracteres é 255.
  2. Na área Condições, selecione Registro.
  3. Defina as opções que farão com que o gatilho seja executado:
    OpçãoDescrição
    Condição

    Executa o gatilho quando uma condição ou conjunto de condições definido é atendido.

    Você pode acionar em registros ociosos selecionando o campo Atualizado e usando uma data relativa, como há 1 dia. Registros ociosos são registros não alterados no sistema pelo menos durante o período especificado.

    Observação

    As condições do gatilho com base nos campos de datahora são avaliadas usando o fuso horário definido no seu perfil de usuário. Não especifique um deslocamento de fuso horário.

    Status

    Executa o gatilho quando um registro recebe um status particular Você pode especificar vários status.

    Você não pode combinar condições de status com novas frequências de registro em tempo real.

    Observação

    Resultados O administrador pode selecionar qualquer status disponível. Todos os outros usuários podem selecionar dentre qualquer status disponível na coleção, o que é determinado pelo fluxo de trabalho atribuído à coleção.

    Prioridade

    Executa o gatilho quando um registro recebe uma prioridade particular. Você pode especificar várias prioridades.

    Você não pode combinar condições de prioridade com novas frequências de registro em tempo real.

  4. Opcional. Para definir várias condições em um grupo, clique em + Adicionar e selecione a(s) condição(ões) apropriada(s) para definir. Para remover uma condição, clique no ícone lixeira .
  5. Opcional. Se você definiu várias condições, selecione TUDO para executar o gatilho apenas se todas as condições forem avaliadas como verdadeiras, ou selecione QUALQUER uma para executar o gatilho se pelo menos uma das condições for avaliada como verdadeira. Um único operador lógico ALL (AND) ou ANY (OR) se aplica a todas as expressões condicionais dentro do grupo. ALL é o padrão.
  6. Opcional. Para definir expressões condicionais usando vários grupos, clique em + Adicionar Grupo, especifique o operador lógico (E ou OU), e selecione a(s) condição(ões) apropriada(s) para definir. Todos os operadores lógicos fora do grupo devem ser iguais (todos AND ou todos OR). E é o padrão. Para remover um grupo, clique em Excluir Grupo.
  7. Na área Ações, defina as ações que ocorrerão quando o gatilho for executado:
    ConfiguraçãoDescriçãoNotas
    Atribuir > Usuários > Grupo de fluxo de trabalhoControla a visibilidade do registro

    Apenas membros do grupo de fluxo de trabalho designado podem analisar o registro. Se não houver grupo de fluxo de trabalho designado, todos os membros da Coleção com permissões suficientes podem ver o registro.

    Atribuir > Usuários > CessionárioIdentifica o indivíduo responsável pelo registro

    Somente usuários identificados como membros da coleção estão disponíveis para seleção na lista suspensa. Se um grupo de fluxo de trabalho for designado, a pessoa designada deve ser membro do grupo de fluxo de trabalho.

    Observação

    Use a opção Habilitar notificação para controlar se o responsável deve receber um e-mail quando esse gatilho atribuir um registro.

    Atribuir > E-mail do campo

    Atribui os registros a um e-mail de um campo na tabela se o endereço de e-mail pertencer a um usuário do Diligent One

    Os registros não são atribuídos se o endereço de e-mail do campo:

    • pertence a um usuário do aplicativo Resultados que não tem uma função na Coleção que permite a edição de registros
    • é inválido(a)
    • Observação

      A Plataforma Diligent One não aceita endereços de e-mail com acentos ou caracteres não latinos.

    Observação

    Use a opção Habilitar notificação para controlar se o responsável deve receber um e-mail quando esse gatilho atribuir um registro.

     

    Para atribuir registros, o endereço de e-mail precisa pertencer a um usuário do Diligent One.

    Atribuir > Grupo de fluxo de trabalho do campo

    Pesquisa o campo da tabela selecionada em busca de um nome de grupo de fluxo de trabalho e, se um nome de grupo de fluxo de trabalho válido for identificado, o registro será atribuído a esse grupo de fluxo de trabalho específico.

    Somente campos de dados importados e campos de questionário com tipo de dados de caractere estarão disponíveis para a seleção. Outros campos com outros tipos de dados estarão indisponíveis.

    Apenas membros do grupo de fluxo de trabalho designado podem analisar o registro.

    Se não houver grupo de fluxo de trabalho designado, todos os membros da Coleção com permissões suficientes podem ver o registro.

    Observação

    Use a opção Ativar notificação para controlar se os membros do grupo de fluxo de trabalho designado devem receber um e-mail quando esse gatilho atribuir um registro.

    NotificarEnvia uma notificação por e-mail para um ou mais usuáriosQuando você notifica um usuário, ele recebe um e-mail com um link para uma tabela que exibe todos os registros (não exclusivamente os registros sobre os quais ele foi notificado).
    Questionário

    Atribui um questionário a um dos seguintes:

    • usuário individual
    • endereço de e-mail especificado
    • um endereço de e-mail de uma coluna na tabela
    • Observação

      A Plataforma Diligent One não aceita endereços de e-mail com acentos ou caracteres não latinos.

    Há duas listas de questionários para escolher:

    • Vinculados questionários já vinculados à tabela (existe coluna de resposta)
    • Questionários não vinculados que não estão vinculados à tabela (colunas de resposta adicionadas quando a primeira resposta é enviada)

    Selecionar Use um questionário para responder a todos os registros para enviar o questionário ao destinatário e aplicar resposta a todos os registros incluídos na ação do gatilho. Não marque essa opção para registrar uma resposta diferente por registro.

    Observação

    Participantes com uma conta do Diligent One associada que forem membros da organização deverão fazer a autenticação ao clicar no link para responder à pesquisa.

    Observação

    Se você combinar ações do Questionário com a frequência do gatilho do registro Atualizado, os participantes receberão vários convites para responder ao questionário quando a resposta inicial causar uma atualização. Você pode evitar isso incluindo uma condição no gatilho que teste se uma questão obrigatória do questionário fica em branco ou não.

    StatusAltera o status de registros especificados

    Resultados O administrador pode selecionar entre todos os status disponíveis na coleção.

    Gerentes Profissionais e Usuários Profissionais somente podem selecionar status aos quais eles têm acesso.

    O acesso a status é definido pelos fluxos de trabalho. Para obter mais informações, consulte Criação de fluxos de trabalho no aplicativo Resultados.

    PrioridadeAltera a prioridade de registros especificados 
  8. Na área Frequência, defina quando o gatilho será acionado:
    ConfiguraçãoDescriçãoNotas
    Tempo real > Registro

    Avalia as condições do gatilho sempre que um registro é criado ou atualizado.

    Selecione Apenas para novos registros para executar o gatilho somente para os novos registros. Se você deixar essa configuração desmarcada, o gatilho será executado em registros novos e atualizados que correspondam às condições do gatilho.

    Quando um registro é considerado novo?

    O gatilho é executado quando um novo registro é publicado em uma análise de dados, relatório de eventos ou pesquisa no aplicativo Resultados.

    Quando um registro é considerado atualizado?

    O gatilho é executado quando qualquer alteração nas informações ou colunas de dados ocorre na tabela. Por exemplo, um status de registro é alterado ou uma resposta do questionário é enviada.

    Por padrão, os registros novos e atualizados são selecionados. No entanto, você pode escolher executar gatilhos exclusivamente em registros novos.

    Você não pode combinar condições de status, prioridade, pessoa designada ou grupo de fluxo de trabalho com novas frequências de registro em tempo real.

    Tempo real > QuestionárioAvalia as condições do gatilho sempre que o Diligent One recebe uma resposta ao questionário selecionado para a tabela desse gatilho.Você não pode combinar frequências de registro em tempo real e questionário.
    Agendamento

    Avalia as condições do gatilho com base em uma frequência especificada (diária, semanal, mensal, trimestral ou em um agendamento personalizado). Você também pode especificar a hora de executar o gatilho.

    Ao agendar um novo gatilho, o fuso horário padrão é o definido no seu perfil de usuário do Launchpad. Para obter mais informações, consulte Atualizar seu perfil.

    As mudanças de horário resultantes do horário de verão podem causar a execução de gatilhos durante a noite de maneira inesperada. Para obter mais informações, consulte Como o horário de verão afeta os gatilhos programados.
    Observação

    Cuidado para não corresponder as condições às frequências de maneira que um gatilho nunca possa ser executado. Por exemplo, se suas condições exigirem que os registros tenham sido atualizados há mais de um dia, mas você definir a frequência como tempo real > registros, o gatilho nunca será executado. Isso ocorre porque, sempre que um registro é criado ou modificado, ele foi atualizado há menos de um dia.

Salve ou execute o gatilho

  1. Execute uma das seguintes ações:
    • Para salvar a configuração do gatilho, selecione Salvar.

      O gatilho é salvo e listado na caixa de diálogo Automatizar.

    • Para salvar e visualizar a configuração do gatilho e para ter a opção de executar o gatilho imediatamente, selecione Salvar e Visualizar.

      Uma caixa de diálogo é exibida, listando uma amostra dos registros com os quais o gatilho será executado e realizará as ações definidas. Até 200 registros são exibidos na amostra. No entanto, o gatilho será executado com relação ao número total de registros afetados. Clique em Executar para executar o gatilho.

      Observação

      O tempo de intervalo entre o acontecimento de uma ação e a execução de um gatilho depende do tamanho da tabela. Tabelas pequenas (com aproximadamente 1000 registros) normalmente levam alguns segundos. Tabelas maiores podem levar até vários minutos.

  2. Clique em Sair para fechar a janela de configuração do gatilho.

Criar um gatilho em uma métrica

Notifique automaticamente um usuário do aplicativo Resultados quando uma métrica atingir um limite. Você deve criar a métrica antes de definir o gatilho.

Vá até a janela de configuração do gatilho

  1. Abra o aplicativo Resultados.
  2. Execute uma das seguintes ações:
    • Na página inicial de resultados:
      1. Vá para a coleção e análise que contém a tabela que deseja atualizar.
      2. Para a tabela que você quer automatizar, clique no número na coluna Gatilhos.
    • No painel Configurar Métrica, clique em Gerenciar Gatilhos.
  3. Opcional. Para editar a ordem de execução para vários gatilhos existentes, arraste cada gatilho até o local apropriado da lista. Os gatilhos são executados de cima para baixo na ordem especificada.
  4. Clique em Novo na caixa de diálogo. A janela de configuração do gatilho é aberta.
    Observação

    Para editar um gatilho criado anteriormente, clique no nome dele.

Defina o gatilho

  1. Insira o nome para o gatilho na caixa de diálogo.

    O limite de caracteres é 255.

  2. Na área Condições, selecione Métrica.

    Se você for até a janela de configuração do gatilho a partir do painel Configurar Métrica, essa opção é pré-selecionada automaticamente.

    Observação

    Você só pode selecionar uma métrica associada a uma Análise de Dados, Relatório de Eventos ou Pesquisa.

  3. Selecione a métrica apropriada e defina a condição e o valor que acionará o gatilho.

    Se você for até a janela de configuração do gatilho a partir do painel Configurar Métrica, a métrica é pré-selecionada automaticamente.

  4. Opcional. Defina a cor do limite.
  5. Na área Ações, especifique qual(is) usuário(s) deve(m) ser notificado(s) se a métrica atingir o limite definido.

    A opção Notificar é automaticamente selecionada. Quando você notifica um usuário, ele recebe um e-mail com um link para a métrica.

    Observação

    Se você não receber a notificação por e-mail, verifique seu filtro de spam ou pasta de lixo eletrônico.

  6. Na área Frequência, defina quando o gatilho será acionado:
  7. Configuração Descrição
    Tempo real > Registro

    Avalia as condições do gatilho sempre que um registro é criado ou atualizado.

    A caixa de seleção Somente para novos registros é desativada quando você cria gatilhos com base nas métricas. Esses tipos de gatilhos são executados quando os dados excedem o limite definido na condição.

    Agendamento

    Avalia as condições do gatilho com base em uma frequência especificada (diária, semanal, mensal, trimestral ou em um agendamento personalizado). Você também pode especificar a hora de executar o gatilho.

    Ao agendar um novo gatilho, o fuso horário padrão é o definido no seu perfil de usuário do Launchpad. Para obter mais informações, consulte Atualizar seu perfil. Ao editar um gatilho existente, o aplicativo Resultados lembra o fuso horário definido anteriormente.

    As mudanças de horário resultantes do horário de verão podem causar a execução de gatilhos durante a noite de maneira inesperada. Para obter mais informações, consulte Como o horário de verão afeta os gatilhos programados.

Salve o gatilho

  1. Para salvar a configuração do gatilho, selecione Salvar. O gatilho é salvo e listado na caixa de diálogo Automatizar.
    Observação

    O tempo de intervalo entre o acontecimento de uma ação e a execução de um gatilho depende do tamanho da tabela. Tabelas pequenas (com aproximadamente 1000 registros) normalmente levam alguns segundos. Tabelas maiores podem levar até vários minutos.

  2. Clique em Sair para fechar a janela de configuração do gatilho.