Plugin-Aktionen mit Parametern, manueller Ausführung und Queue-Anbindung.
Plugin-Automatisierungen sind Aktionen, die zu einem Plugin gehören und im Manager gestartet werden können. Aktuell ist als Trigger Manuell vorgesehen. Eine Automatisierung wird nur ausgeführt, wenn sie aktiv ist.
Im Plugin-Editor liegt der Bereich unter Automatisierungen. Dort zeigt der Manager eine Tabelle der registrierten Automatisierungen; über Automatisierung erstellen wird eine neue Aktion angelegt.
Eine Automatisierung besitzt folgende zentrale Felder:
Bezeichnung: Name der Aktion im Manager.Aktiv: nur aktive Automatisierungen können gestartet werden.Trigger: aktuell Manuell.Ausführung: Queue oder Instant.Code: JavaScript-Code, der von der Plugin-Queue ausgeführt wird.Parameter: optionale Eingabefelder, die beim Start abgefragt werden.Unterstützte Parametertypen sind String, Boolean, Monat, Date, Datetime, Date-Range, Datetime-Range, Standort, Shop, Webseite, App und Kunde. Jeder Parameter hat einen Key, eine Bezeichnung, optional einen Default-Wert und kann als Pflichtfeld markiert werden.
Beim Start rendert der Manager aus den Parametern automatisch passende Eingabefelder. Pflichtfelder werden geprüft. Default-Werte werden vorbefüllt; JSON-Defaults können als Objekt oder Array übernommen werden.
Bei Instant wird die Automatisierung direkt ausgeführt. Wenn der Code eine Manager-Weiterleitung zurückgibt, navigiert der Manager dorthin. Bei Queue wird ein Queue-Job PluginActionQueueJob angelegt; der Manager öffnet anschließend den Job, damit der Fortschritt nachvollzogen werden kann.
Typische Einsatzzwecke sind manuelle Datenaufbereitungen, Exporte, Sync-Läufe, Nachberechnungen oder Aktionen, die ein bestimmtes Datum, einen Shop, eine Website oder einen Standort als Parameter benötigen.
Wenn eine Aktion länger dauern kann oder externe Systeme kontaktiert, sollte Queue verwendet werden. Instant eignet sich für kurze Aktionen, die direkt Feedback im Manager geben oder unmittelbar auf eine Ergebnisseite weiterleiten.