Bedingungen

Der trigger identifier entscheidet, auf welche Ereignisse ein Abonnement lauscht. Bedingungen entscheiden, ob es bei diesem hier handeln soll.

Sie stehen auf der Karte Business logic der Detailseite, unter dem Reiter Conditions. Sie sind optional: Ein Abonnement ohne Bedingungen läuft jedes Mal, wenn sein Ereignis eintritt.

Wozu sie gut sind

Ein Ereignis ist meist breiter als das, was Sie automatisieren wollen. Ein paar Beispiele:

• „Jede Rechnung wurde geändert“ → nur handeln, wenn der Status auf Approved gewechselt ist.
• „Ein Datensatz dieser Art wurde angelegt“ → nur handeln, wenn er zu einem bestimmten Kunden gehört.
• „Die ETA eines Hafenbesuchs hat sich geändert“ → nur bei Schiffen ab einer bestimmten Größe handeln.

So bedient ein Ereignis viele verschiedene Automatisierungen, jede mit eigenem Filter — statt für jeden Fall ein eigenes Ereignis zu brauchen.

Wie eine Bedingung aufgebaut ist

Bedingungen funktionieren hier genau wie die Business-Logik anderswo in SHIPM8; die Seite Business-Logik — Grundlagen ist die Referenz für die Mechanik. Kurz gesagt hat jede Bedingung:

• ein source field — welchen Wert sie anschaut, als Pfad in die Ereignisdaten;
• einen Operator — wie verglichen wird (gleich, größer als, enthält und so weiter);
• einen Wert — womit verglichen wird.

Zur Auswahl steht derselbe Satz Arten: Text, Zahl, Ja/Nein, Datum und Liste, dazu die fortgeschritteneren Bedingungen timespan und schedule.

Legen Sie mehrere Bedingungen an, müssen alle zutreffen. Für ein „entweder das oder jenes“ nehmen Sie evaluation sets, beschrieben unter Business-Logik — fortgeschritten.

Worauf die Bedingungen schauen

Der Unterschied zu Tarifen liegt nur darin, worauf die Bedingungen schauen. Hier sind die Daten die Ereignisnachricht, und die trägt:

• den Datensatz, um den es ging, so wie er jetzt ist;
• bei Änderungen zusätzlich den Datensatz von vorher und die Liste der geänderten Felder;
• den Zeitpunkt des Ereignisses.

Ein source field ist also ein Pfad in die Daten dieses Datensatzes — derselbe Feldpfad wie beim Schreiben einer Vorlage.

Den richtigen Feldpfad finden

Am sichersten finden Sie einen Feldpfad, indem Sie sich die tatsächlich angekommenen Daten ansehen. Legen Sie zuerst eine Aktion Admin notification an (siehe Aktionstypen), lassen Sie das Ereignis einmal eintreten und lesen Sie, was durchkommt — und schreiben Sie Ihre Bedingungen dann dagegen. Der SHIPM8-Support kann Ihnen die aufgezeichneten Ereignisdaten ebenfalls heraussuchen.

Eine anlegen

Klicken Sie am Abonnement zuerst auf Edit, dann auf der Karte Business logic auf Add. Wählen Sie die Art der Bedingung, füllen Sie source field, Operator und Wert aus und bestätigen Sie. Ein Klick auf eine vorhandene Bedingung öffnet sie zum Ändern. Gespeichert wird nichts, bis Sie das Abonnement mit Save sichern.

Bei einem Abonnement zeigt die Karte nur den Reiter Conditions — die Reiter für Berechnungen, Abhängigkeiten und MwSt., die Sie vielleicht aus den Tarifbildschirmen kennen, gelten hier nicht.