Trigger istantanei (webhook) in Adobe Workfront Fusion
Molti servizi forniscono webhook per inviare notifiche istantanee ogni volta che si verifica una certa modifica nel servizio. Per elaborare queste notifiche, ti consigliamo di utilizzare trigger istantanei. Puoi riconoscerli facilmente in Adobe Workfront Fusion a causa del loro tag:
Se il servizio non fornisce webhook, è necessario utilizzare i trigger di polling per eseguire periodicamente il polling del servizio.
Per un video introduttivo ai webhook in Workfront Fusion, vedi:
Requisiti di accesso
Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:
Per conoscere il piano, il tipo di licenza o l'accesso disponibili, contattare l'amministratore Workfront.
Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.
Visualizzare la coda di un webhook
Tutti i messaggi provenienti dai webhook in ingresso vengono memorizzati nella coda del webhook.
-
Fai clic su Webhook nel menu a sinistra.
-
Individuare il webhook per il quale si desidera visualizzare la coda.
-
Fai clic sul pulsante con l’icona di un camion e il numero di webhook ricevuti.
note note NOTE I dati del webhook in ingresso vengono sempre memorizzati nella coda indipendentemente da come hai impostato l'opzione Dati come confidenziale (descritta in Pannello impostazioni scenario in Adobe Workfront Fusion). Non appena i dati vengono elaborati in uno scenario, vengono eliminati definitivamente dal sistema.
Pianificazione dei trigger istantanei
Se lo scenario contiene un trigger immediato, puoi pianificarne l’esecuzione immediata:
In questo caso, lo scenario verrà eseguito immediatamente quando Workfront Fusion riceve nuovi dati dal servizio. Dopo l’esecuzione dello scenario, viene conteggiato il numero totale di webhook in attesa nella coda e lo scenario esegue tutti i cicli in cui sono presenti, elaborando un webhook per ciclo. Per ulteriori informazioni, vedere Esecuzione dello scenario, cicli e fasi in Adobe Workfront Fusion.
-
Un ciclo non è lo stesso di un'esecuzione di uno scenario. Possono essere presenti più cicli in 1 esecuzione dello scenario.
-
Quando esegui uno scenario con un trigger immediato pianificato come immediato, 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 ogni 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 il numero massimo di cicli su un valore superiore al valore predefinito 1 per elaborare più webhook in un'esecuzione dello scenario:
- Fai clic sull'icona
- Nella casella Impostazioni scenario visualizzata digitare un numero nella casella Numero massimo di cicli per indicare il numero di webhook dalla coda che si desidera eseguire ogni volta che si esegue lo scenario.
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. L'accesso a un payload del webhook dopo più di 30 giorni dalla creazione genera l'errore "Impossibile leggere il file dall'archivio."
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 è impostato per l’esecuzione come pianificato.
Se si verifica un errore durante l’esecuzione dello scenario, il webhook viene rimesso in coda durante la fase di rollback dell’attivatore istantaneo. In una situazione di questo tipo, puoi correggere lo scenario ed eseguirlo nuovamente. Per ulteriori informazioni, vedere Rollback nell'articolo Esecuzione dello scenario, cicli e fasi in Adobe Workfront Fusion.
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 (nel caso in cui l'opzione Conferma automatica nelle impostazioni dello scenario non sia abilitata). Per ulteriori informazioni, vedere Risposta ai webhook nell'articolo Webhook.
Webhook personalizzati
Puoi creare webhook personalizzati. Per ulteriori informazioni, vedere 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.