Trigger istantanei (webhook)
Molti servizi forniscono webhook per inviare notifiche istantanee ogni volta che si verifica un determinato cambiamento (evento) nel servizio. Per elaborare questi eventi, si consiglia di utilizzare trigger istantanei. I trigger istantanei visualizzano il tag Instant nell'elenco dei moduli per un determinato connettore.
TIPSe un connettore non include un webhook, puoi effettuare una delle seguenti operazioni:
- Crea un webhook personalizzato utilizzando il modulo Webhook.
Per ulteriori informazioni, vedere Webhook. - Utilizza i trigger di polling per eseguire periodicamente il polling del servizio.
Per ulteriori informazioni, vedere Pianificare uno scenario
Per un video introduttivo ai webhook in Workfront Fusion, vedi:
Pianificazione dei trigger istantanei
Quando configuri un trigger istantaneo, ti viene richiesto di selezionare quando viene eseguito.
Selezionare Immediately per eseguire immediatamente lo scenario quando Workfront Fusion riceve nuovi eventi dal servizio. Questi eventi vengono immediatamente inviati in una coda e quindi elaborati nello scenario uno alla volta, nello stesso ordine in cui vengono ricevuti i dati.
Quando lo scenario viene eseguito, viene conteggiata la quantità totale di eventi in sospeso in attesa nella coda e lo scenario esegue il numero di cicli corrispondente agli eventi in sospeso, elaborando un evento per ciclo.
Per ulteriori informazioni sui cicli, vedere Esecuzione dello scenario, cicli e fasi.
NOTE-
Un ciclo non è lo stesso di un'esecuzione di uno scenario. In un’unica esecuzione dello scenario possono essere presenti più cicli.
-
Quando si esegue uno scenario con un trigger istantaneo pianificato per l'esecuzione di
Immediately, si applicano le seguenti eccezioni:-
L'intervallo tra due esecuzioni non è soggetto all'intervallo minimo in base al piano tariffario.
Ad esempio, una volta che lo scenario termina la sua esecuzione, la coda del webhook viene nuovamente controllata. Se sono presenti webhook in sospeso, lo scenario viene eseguito immediatamente di nuovo, elaborando nuovamente tutti i webhook in sospeso.
-
L’impostazione dello scenario Numero massimo di cicli viene ignorata e impostata su 100, il che significa che non più di 100 webhook in sospeso verranno elaborati durante un’unica esecuzione dello scenario (alla velocità di 1 evento per ciclo).
-
Se si utilizza un'impostazione di pianificazione diversa da Immediately, lo scenario viene eseguito agli intervalli specificati. Poiché è possibile raccogliere più webhook nella coda durante l'intervallo, si consiglia di impostare l'opzione Maximum number of cycles su un valore superiore a quello predefinito 1 per elaborare più webhook in un'esecuzione dello scenario:
- Fai clic sull'icona Scenario settings
- Nel pannello Scenario settings visualizzato, immettere un numero nel campo Max number of cycles per indicare il numero di eventi dalla coda che si desidera eseguire ogni volta che si esegue lo scenario.
Gli eventi rimanenti nella coda verranno elaborati alla successiva esecuzione dello scenario, fino al numero impostato nel campo Numero massimo di cicli.
Guardrail per webhook
Per garantire buone prestazioni, Workfront Fusion dispone dei seguenti guardrail per i webhook.
Limiti di tariffa
L'attuale limite di velocità è di 5 webhook al secondo. Se il limite viene superato, viene restituito un codice di stato 429.
Scadenza dei webhook inattivi
Un webhook che non è stato assegnato ad alcuno scenario per più di 120 ore viene rimosso.
Payload del webhook
Workfront Fusion memorizza i payload del webhook per 30 giorni. Se si accede a un payload del webhook più di 30 giorni dopo la sua creazione, si verifica l'errore Failed to read file from storage.
Gestione degli errori
Quando si verifica un errore nello scenario con un trigger istantaneo, lo scenario:
- Si arresta immediatamente quando lo scenario è impostato per l'esecuzione di Immediately.
- Si interrompe dopo 3 tentativi non riusciti (3 errori) quando lo scenario viene impostato per l’esecuzione come pianificato.
Se si verifica un errore durante l’esecuzione dello scenario, l’evento viene rimesso in coda durante la fase di rollback dell’attivatore istantaneo. In tale situazione, puoi correggere lo scenario ed eseguirlo nuovamente.
Per ulteriori informazioni, vedere Rollback nell'articolo Esecuzione scenario, cicli e fasi.
Se nello scenario è presente un modulo di risposta Webhook, l’errore viene inviato alla risposta Webhook. Il modulo di risposta Webhook viene sempre eseguito per ultimo (quando l'opzione Auto commit nelle impostazioni Scenario non è abilitata).
Per ulteriori informazioni, vedere Risposta ai webhook nell'articolo Webhook.
Disattivazione webhook
I webhook vengono disattivati automaticamente se si applica una delle seguenti condizioni:
- Il webhook non è stato connesso ad alcuno scenario per più di 5 giorni.
- Il webhook viene utilizzato solo in scenari inattivi, che sono stati inattivi per più di 30 giorni.
I webhook disattivati vengono eliminati e annullati automaticamente se non sono connessi ad alcun scenario e se sono in stato disattivato da oltre 30 giorni.
Webhook personalizzati
Puoi creare webhook personalizzati. Per ulteriori informazioni, vedere Webhook.
Risorse
Per ulteriori informazioni sui cicli, vedere Esecuzione dello scenario, cicli e fasi.