Dir stehen drei Trigger-Optionen in der HubEngine zur Verfügung, um einen Synchronisierungsplan auszulösen:
- Manuell
- Zeitgesteuert
- Webhook
Die Optionen findest du in der Planübersicht unter dem Reiter Trigger. Die einzelnen Optionen können beliebig miteinander kombiniert werden. Im abgebildeten Screenshot ist nur manuelles Triggern aktiviert.
Manuelles Triggern
Beim manuellen Triggern, löst du den HubEngine Plan über den Trigger-Button rechts oben aus.
Zeitgesteuert (via Cron)
Beim zeitgesteuerten Trigger richtest du einen Cronjob ein.
„Der Cron-Daemon dient der zeitbasierten Ausführung von Prozessen in Unix und unixartigen Betriebssystemen wie Linux, BSD oder macOS, um wiederkehrende Aufgaben – Cronjobs – zu automatisieren.“ – Wikipedia
Dabei stehen dir standardmäßig Synchronisierungsfrequenzen zwischen minütlich und jährlich zur Verfügung. Um das Format deines Cronjobs zu validieren, kannst du z.B. Crontab Guru nutzen. Es sind fünf Parameter zu spezifizieren:
Minute Stunde Tag Monat Wochentag
Beispiele für Cronjobs
- minütlich: * * * * *
- stündlich: 0 * * * *
- Jeden Tag im August um 00:05 Uhr: 5 0 * 8 *
- Mittwochs um 16:00 Uhr: 0 16 * * 3
Webhook
Pläne können auch über Webhooks ausgelöst werden. Dabei bestehen zwei Möglichkeiten:
- Trigger-URL
- Action-URL
Die Trigger-URL kann nur über einen POST-Request angesprochen werden, ist also als API-Endpunkt verfügbar. Dadurch kann der Plan auch über Code getriggert werden.
Die Action-URL kann über einen gewöhnlichen Web-Request aufgerufen werden. Die Target-URL bestimmt die Seite, auf welche weitergeleitet werden soll, nachdem die Action-URL aufgerufen wurde.
Externe Webhook
Bei den externen Webhooks handelt es sich um eine Folgeaktion nach Ausführen des Plans. So kann ein POST-Request gesendet werden, um weitere Aktionen nach der Planausführung anzustoßen.
Weitere Pläne triggern
Es besteht auch die Möglichkeit, die Ausführung weiterer HubEngine Pläne im Anschluss anzustoßen.