Berichtontwerp

Berichten die hun betekenis behouden tussen teams en systemen.

Geef elke gebeurtenis een duidelijke envelop

Een gebeurtenis heeft meer nodig dan een inhoud. Identiteit, herkomst en aanmaaktijd helpen de ontvanger begrijpen welke toepassing het bericht heeft gemaakt. Houd deze gedeelde velden gescheiden van de bedrijfsgegevens, zodat een andere transportlaag hun betekenis niet verandert.

Berichtontwerp
Wijzig een bericht zonder lezers te verrassen

Producenten en afnemers worden zelden tegelijk bijgewerkt. Een schemawijziging heeft daarom een overgangsperiode waarin oude en nieuwe berichten naast elkaar bestaan. Ontwerp die periode expliciet; een uitrol is niet één ondeelbare handeling voor de hele organisatie.

Berichtontwerp
Volg één interactie over systeemgrenzen

Eén gebruikersactie kan meerdere verzoeken, achtergrondtaken en meldingen veroorzaken. Een correlatie-identificatie verbindt de registraties van die interactie. Het is nuttige context, maar geen authenticatietoken en mag op zichzelf nooit toegang verlenen.

Berichtontwerp
Maak duidelijk welke klok een tijdstempel beschrijft

Ontvangstvolgorde is niet altijd gebeurtenisvolgorde. Apparaten raken offline, klokken lopen uiteen en wachtrijen vertragen publicatie. Een tijdstempel zonder vastgelegde betekenis nodigt uit om metingen van verschillende procesmomenten samen te voegen.

Berichtontwerp
Maak fouten bruikbaar voor het ontvangende systeem

Een foutantwoord moet de aanroeper helpen bepalen wat daarna nodig is. Een uitleg voor mensen en een classificatie voor software hebben verschillende doelen. Houd de foutcode stabiel wanneer de tekst voor duidelijkheid of vertaling verandert.

Berichtontwerp

Zoek in de bibliotheek