Direktutlösare (webhooks)
Många tjänster tillhandahåller webhooks för att leverera snabbmeddelanden när en viss ändring (händelse) inträffar i tjänsten. Om du vill bearbeta de här händelserna rekommenderar vi att du använder snabbutlösare. Direktutlösare visar taggen Instant i listan med moduler för en given koppling.
Om en anslutning inte innehåller någon webkrok kan du göra något av följande:
- Skapa en anpassad webkrok med Webkrok-modulen.
Mer information finns i Webhooks. - Använd avsökningsutlösare för att regelbundet avsöka tjänsten.
Mer information finns i Schemalägg ett scenario
En videointroduktion till webbhooks i Workfront Fusion finns på:
Schemalägg direktutlösare
När du konfigurerar en direktutlösare uppmanas du att välja när den körs.
Välj Immediately om du vill köra scenariot omedelbart när Workfront Fusion tar emot nya händelser från tjänsten. Dessa händelser skickas omedelbart till en kö och bearbetas sedan i scenariot en i taget i samma ordning som data tas emot.
När scenariot körs räknas det totala antalet väntande händelser som väntar i kön, och scenariot utför så många cykler som det finns väntande händelser, och en händelse bearbetas per cykel.
Mer information om cykler finns i Scenariokörning, cykler och faser.
-
En cykel är inte detsamma som en scenariokörning. Det kan finnas flera cykler i en och samma scenario.
-
När du kör ett scenario med en utlösare som är schemalagd att köras
Immediatelygäller följande undantag:-
Intervallet mellan två körningar omfattas inte av minimiintervallet enligt prissättningsplanen.
När till exempel scenariot har slutförts kontrolleras webbkrokens kö igen. Om det finns några väntande webbhooks körs scenariot omedelbart igen och alla väntande webbhooks bearbetas igen.
-
Inställningen för maximalt antal cykler ignoreras och ställs in på 100, vilket innebär att högst 100 väntande webbhooks bearbetas under en enda scenariokörning (med en hastighet på 1 händelse per cykel).
-
Om du använder någon annan schemainställning än Immediately körs scenariot med de intervall du anger. Eftersom det går att samla in flera webbböcker i kön under intervallet rekommenderar vi att du anger ett högre värde för alternativet Maximum number of cycles än standardvärdet 1 för att bearbeta fler webbhooks i en enda scenariokörning:
- Klicka på ikonen Scenario settings
- På panelen Scenario settings som visas anger du en siffra i fältet Max number of cycles som anger antalet händelser från kön som du vill köra varje gång du kör scenariot.
Återstående händelser i kön bearbetas nästa gång scenariot körs, upp till det antal som anges i fältet Max antal cykler.
Webkrokskyddsräcken
För att säkerställa goda prestanda har Workfront Fusion följande skyddsräcken på plats för webhooks.
Kursgränser
Den aktuella hastighetsgränsen är 5 webbhooks per sekund. Om gränsen överskrids returneras en 429-statuskod.
Inaktiva webhooks förfaller
En webkrok som inte har tilldelats något scenario på mer än 120 timmar tas bort.
Webkrok-nyttolaster
Workfront Fusion lagrar webkrocknyttolaster i 30 dagar. Om du får åtkomst till en webkrok-nyttolast mer än 30 dagar efter att den skapades uppstår felet Failed to read file from storage.
Felhantering
När det finns ett fel i ditt scenario med en direktutlösare:
- Stoppar omedelbart när scenariot är inställt på att köra Immediately.
- Stoppar efter 3 misslyckade försök (3 fel) när scenariot är inställt på att köras enligt schema.
Om ett fel inträffar under scenariokörningen placeras händelsen tillbaka i kön under snabbutlösarens återställningsfas. I sådana fall kan du åtgärda scenariot och köra det igen.
Mer information finns i Återställning i artikeln Scenariokörning, cykler och faser.
Om det finns en Webkroks svarsmodul i ditt scenario skickas felet till Webkroks svar. Webkroks svarsmodul körs alltid sist (när alternativet Auto commit i scenarieinställningarna inte är aktiverat).
Mer information finns i Svara på webhooks i artikeln Webbhooks.
Webkroks-inaktivering
Webhooks inaktiveras automatiskt om något av följande gäller:
- Webbkroken har inte varit ansluten till något scenario på mer än fem dagar.
- Webkroken används bara i inaktiva scenarier, som har varit inaktiva i mer än 30 dagar.
Inaktiverade webhooks tas bort och avregistreras automatiskt om de inte är anslutna till några scenarier och har varit i inaktiveringsstatus i över 30 dagar.
Anpassade webbhotell
Du kan skapa egna webbböcker. Mer information finns i Webhooks.
Resurser
Mer information om cykler finns i Scenariokörning, cykler och faser.