Viewers tbv visualisatie
Om in de voorbeelden duidelijk te maken wat daar precies gebeurt en in welke volgorde, zijn visualisaties behulpzaam. Die voorbeelden laten zien hoe registers werken in de praktijk: welke commando's binnenkomen, welke gevolgen worden vastgelegd, welke notificaties worden verstuurd en welke snapshots in de projectie ontstaan. De volgorde en het verloop over tijd spelen daarin een centrale rol.
De TijdlijnViewer maakt zichtbaar wat er is gebeurd over het verloop van de tijd: notificaties, commando's, gevolgen en snapshots verschijnen als gebeurtenissen op een chronologische tijdlijn. Welke onderdelen zichtbaar zijn, hangt af van welke gegevens worden meegegeven aan het component — alle elementen zijn optioneel.
De ProjectieViewer bouwt voort op de TijdlijnViewer en legt de nadruk op projecties. Het component ondersteunt het bekijken van verschillende projecties en visualiseert ze in een bitemporeel diagram, zodat duidelijk wordt hoe de toestand van gegevens zich over twee tijdsdimensies heeft ontwikkeld.
De TijdlijnViewer
De TijdlijnViewer toont de verwerkte gebeurtenissen in een register als een chronologische tijdlijn. De tijdlijn loopt van boven naar beneden: het vroegste tijdstip staat bovenaan, het nieuwste onderaan.
Elke gebeurtenis heeft een eigen kleur:
- Paars — notificaties: signalen die vanuit buiten de bounded context worden ontvangen of vanuit de bounded context naar buiten worden verstuurd
- Blauw — commando's: de instructies die zijn binnengekomen en verwerkt
- Oranje — gevolgen: de vastgelegde effecten van die verwerking
- Groen — snapshots: de resulterende toestanden in de projectie
Klik op een item in de tijdlijn om de details ervan te bekijken. De details verschijnen in de tijdlijn.
De ProjectieViewer
De ProjectieViewer combineert de TijdlijnViewer met een aanvullend onderdeel: een bitemporeel diagram. Samen met een separate details kader maken ze zichtbaar hoe de staat van een collectie gegevens zich over twee tijdsdimensies heeft ontwikkeld.
Drie tijdsdimensies
Elke snapshot in de projectie heeft drie tijdsdimensies. Zie ook Tijdstippen en geldigheid voor de conceptuele achtergrond.
- het geldigheidstijdstip: vanaf wanneer de snapshot geldig is in het domein. Als er ook een eindetijdstip bekend is, vormen ze samen een geldigheidstijdvak. Dit tijdstip is afkomstig uit het commando en meegedragen in het gevolg.
- het gevolgtijdstip: wanneer het gevolg is vastgelegd in het register (de Axon event store). Dit is het tijdstip uit de gevolgenboekhouding.
- het projectietijdstip: wanneer de projectierij is weggeschreven naar de database. Dit tijdstip wordt bepaald bij het produceren van de projectie. Het is alleen zichtbaar in de projectie, niet in het gevolg zelf.
Het bitemporeel diagram
Bovenin de ProjectieViewer staat een bitemporeel diagram. Dit diagram toont de snapshots als rechthoeken in een tweedimensionaal vlak:
- De horizontale as geeft het geldigheidstijdstip (en geldigheidstijdvak) van de snapshot weer.
- De verticale as geeft het gevolgtijdstip of het projectietijdstip weer — te wisselen via de knoppen boven het diagram.
De geselecteerde snapshot is groen gemarkeerd; overige snapshots zijn grijs. Door op een vlak te klikken selecteer je die snapshot.
De projectiedetails
Naast het diagram staat het projectiedetailpaneel. Dit toont de projectierij die hoort bij de geselecteerde snapshot: het geldigheidstijdstip, het gevolgtijdstip en de inhoud van de rij, zoals objectnummer, type, kadastraal object en belanghebbenden.
Voorbeeld
Onderstaand voorbeeld toont een collectie gegevens rondom een WOZ-object. Klik op een snapshot in de tijdlijn of het diagram om de bijbehorende projectierij te bekijken.
Interne architectuur
De viewer-componenten bouwen op elkaar voort. Het onderstaande diagram toont welk component afhankelijk is van welk ander component.
VoorbeeldScenario is een zelfstandige wrapper zonder afhankelijkheden van andere viewer-componenten.