Ga naar hoofdinhoud

Events aan elkaar koppelen

Eén abonnement dekt "als X gebeurt, doe Y". Voor iets langers dan dat — "exporteer het, en markeer het daarna als verstuurd" — koppelt u abonnementen aan elkaar.

Daarvoor is het tabblad Triggers op de kaart Event acties. Een actie kan een volledig nieuw event sturen als die succesvol afrondt, en elk abonnement dat naar dat event luistert neemt het over.

Hoe het werkt

  1. Het event van het abonnement gebeurt en zijn actie draait — bijvoorbeeld een export.
  2. De actie slaagt en levert een resultaat op: wat de export terugkoppelde.
  3. Voor elke trigger die op die actie is ingesteld stuurt SHIPM8 een nieuw event met de naam die u eraan gaf.
  4. Dat nieuwe event draagt mee:
    • het resultaat van de actie als zijn eventdata;
    • het originele eventbericht als zijn originele data.
  5. Een tweede abonnement, dat naar die trigger identificatie luistert, pikt het op — met zijn eigen voorwaarden en zijn eigen acties.

U kunt zoveel stappen aan elkaar koppelen als u nodig hebt, en één actie kan meerdere triggers tegelijk sturen als die meer dan één ding in gang moet zetten.

Een trigger instellen

Met het abonnement in wijzigmodus opent u het tabblad Triggers van de kaart Event acties en klikt u op Add (of u klikt op de rij van een bestaande actie om zijn triggers te wijzigen). Elke entry heeft één veld:

  • Trigger — de identificatie van het event dat gestuurd moet worden.

Gebruik Trigger toevoegen voor meer entries en Trigger verwijderen om er een weg te halen. Maak daarna het tweede abonnement aan met diezelfde identificatie als trigger identificatie.

Geef uw eigen ketenevents duidelijke namen

Ketenevents zijn uw eigen vinding — niets anders in SHIPM8 stuurt ze, dus u kiest de naam. Kies iets voor de hand liggends en consistents, zoals een $-prefix gevolgd door uw eigen woorden, zodat het overzicht als een reeks leest in plaats van als een puzzel. Geef het tweede abonnement triggertype Algemeen, tenzij de naam eindigt op een van de woorden die op Een abonnement aanmaken staan.

Twee dingen om op te letten

Een trigger gaat alleen af als de actie iets teruggaf. Leverde de actie geen resultaat op — omdat die faalde, of omdat er niets te doen was — dan wordt het vervolgevent niet gestuurd. Dat is juist het nuttige eraan: de keten stopt van nature als een stap niet is gelukt, dus de stap "markeer als verstuurd" kan niet draaien na een mislukte verzending.

De tweede stap ziet het resultaat van de eerste stap, niet het originele record. De gegevens van het nieuwe event zijn wat de actie terugkoppelde. Heeft het tweede abonnement waarden uit het originele record nodig, dan staan die in de originele data van het bericht — de moeite waard om eerst met een actie Administratieve melding te controleren, zodat u ziet wat er echt aankomt voordat u er voorwaarden of veldpaden tegen schrijft.

Waarom niet simpelweg meer acties toevoegen?

Beide zijn geldig. Meerdere acties op één abonnement is eenvoudiger, en de juiste keuze als de stappen onafhankelijk zijn — exporteer het en mail iemand.

Koppelen is beter als de stappen echt op elkaar volgen en de latere alleen mag gebeuren als de eerdere is gelukt, omdat acties op één abonnement doorgaan nadat er een is gefaald.