Nesten van resources

[melsk-r]

De DSO API-strategie stelt:

API-09 Relaties van geneste resources worden binnen het eindpunt gecreëerd” Als een relatie alleen kan bestaan binnen een andere resource (geneste resource), wordt de relatie binnen het eindpunt gecreëerd. De afhankelijke resource heeft geen eigen eindpunt

Aanvullingen hierop:

Er mag worden afgeweken van deze richtlijn, mits goed onderbouwd en gedocumenteerd.
Er wordt niet dieper genest dan 1 niveau, tenzij goed onderbouwd en gedocumenteerd.

Ratio: Conceptueel is dit precies zoals het moet zijn. Echter, voortschrijdend inzicht, voortkomend uit gemaakte implementaties van referentie componenten en demo consumers, leidt er toe dat deze richtlijn wordt opgerekt.

Een concreet voorbeeld is een consumer die een lijst van ZAKEN van verschillende ZAAKTYPEN laat zien en daar het STATUSTYPE bij wil laten zien. Conceptueel bevindt een STATUSTYPE zich altijd binnen ZAAKTYPE (in het ImZTC). Echter, dit zou in het voorbeeld betekenen dat we voor elk ZAAKTYPE dat voorkomt in de lijst van ZAKEN, een aparte call gemaakt moet worden om de STATUSTYPEs op te halen. Veel efficiënter is het om in 1 keer een lijst van STATUSTYPEN op te halen en de consumer deze te laten koppelen aan de relevante ZAAK.

[melsk-r]

JBo: Bespreken
HK: Bespreken
RM: Discussie
MV: Bespreken
GJ: Overnemen API-B27 (is opvolger van API-09)
JBi: Bespreken

MV: Klinkt logisch als je naar het voorbeeld kijkt. Maar is het ook goed?
HK: Zie ook deze lange discussie: Geonovum/KP-APIs#258
GJ: DSO API-B27 beschrijft een herziening hierop tot 3 niveau's diep.

[melsk-r]

Kan iemand wat meer informatie verstrekken m.b.t. API-B27?