Als gebruiker wil ik gedurende de afhandeling van de zaak specifieke documentversies kunnen verwijderen

[CMasselink]

Zodat alleen de versies bij de zaak bewaard blijven die daadwerkelijk bewaard moeten worden.
Deze functionaliteit is nodig om te voorkomen dat de DRC volloopt met documentversies die eigenlijk niet bewaard hoeven te blijven, en daarmee de inhoud van de DRC beheerbaar te houden. Op deze manier is, wanneer nodig, reconstructie achteraf veel beter mogelijk dan wanneer alle documentversies bewaard blijven.

Het gaat dus om het kunnen verwijderen van specifieke versies van documenten. Op dit moment is het alleen mogelijk om een een geheel informatieobject te verwijderen.
Verwijderen van versies kan gedurende de looptijd van de zaak plaatsvinden (bijvoorbeeld bij het bereiken van bepaalde mijlpalen/statussen).

[michielverhoef]

Dan moet eerst een eventuele relatie (objectinformatieobject) naar een specifieke versie van een document verwijderd worden. Zie ook #459.

Opnemen in beschrijving gedrag.

[sergei-maertens]

Dan moet eerst een eventuele relatie (objectinformatieobject) naar een specifieke versie van een document verwijderd worden. Zie ook #459.

dat hoort dus een validatiestap te zijn in de documenten API - dat alle relaties eerst verbroken worden. Ik laat een collega van mij aan een PR werken hiervoor op de referentie-implementatie.

[michielverhoef]

PR VNG-Realisatie/documenten-api#146 aangemaakt voor dit issue

[sergei-maertens]

The technical implementation is in VNG-Realisatie/documenten-api#145

There are a number of situations that can happen when using this, so below is a summary of all options handled.

1. DELETE /api/v1/enkelvoudiginformatieobjecten/<uuid>

   • existing behaviour remains
   • validates that there are no more relations to other objects (zaken, besluiten)
   • delete cascades: gebruiksrechten & audittrails are deleted as well

2. DELETE /api/v1/enkelvoudiginformatieobjecten/<uuid>?versie=<int>

   There are multiple paths here:

   1. This is one version of many

      • validate that there are no other objects related to this specific version (zaken, besluiten)
      • delete this particular version
      • gebruiksrechten & audittrails are not deleted

   2. This is the last remaining version of the document

      • validate that there are no other objects related to this specific version (zaken, besluiten)
      • validate that there are no other objects related to any version (zaken, besluiten) (implicit 'latest' version relation)
      • delete the document
      • delete cascades: gebruiksrechten & audittrails are deleted as well

This implies small changes to the writes as well:

• When a document is related to another resource (zaak, besluit), it's possible to use the document URL including the ?versie querystring parameter. This version information is available in the OIO response body with the read-only informatieobject_versie attribute (so the clients don't have to parse that from the URL).
• Relations can be made with explicit version or without. In the latter case, the relation points de-facto to the "latest version" of the document.
• The relating to specific or implicit latest version is functionally unchanged from 1.0 - these changes make it more explicit and structured. The changes are required to be able to do proper/efficient unique-constraint validation.

[michielverhoef]

Thanks @sergei-maertens. I will this description in the "aanvullende specificaties"