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.

Istantanea

TIP
È possibile controllare l'elenco dei moduli in un connettore per verificare se dispone di un trigger immediato oppure controllare la documentazione del connettore in Applicazioni Fusion e relativi riferimenti ai moduli.
Per la documentazione sui trigger istantanei di Adobe Workfront, consulta Triggers nell'articolo Moduli Workfront.

Se 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.

Impostazione pianificazione

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 utilizzi un'impostazione di pianificazione diversa da Immediatamente, lo scenario viene eseguito agli intervalli specificati. Poiché è possibile raccogliere più webhook nella coda durante l'intervallo, si consiglia di impostare l'opzione Numero massimo di cicli su un valore maggiore del valore predefinito 1 per elaborare più webhook in un'esecuzione dello scenario:

  1. Fai clic sull'icona Impostazioni scenario Icona Impostazioni scenario nella parte inferiore dello scenario.
  2. Nel pannello Impostazioni scenario visualizzato, immettere un numero nel campo Numero massimo di cicli 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 Immediata.
  • 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 Conferma automatica nelle impostazioni dello 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.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3