Creare un trigger

Creare trigger per automatizzare il flusso di lavoro della propria azienda, definendo una serie di azioni da eseguire automaticamente quando avviene una modifica specifica. I trigger sono associati a singole tabelle e possono essere configurati per le modifiche dei record o per le soglie di metrica.

Creare un trigger sui record

Definire una serie di azioni che vengono eseguite automaticamente quando si verificano modifiche ai record. È necessario creare la tabella che contiene i record prima di definire il trigger.

Andare alla finestra di configurazione del trigger

1. Apri l'applicazione Risultati.
2. Navigare alla raccolta e all'analisi che contiene la tabella che si desidera eliminare.
3. Per la tabella da automatizzare, fare clic sul numero nella colonna Trigger.
4. Facoltativo. Per modificare l'ordine di esecuzione per più trigger esistenti, trascinare ogni trigger nella posizione appropriata nell'elenco. I trigger vengono eseguiti dall'alto verso il basso nell'ordine specificato.
5. Fare clic su Nuovo nella finestra di dialogo Automatizza. Si apre la finestra di configurazione del trigger.
   Nota

   Per modificare un trigger creato in precedenza, fare clic sul nome del trigger.

Definire il trigger

1. Inserisci il nome del trigger nella casella di testo. Il limite di caratteri è 255.
2. Nell'area Condizioni, seleziona Record.
3. Definire le opzioni che causeranno l'esecuzione del trigger:

   Opzione	Descrizione
   Condizione	Il trigger viene eseguito quando viene soddisfatta una condizione o un insieme di condizioni definite. È possibile eseguire il trigger su record inattivi selezionando il campo Aggiornato e utilizzando una data correlata, per esempio 1 giorno fa. I record inattivi sono record che non sono stati modificati nel sistema per almeno il periodo di tempo specificato. Nota Le condizioni del trigger basate sui campi data/ora vengono valutate utilizzando il fuso orario impostato nel profilo utente. Non specificare un offset di fuso orario.
   Stato	Il trigger vien eseguito quando a un record viene assegnato uno stato particolare. È possibile specificare più stati. Non è possibile combinare le condizioni di stato con le frequenze dei nuovi record in tempo reale. Nota L'amministratore di Risultati può selezionare da qualsiasi stato disponibile. Tutti gli altri utenti possono selezionare da qualsiasi stato disponibile nella raccolta, che è determinato dal flusso di lavoro assegnato alla raccolta.
   Priorità	Il trigger viene eseguito quando a un record viene assegnata una priorità specifica. È possibile specificare più priorità. Non è possibile combinare le condizioni di priorità con le frequenze dei nuovi record in tempo reale.

4. Facoltativo. Per definire più condizioni all'interno di un gruppo, fare clic su + Aggiungi e selezionare le condizioni appropriate da definire. Per rimuovere una condizione, fare clic sul cestino .
5. Facoltativo. Se sono state definite più condizioni, selezionare TUTTE per eseguire il trigger solo se tutte le condizioni nel gruppo vengono valutate come vere oppure selezionare QUALSIASI per eseguire il trigger se almeno una delle condizioni nel gruppo viene valutata come vera. Un singolo operatore logico TUTTE (AND) o QUALSIASI (OR) si applica a tutte le espressioni condizionali all'interno del gruppo. TUTTE è l'impostazione predefinita.
6. Facoltativo. Per definire espressioni condizionali utilizzando più gruppi, fare clic su + Aggiungi gruppo, specificare l'operatore logico (AND o OR) e selezionare le condizioni appropriate da definire. Tutti gli operatori logici al di fuori del gruppo devono essere uguali (tutti AND o tutti OR). E è selezionato per impostazione predefinita. Per rimuovere un gruppo, fare clic su Elimina gruppo.
7. Nell'area Azioni, definire le azioni che si verificheranno quando il trigger viene eseguito:

   Impostazione	Descrizione	Note
   Assegna > Utenti > Gruppo del workflow	Consente di controllare la visibilità del record	Solo i membri del gruppo del workflow assegnato possono rivedere il record. Se non viene assegnato alcun gruppo del workflow, tutti i Membri della raccolta con autorizzazioni sufficienti possono vedere il record.
   Assegna > Utenti > Assegnatario	Identifica la persona responsabile del record.	Solo gli utenti identificati come Membri della raccolta sono disponibili per la selezione nell'elenco a discesa. Se viene assegnato un gruppo del workflow, l'assegnatario deve essere un membro del gruppo del workflow stesso. Nota Utilizzare l'interruttore Abilita notifiche per controllare se l'assegnatario deve ricevere un'e-mail quando questo trigger gli assegna un record.
   Assegna > E-mail dal campo	I record vengono assegnati a un'e-mail da un campo della tabella se l'indirizzo e-mail appartiene a un utente Diligent One.	I record non vengono assegnati se l'indirizzo e-mail dal campo: appartiene a un utente dell'applicazione Risultati che non ha un ruolo nella Raccolta che consenta la modifica dei record non è valido Nota La piattaforma Diligent One non supporta gli indirizzi e-mail con accenti o caratteri non latini. Nota Utilizzare l'interruttore Abilita notifiche per controllare se l'assegnatario deve ricevere un'e-mail quando questo trigger gli assegna un record.   Per assegnare i record, l'indirizzo e-mail deve appartenere a un utente Diligent One.
   Assegna > Gruppo del workflow dal campo	Consente di cercare nel campo della tabella selezionato un nome di gruppo del workflow e, se viene identificato un nome di gruppo del workflow valido, il record viene assegnato a quel particolare gruppo del workflow. Sono disponibili per la selezione solo i campi dati importati e i campi questionario con tipo di dati carattere. Altri campi con qualsiasi altro tipo di dati non sono disponibili.	Solo i membri del gruppo del workflow assegnato possono rivedere il record. Se non viene assegnato alcun gruppo del workflow, tutti i Membri della raccolta con autorizzazioni sufficienti possono vedere il record. Nota Utilizzare l'opzione Abilita notifiche per controllare se i membri del gruppo del flusso di lavoro assegnato devono ricevere un'e-mail quando questo trigger assegna loro un record.
   Invia notifica	Consente di inviare una notifica e-mail a uno o più utenti	Quando si invia una notifica a un utente, l'utente riceve un'e-mail con un collegamento a una tabella che visualizza tutti i record (non esclusivamente i record per cui ha ricevuto la notifica).
   Questionario	Consente di assegnare un questionario a uno dei seguenti: un singolo utente un indirizzo e-mail specificato un indirizzo e-mail da una colonna nella tabella Nota La piattaforma Diligent One non supporta gli indirizzi e-mail con accenti o caratteri non latini.	Ci sono due elenchi di questionari tra cui scegliere: Collegati Questionari già collegati alla tabella (esistono colonne di risposta) Non collegati Questionari che non sono collegati alla tabella (colonne di risposta aggiunte quando viene inviata la prima risposta) Selezionare Utilizza un questionario per rispondere a tutti i record per inviare un questionario al destinatario e applicare la risposta a tutti i record inclusi nell'azione del trigger. Non selezionare questa opzione per registrare una risposta distinta per ogni record. Nota I rispondenti con un account Diligent One associato che sono membri dell'organizzazione devono autenticarsi quando fanno clic sul link per completare il sondaggio. Nota Se si combinano le azioni del Questionario con la frequenza di trigger del record Aggiornato, gli intervistati ricevono più inviti a rispondere al questionario poiché la risposta iniziale determina un aggiornamento. È possibile evitare questa situazione includendo una condizione nel trigger che verifica se una domanda obbligatoria del questionario è lasciata in bianco o meno.
   Stato	Consente di modificare lo stato dei record specificati	L'amministratore di Risultati può selezionare da tutti gli stati disponibili nella raccolta. I Gestori professionali e gli Utenti professionali possono selezionare solo tra gli stati a cui hanno accesso. L'accesso agli stati è definito dai flussi di lavoro. Per maggiori informazioni, consultare Creare flussi di lavoro nell'applicazione Risultati.
   Priorità	Consente di modificare la priorità dei record specificati

8. Nell'area Frequenza, definisci quando il trigger eseguirà:

   Impostazione	Descrizione	Note
   Tempo reale > Record	Valuta le condizioni di trigger ogni qualvolta un record viene creato o aggiornato. Selezionare Solo per i nuovi record per eseguire il trigger solo sui nuovi record. Se si lascia questa impostazione deselezionata, il trigger viene eseguito sui record nuovi e aggiornati che corrispondono alle condizioni del trigger. Quando un record viene considerato nuovo? Il trigger viene eseguito quando un nuovo record viene pubblicato in un'analisi dati, un rapporto dell'evento o un sondaggio nell'applicazione Risultati. Quando un record viene considerato aggiornato? Il trigger viene eseguito quando si verificano modifiche alle informazioni o alle colonne di dati nella tabella. Ad esempio, viene modificato lo stato di un record o viene inviata una risposta al questionario.	Per impostazione predefinita, vengono selezionati i record nuovi e aggiornati. Tuttavia, è possibile scegliere di eseguire i trigger esclusivamente sui nuovi record. Non è possibile combinare condizioni di stato, priorità, assegnatario o del gruppo di flusso di lavoro con frequenze di nuovi record in tempo reale.
   Tempo reale > Questionario	Vengono valutate le condizioni del trigger ogni volta che Diligent One riceve una risposta al questionario selezionato per la tabella di questo trigger.	Non è possibile combinare frequenze di record e questionari in tempo reale.
   Pianificazione	Valuta le condizioni di trigger su una frequenza specificata (giornaliera, settimanale, mensile, trimestrale o una pianificazione personalizzata). Puoi anche specificare l'orario per eseguire il trigger. Quando pianifichi un nuovo trigger, il fuso orario predefinito è quello impostato nel profilo utente Launchpad. Per maggiori informazioni, consulta Aggiornare il profilo.	I cambiamenti orari dovuti all'ora legale possono far sì che i trigger notturni vengano eseguiti in modi non previsti. Per maggiori informazioni, consultare In che modo l'ora legale influisce sui trigger programmati.

   Nota

   Fare attenzione a non abbinare le condizioni alle frequenze in modo che un trigger non possa mai essere eseguito. Per esempio, se le condizioni richiedono che i record siano stati aggiornati più di un giorno fa, ma si imposta la frequenza su tempo reale > record, il trigger non verrà mai eseguito. Questo perché ogni volta che un record viene creato o modificato, è stato aggiornato meno di un giorno fa.

Salvare o eseguire il trigger

1. Esegui una delle seguenti operazioni:
   • Per salvare la configurazione del trigger, selezionare Salva.

     Il trigger viene salvato ed elencato nella finestra di dialogo Automatizza.

   • Per salvare e visualizzare in anteprima la configurazione del trigger e avere la possibilità di eseguirlo immediatamente, selezionare Salva e visualizza in anteprima.

     Viene visualizzata una finestra di dialogo che elenca un campione di record su cui il trigger verrà eseguito ed eseguirà le azioni definite. Nel campione vengono mostrati fino a 200 record, tuttavia, il trigger viene eseguito sul numero totale di record interessati. Fare clic su Esegui per eseguire il trigger.

     Nota

     L'intervallo di tempo tra il verificarsi di un'azione e l'esecuzione di un trigger dipende dalle dimensioni della tabella. Le tabelle di piccole dimensioni (circa 1000 record) normalmente richiedono alcuni secondi. Le tabelle più grandi potrebbero richiedere fino a diversi minuti.

2. Fare clic su Esci per chiudere la finestra di configurazione del trigger.

Creare un trigger su una metrica

Avvisare automaticamente un utente dell'applicazione Risultati quando una metrica raggiunge una determinata soglia. È necessario creare la metrica prima di definire il trigger.

Andare alla finestra di configurazione del trigger

1. Apri l'applicazione Risultati.
2. Esegui una delle seguenti operazioni:
   • Dalla home page di Risultati:
     1. Navigare alla raccolta e all'analisi che contiene la tabella che si desidera eliminare.
     2. Per la tabella da automatizzare, fare clic sul numero nella colonna Trigger.
   • Dal pannello Configura metrica, fare clic su Gestisci trigger.
3. Facoltativo. Per modificare l'ordine di esecuzione per più trigger esistenti, trascinare ogni trigger nella posizione appropriata nell'elenco. I trigger vengono eseguiti dall'alto verso il basso nell'ordine specificato.
4. Fare clic su Nuovo nella finestra di dialogo. Si apre la finestra di configurazione del trigger.
   Nota

   Per modificare un trigger creato in precedenza, fare clic sul nome del trigger.

Definire il trigger

1. Inserisci il nome del trigger nella casella di testo.

   Il limite di caratteri è 255.

2. Nell'area Condizioni, seleziona Metriche.

   Se si è andati alla finestra di configurazione del trigger dal pannello Configura metrica, questa opzione è preselezionata automaticamente.

   Nota

   Puoi solamente selezionare una metrica associata con Analisi dei dati, Rapporto dell'evento o Sondaggio.

3. Seleziona la metrica appropriata e definisci la condizione e il valore che causeranno l'esecuzione del trigger.

   Se hai navigato alla finestra di configurazione del trigger dal pannello Configura metrica, la metrica è preselezionata automaticamente.

4. Facoltativo. Definisci il colore della soglia.
5. Nell'area Azioni, specificare quali utenti devono essere avvisati se la metrica raggiunge la soglia definita.

   L'opzione Notifica viene selezionata automaticamente. Quando si notifica un utente, questo riceve un'e-mail con un link alla metrica.

   Nota

   Se non si riceve la notifica tramite e-mail, verificare nello spam o nella posta indesiderata.

6. Nell'area Frequenza, definisci quando il trigger eseguirà:

Impostazione	Descrizione
Tempo reale > Record	Valuta le condizioni di trigger ogni qualvolta un record viene creato o aggiornato. La casella di spunta Solo per i nuovi record è disabilitata quando crei trigger basati sulle metriche. Questi tipi di trigger si eseguono quando i dati superano la soglia che hai definito nella condizione.
Pianificazione	Valuta le condizioni di trigger su una frequenza specificata (giornaliera, settimanale, mensile, trimestrale o una pianificazione personalizzata). Puoi anche specificare l'orario per eseguire il trigger. Quando pianifichi un nuovo trigger, il fuso orario predefinito è quello impostato nel profilo utente Launchpad. Per maggiori informazioni, consultare Aggiornare il profilo. Quando modifichi un trigger esistente, l'applicazione Risultati ricorda il fuso orario impostato precedentemente. I cambiamenti orari dovuti all'ora legale possono far sì che i trigger notturni vengano eseguiti in modi non previsti. Per maggiori informazioni, consultare In che modo l'ora legale influisce sui trigger programmati.

Salvare il trigger.

1. Per salvare la configurazione del trigger, selezionare Salva. Il trigger viene salvato ed elencato nella finestra di dialogo Automatizza.
   Nota

   L'intervallo di tempo tra il verificarsi di un'azione e l'esecuzione di un trigger dipende dalle dimensioni della tabella. Le tabelle di piccole dimensioni (circa 1000 record) normalmente richiedono alcuni secondi. Le tabelle più grandi potrebbero richiedere fino a diversi minuti.

2. Fare clic su Esci per chiudere la finestra di configurazione del trigger.