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
- Abra o aplicativo Resultados.
- Vá para a coleção e análise que contém a tabela que deseja atualizar.
- Para a tabela que você quer automatizar, clique no número na coluna Gatilhos.
- 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.
- 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
- Insira o nome para o gatilho na caixa de diálogo. O limite de caracteres é 255.
- Na área Condições, selecione Registro.
- Defina as opções que farão com que o gatilho seja executado:
Opção Descriçã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çãoAs 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.
- 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
.
- 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.
- 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.
- Na área Ações, defina as ações que ocorrerão quando o gatilho for executado:
Configuração Descrição Notas Atribuir > Usuários > Grupo de fluxo de trabalho Controla 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ário Identifica 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.
Notificar Envia uma notificação por e-mail para um ou mais usuários Quando 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.
Status Altera 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.
Prioridade Altera a prioridade de registros especificados - Na área Frequência, defina quando o gatilho será acionado:
Configuração Descrição Notas 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ário Avalia 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çãoCuidado 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
- 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çãoO 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.
- Para salvar a configuração do gatilho, selecione Salvar.
- 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
- Abra o aplicativo Resultados.
- Execute uma das seguintes ações:
- 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.
- 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
- Insira o nome para o gatilho na caixa de diálogo.
O limite de caracteres é 255.
- 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çãoVocê só pode selecionar uma métrica associada a uma Análise de Dados, Relatório de Eventos ou Pesquisa.
- 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.
- Opcional. Defina a cor do limite.
- 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.
- Na área Frequência, defina quando o gatilho será acionado:
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
- 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.
- Clique em Sair
para fechar a janela de configuração do gatilho.