Skip to content

Commit

Permalink
Update 03-component-applicatie.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Nil-NMB01 authored Jan 8, 2025
1 parent 70f53be commit 0ae0c30
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions sections/03-specificaties/03-component-applicatie.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ Het gespecificeerde gedrag van Applicaties is erop gericht om de interface van h

De Applicatie ***MOET*** een nieuwe Trace met een uniek `trace_id` starten voor iedere nieuwe Dataverwerking. In een Trace wordt de metadata bijgehouden die nodig is om de interface van een Logboek te gebruiken.

Een Dataverwerking kan uit meerdere acties bestaan. De applicatie ***MOET*** een voor iedere nieuwe actie een unieke `operation_id` bijhouden. Iedere Trace heeft tenminste één `operation_id`.
Een Dataverwerking kan uit meerdere acties bestaan. De applicatie ***MOET*** een voor iedere nieuwe actie een unieke `span_id` bijhouden. Iedere Trace heeft tenminste één `span_id`.

Wanneer een actie binnen een Applicatie is gestart door een andere actie, dan ***MOET*** de Applicatie de `trace_id` ongewijzigd overnemen en de `operation_id` opnemen in een veld genaamd `parent_operation_id` voor deze nieuwe actie.
Wanneer een actie binnen een Applicatie is gestart door een andere actie, dan ***MOET*** de Applicatie de `trace_id` ongewijzigd overnemen en de `span_id` opnemen in een veld genaamd `parent_span_id` voor deze nieuwe actie.

Als een Dataverwerking meerdere Betrokkenen heeft dan ***MOET*** de applicatie voor iedere Betrokkene een aparte logregel wegschrijven. Een logregel kan naar 0 of 1 Betrokkenen verwijzen.

De Applicatie ***MOET*** voor iedere actie (`operation_id`) een logregel wegschrijven via de interface van het Logboek.
De Applicatie ***MOET*** voor iedere actie (`span_id`) een logregel wegschrijven via de interface van het Logboek.

De Applicatie ***MOET*** bijhouden of een actie geslaagd of mislukt is en dit per Dataverwerking als status (`status_code`) meegeven in de Logregel.

Expand All @@ -30,7 +30,7 @@ De Applicatie ***MAG NIET*** gebruik maken van *Log Sampling*.

Voor iedere Betrokkene moet iedere Dataverwerking apart gelogd worden. De Applicatie ***MOET*** in elke Logregel een identificerende code van de Betrokkene opnemen in `dpl.core.data_subject_id` en aan te duiden welk soort identificerende code wordt gebruikt in `dpl.core.data_subject_id_type`. Het wordt ***AANBEVOLEN*** om de identificerende code te pseudonimiseren.

Wanneer een enkele Dataverwerking meerdere Betrokkenen heeft, ***MOET*** de Applicatie voor elke Betrokkene een nieuwe actie met unieke `operation_id` starten en deze onder de reeds bekende actie voegen door het `operation_id` daarvan op te nemen als `parent_operation_id` in de nieuwe actie. Voor iedere betrokkene wordt een *child operation* bijgehouden.
Wanneer een enkele Dataverwerking meerdere Betrokkenen heeft, ***MOET*** de Applicatie voor elke Betrokkene een nieuwe actie met unieke `span_id` starten en deze onder de reeds bekende actie voegen door het `span_id` daarvan op te nemen als `parent_span_id` in de nieuwe actie. Voor iedere betrokkene wordt een *child operation* bijgehouden.

Let op: het kan zijn dat pas na een antwoord van een externe Applicatie bekend is dat er meerdere Betrokkenen zijn bij een Dataverwerking, in dat geval moeten na ontvangst van het antwoord de nieuwe acties ten behoeve van correcte logging gestart worden.

Expand Down

0 comments on commit 0ae0c30

Please sign in to comment.