Ga naar hoofdinhoud

Actietypen

Elke event actie heeft een type, dat bepaalt wat die daadwerkelijk doet en welke instellingen die vraagt. Er zijn er acht, en deze pagina legt elk type in gewone taal uit. De exacte waarden die in de velden horen zijn specifiek voor uw inrichting — dat is het deel dat u samen met SHIPM8 support uitwerkt.

Twee instellingen komen in de meeste typen terug, dus die zijn het waard om één keer uit te leggen:

  • Content module en Content type — samen zeggen deze met welk soort record de actie werkt. Het zijn dezelfde interne codes die overal in data export en aangepaste gegevens worden gebruikt (bijvoorbeeld de module van uw eigen objecten, of de code van een extern systeem zoals Exact Online).
  • Object id pad — waar in de gegevens van het event het ID van het te bewerken record te vinden is. Het event draagt een heel record met zich mee, en dit vertelt de actie welk deel daarvan het record identificeert. Het kan naar één ID of naar een lijst wijzen.

Administratieve melding​

Verstuurt een e-mail. Het onderwerp en de inhoud worden geschreven als sjablonen, dus ze kunnen waarden uit het event aanhalen — "Factuur 2026-0142 voor Acme is definitief geworden".

Instellingen: Onderwerp, Inhoud, Aan adres.

Gebruik het om zaken in de gaten te houden, en vooral om te zien wat een event daadwerkelijk bevat terwijl u een abonnement bouwt: stuur het ruwe event naar uzelf, lees het, en schrijf daarna uw voorwaarden en paden op basis van wat er echt aankwam.

notitie

Dit is het enige actietype dat uw gegevens niet aanraakt, wat het de veilige maakt om mee te experimenteren.

Content distributie exporteren​

Geeft een record door aan een export. Het zoekt het record op via zijn ID en haalt het door data export, de manier waarop SHIPM8 gegevens naar boekhoudsystemen en andere externe diensten stuurt. Dit is de actie achter "als een factuur definitief wordt, stuur die dan naar Exact Online".

Instellingen: Content module, Content type, Object id pad, Zoekvelden pad en Vereiste data.

  • Zoekvelden pad — optioneel. Waar in de eventgegevens zoekcriteria staan die met het event zijn meegekomen, in plaats van een record-ID.
  • Vereiste data — optioneel. Een lijst die extra, gerelateerde gegevens beschrijft die de export nodig heeft (bijvoorbeeld de klant achter een factuur). Elke entry heeft een mapping sleutel, een veld en een set gevraagde velden, en kan zelf onderliggende items en filtering hebben. Dit spiegelt het begrip vereiste data uit Data export.

Content distributie export extra gegevens​

Hetzelfde idee, maar voor events die niet over een opgeslagen record gaan. In plaats van een record via zijn ID op te zoeken, geeft deze variant de eigen gegevens van het event rechtstreeks door aan de export. Dit gebruikt u voor inkomende webhooks en andere events die hun lading met zich meedragen.

Instellingen: Content module, Content type, Zoekvelden pad, Zoekvelden en Vereiste data.

  • Zoekvelden — anders dan bij de gewone export kunt u hier zelf zoekcriteria definiëren: een veldnaam, een operator, een waarde en of er in aangepaste inhoud gezocht moet worden. Gebruik het om het bijbehorende record in SHIPM8 te vinden op basis van wat het externe systeem stuurde.

Content distributie verspreiden​

Maakt een document en levert het af. Waar exporteren gegevens aan een dienst overdraagt, draait verspreiden een exportsjabloon en verstuurt het resultaat — een PDF, een e-mail, een bericht aan een gekoppeld systeem.

Instellingen: Content module, Content type, Object id pad, Template id.

Template id is het numerieke ID van het te gebruiken exportsjabloon. Dat vindt u op het sjabloon zelf in Data export.

Content distributie verspreiden melding​

Verspreiden, plus een bericht en de ontvangers. Gebruik dit als de automatisering iets naar specifieke mensen moet sturen in plaats van de eigen leveringsinstellingen van het sjabloon te volgen.

Instellingen: alles van verspreiden, plus Onderwerp, Inhoud, Distributie brondata en een lijst met Ontvangers.

  • Onderwerp en Inhoud zijn sjablonen, dus ze kunnen waarden uit het event aanhalen.
  • Distributie brondata bepaalt welke gegevens met het bericht meereizen:
    • Geen — geen extra gegevens.
    • Alleen eventdata — het record waar het event over ging. De gebruikelijke keuze.
    • Alleen originele data — het record zoals het vóór de wijziging was.
    • Wachtrijbericht — alles, inclusief beide versies en het tijdstip.
  • Elke Ontvanger heeft een Adres, een Weergavenaam, een Documenttype en een Distributieservice (hoe het wordt afgeleverd — e-mail, of een gekoppelde dienst).

Content distributie importeren​

Haalt gegevens in SHIPM8 binnen. Het neemt de gegevens van het event en haalt die door een importdefinitie, die de binnenkomende velden op SHIPM8-records afbeeldt. Dit is de tegenhanger van exporteren: doorgaans gebruikt met een inkomende webhook, waarbij een extern systeem een wijziging doorstuurt en u die wilt opslaan.

Instellingen: Import definitiecode (de code van de importdefinitie die gedraaid moet worden) en Brontype (wat voor soort bron de gegevens vandaan komen).

Aangepaste inhoud bijwerken​

Schrijft waarden in de velden van een record. De actie zoekt het record en zet er een of meer velden op.

Instellingen: Content module, Content type, Object id pad en Velden om bij te werken.

Elke entry onder Velden om bij te werken is een paar:

  • Veld — naar welk veld geschreven moet worden.
  • Waarde — wat er geschreven moet worden. Dit is een sjabloon, dus het kan een vaste waarde zijn of iets dat uit het event wordt opgebouwd, zoals een nummer overnemen van het gewijzigde record.

Gebruik het voor administratieve automatiseringen: een status stempelen, een referentie overnemen, een record als afgehandeld markeren. Een veld met een leeg resultaat wordt overgeslagen in plaats van gewist.

Let op de lus

Een record bijwerken stuurt zelf een wijzigingsevent. Werkt een abonnement op …_update hetzelfde soort record bij, dan kan het zichzelf opnieuw afgaan. Gebruik voorwaarden om ervoor te zorgen dat de actie maar één keer kan toeslaan.

Factuurstroom uitvoering​

Start een facturatiestroom. De gegevens van het event worden als brondata aan de stroom doorgegeven, zodat die er facturen uit kan opbouwen.

Instelling: Flow systeemcode — de systeemcode van de te draaien facturatiestroom, die u op de stroom vindt in Facturatiestromen.

Gebruik het voor "als de klus is afgerond, factureer die dan": het event markeert het werk als gedaan, en de stroom maakt er een factuur van. De uitvoering verschijnt in de eigen uitvoeringshistorie van de facturatiestroom, gemarkeerd als gestart door een event handler-abonnement.