search

VNG-Realisatie / gemma-zaken

Samen ontwikkelen van API's voor Zaakgericht werken
https://vng-realisatie.github.io/gemma-zaken/
Other
41 stars 27 forks source link

DRC: is er nu wel of geen expand op objectinformatieobjecten? #2469

Open johannesbattjes opened 2 months ago

johannesbattjes commented 2 months ago

Naard aanleidng van gesprek met @EduardWitteveen

Zie https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/VNG-Realisatie/gemma-zaken/a3d733f07c3a569614fb552d5268a2057855307a/api-specificatie/drc/1.4.x/1.4.4/openapi.yaml#tag/objectinformatieobjecten/operation/objectinformatieobject_list

In deze 1.4.4-versie zit een expand op objectinformatieobjecten. Maar deze zit niet in DRC 1.5. Is dat een vergissing? Met andere woorden kan deze aan DRC 1.5 in een patch worden toegevoegd?

Zie ook commentaar van @HenriKorver op #2405

EduardWitteveen commented 2 months ago

Vanuit het open-webconcept heeft dit prioriteit omdat de snelheid serieus probleem is bij de mijnzaken omgeving, de expand op zrc in 1.5 heeft het al een stuk werkbaarder gemaakt, maar de documenten ophalen blijft traag. Onduidelijkheid hierin heeft meteen gevolgen voor het live kunnen zetten van functionaliteiten (het tonen van documenten bij een zaak) bij gemeenten, zelfs voor het afgeven van een goede planning hiervoor.

In openzaak zit deze experimentele functionaliteit, maar deze bevind zich op een ander endpoint: /enkelvoudiginformatieobjecten ( https://github.com/open-zaak/open-zaak/issues/1664 ). Een andere aanpak voor, in mijn ogen, hetzelfde probleem.

Op dit moment is het belangrijkste dat we niet verschillende varianten krijgen, dit heeft namelijk meteen gevolgen voor de code die we ontwikkelen binnen het owc waarbij we rekening moeten houden met verschillende dialecten binnen de standaard. Een keuze is dus het belangrijkste, want dan kan de document informatie in één keer, volledig, snel en gestandaardiseerd worden ontsloten in de mijnzaken omgeving.

Vanuit het oogpunt van een gebruiker van de api's vind ik de functionaliteiten op het endpoint /enkelvoudiginformatieobjecten het meest logisch, want ik wil documenten terug krijgen, de relatie is context informatie.
Uiteraard zou je het ook op 2 endpoints deze expand functionaliteit kunnen standaardiseren.

michielverhoef commented 2 months ago

DRC 1.4.4 bestaat niet, tenminste niet volgens de pagina die de Documenten API beschrijft: https://vng-realisatie.github.io/gemma-zaken/standaard/documenten/. Ook in de github repository zelf kan ik die OAS niet terugvinden: https://github.com/VNG-Realisatie/gemma-zaken/tree/master/api-specificatie/drc/1.4.x

Er bestaat wel een versie 1.4.4 in een branch van Henri Korver maar in de main/master branch staat deze niet. Dat betekent m.i. dat deze 1.4.4 versie niet uitgebracht is als standaard.

@johannesbattjes hoe ben je bij deze 1.4.4 versie gekomen?

johannesbattjes commented 2 months ago

Via jullie reactie op #2405. Ik begreep daaruit dat het het de bedoeling was expands op de DRC toe te voegen in een minor version.