Zum Hauptinhalt springen

Abonnements — die Grundlagen

Ein Abonnement ist die SHIPM8-Art zu sagen: „Wenn das passiert, tu jenes.“ Es lauscht darauf, dass in der App etwas geschieht — ein Ereignis — und führt dann automatisch eine oder mehrere Aktionen aus, ohne dass jemand klickt.

Abonnements gehören zum Event-Handler: dem Hintergrundmechanismus, der diese Ereignisse durch SHIPM8 trägt. Sie hören beide Namen für dieselbe Sache — der Event-Handler ist die Maschinerie, ein Abonnement ist eine Regel darauf.

Sie öffnen ihn über Navigation → Admin → Content distribution → Subscriptions. Hat Ihr Konto zusätzlich das Recht Manage events, zeigt die Admin-Seite eine eigene Karte Event handler mit demselben Link.

Wofür das gut ist​

Was Leute typischerweise damit automatisieren:

  • Eine Rechnung in dem Moment an die Buchhaltung schicken, in dem sie final wird.
  • Eine Bestätigung an den Kunden mailen, sobald ein Datensatz einen bestimmten Status erreicht.
  • Ein Feld an einem Datensatz automatisch füllen, wenn sich ein verwandter Datensatz ändert.
  • Einen Rechnungsablauf starten, wenn ein Auftrag fertig ist.
  • Daten aus einem externen System holen, wenn es einen Webhook schickt.
  • Einen Administrator per E-Mail auf etwas hinweisen, um es im Blick zu behalten.

Die drei Teile eines Abonnements​

Jedes Abonnement besteht aus denselben drei Teilen:

  1. Das Ereignis — wann es laufen soll. Sie benennen es über einen trigger identifier (ein Kurzcode wie $invoicing_invoice_finalized) und einen trigger type. Die vollständige Liste steht unter Ereignistypen.
  2. Die Bedingungen — ob es diesmal laufen soll. Optional. Bedingungen schauen auf die Daten, die mit dem Ereignis kamen, und lassen das Abonnement nur weiterlaufen, wenn sie zutreffen. Siehe Bedingungen.
  3. Die Aktionen — was passieren soll. Ein Abonnement kann mehrere Aktionen haben, jede mit eigenem Typ und eigenen Einstellungen. Siehe Ereignisaktionen und Aktionstypen.

Wie es abläuft​

Wichtig zu wissen: Das passiert alles im Hintergrund.

  1. In SHIPM8 geschieht etwas — ein Datensatz wird gespeichert, eine Rechnung wird final, ein Dokument geht raus.
  2. SHIPM8 erzeugt eine Ereignisnachricht, die die Daten des Datensatzes mitträgt.
  3. Der Event-Handler sucht in Ihrer Organisation nach Abonnements, die zu diesem Ereignis passen.
  4. Für jeden Treffer werden die Bedingungen geprüft. Treffen sie nicht zu, passiert nichts.
  5. Treffen sie zu, laufen die Aktionen des Abonnements nacheinander.

Weil es im Hintergrund läuft, hält eine Aktion niemanden auf: Wer das Ereignis ausgelöst hat, arbeitet weiter, während die Automatisierung läuft. Meist geht es um Sekunden, sofort ist es aber nicht — und in welcher Reihenfolge zwei getrennte Abonnements laufen, ist nicht garantiert.

Aktionen laufen nach einem Fehler weiter

Es werden alle Aktionen eines Abonnements versucht. Scheitert eine, laufen die anderen trotzdem — der Fehler landet im Ausführungsprotokoll, statt den Rest abzubrechen. Siehe Überwachung und Fehlersuche.

Was Sie hier tun können​

Zielgruppe & Berechtigung

Das hier ist ein Administratorbereich. Schon um den Bildschirm zu erreichen, brauchen Sie das Recht Service connections, ebenso zum Anlegen und Ändern. Die zusätzliche Karte Event handler auf der Admin-Seite erscheint nur mit dem Recht Manage events. Sehen Sie unter Admin kein Subscriptions, fragen Sie Ihren Administrator.

Hinweis zu den Beschriftungen

SHIPM8 gibt es bisher nicht auf Deutsch. Diese Anleitung nennt Schaltflächen, Menüs und Spalten deshalb so, wie sie in der App stehen — auf Englisch.

Hilfe beim ersten Mal

Trigger identifier, Feldpfade und Aktionseinstellungen sind exakte, technische Werte. Richten Sie Ihr erstes Abonnement ein, geht es deutlich schneller, wenn Sie skizzieren, was passieren soll, und der SHIPM8-Support die Codes mit Ihnen einträgt — statt zu raten.