Replies: 9 comments 9 replies
-
Hoewel ik de derde archiefstatus duurzaam toegankelijk in essentie snap vraag ik me wel af of je dit op dit niveau moet vastleggen. Je regelt m.i. duurzaamheidseisen in op applicatieniveau waarbij je wellicht achteraf in bulk documenten omzet in een duurzaam formaat als de applicatie dat zelf niet kan. Ook bij het punt 'Op basis van onveranderlijke informatieobjecten kan een 'werklijst' voor informatiebeheerders worden gecreëerd. Het uitgevoerde werk levert dan een duurzaam_toegankelijk informatieobject op.' heb ik me vraagtekens bij. Ik interpreteer dit punt (wellicht verkeerd) als dat een informatiebeheerder handmatig allerlei controles op duurzaamheidsaspecten op documentniveau moet gaan uitvoeren o.b.v. een werklijst. Kijkend naar het groot aantal zaken en documenten die worden ontvangen en gecreëerd is handmatig uitvoeren van deze controles onbegonnen werk bij mijn gemeente. Wanneer deze controles en evt. omzettingen/aanpassingen niet automatisch kunnen voorzie ik dat van deze status weinig gebruik gemaakt zal worden. |
Beta Was this translation helpful? Give feedback.
-
Vanuit de gemeente 's-Hertogenbosch zijn we het eens met het voorstel. Wel hebben we suggesties voor andere waarden bij archiefstatus: |
Beta Was this translation helpful? Give feedback.
-
Allereerst onze complimenten voor de zorgvuldige en duidelijke uitwerking. Wij hebben de voorkeur voor een minor versie en zijn het eens dat deze potentieel breaking is voor clients die hard coded een beperkte lijst waardes in de enum voor status hebben.
Verder commentaar: we zien in de Redoc voor 1.5.0 nog het volgende staan bij PATCH en PUT: "status NIET definitief". Het voorstel om voor archiefstatus niet "mutabel" maar "veranderlijk" te gebruiken is wat ons betreft prima. Johannes Battjes en Michiel Nijdam (Roxit) |
Beta Was this translation helpful? Give feedback.
-
Vanuit Utrecht hebben wij de volgende feedback op het voorstel. property 'archiefstatus' property 'bevatNietOpenbarePersoonsgegevens |
Beta Was this translation helpful? Give feedback.
-
Bedankt voor de voorbereiding. Vanuit Centric willen we graag het volgende meegeven: Major / MinorDe aanpassingen zoals die zijn voorgesteld, leveren breaking changes op API niveau. De NL Design Rules schrijven voor dat dit in een major versie moet worden ondergebracht. Daarmee lijkt het helder dat dit een major versie moet zijn. Property ArchiefstatusIn RGBZ hadden we een archiefnominatie en een archiefactiedatum op het niveau van de zaak. In RGBZ 2.0 is daar een archiefstatus op zaakniveau bijgekomen. Maar nu wordt er een archiefstatus op documentniveau toegevoegd. Daarmee wordt het model wel heel gedetailleerd. Een archiefstatus op zaakniveau lijkt ons voldoende. Mocht de behoefte aan een archiefstatus op document niveau er blijven, dan bevelen we aan om het waardebereik van beide properties gelijk te houden. Op zaakniveau worden de volgende waarden ondersteund:
Waarschijnlijk zijn dan alleen de eerste twee van toepassing op documenten. En dan is nog de vraag of de term ‘archiveren’ hier dan wel de juiste is. Feitelijk geef je aan of het document al dan niet in een wijzigbaar formaat is vastgelegd. Op documentniveau kan in de property ‘status’ op de waarde ‘gearchiveerd’ verwijderd worden. Of een document in wijzigbare vorm is vastgelegd blijkt dan wel uit de property ‘formaat’. Property bevatNietOpenbarePersoonsgegevensDit property weerspiegeld een eerdere discussie: #2240 Het lastige van dit voorstel is dat er meerdere gronden zijn waarop een document (deels) niet openbaar is te maken. Het zou mooier zijn om een property te definiëren voor beperkingen voor openbaarheid met een enumeratie van alle mogelijke uitzonderingsgronden. (En 1 document kan meerdere uitzonderingsgronden van toepassing hebben.) Ook is het met een property voor uitzonderingsgronden logisch om direct een andere relatie op te nemen met een document wat wél openbaar gemaakt kan worden, bijvoorbeeld omdat het geschikt gemaakt is voor publicatie. We stellen voor deze property nu niet op te nemen en in plaats daarvan een uitgebreidere oplossing te ontwikkelen. Duurzaam_ToegankelijkOf een informatieobject duurzaam toegankelijk is, bepaal je niet op documentniveau, maar op zaakniveau. Zeker in de nieuwe archiefwet gaat het met archiefbescheiden/document/informatie-object/record om het geheel aan gegevens: de zaak. Voor duurzame toegankelijkheid op documentniveau bestaat de lijst van voorkeursformaten van het Nationaal Archief en dat is af te leiden uit het formaat van het document. Een extra property bij documenten lijkt ons niet nuttig. |
Beta Was this translation helpful? Give feedback.
-
Beste collega's, hartelijk dank voor jullie uitgebreide en constructieve reacties! Ik zal deze week nog reageren op de individuele opmerkingen waarop nog niet was gereageerd en op basis van de reacties een voorstel doen voor verwerking in een nieuwe versie van de Documenten API-specificatie. |
Beta Was this translation helpful? Give feedback.
-
Ik beloofde deze week op basis van de ontvangen reacties nog met een voorstel te komen. Bij dezen op de valreep. Ik begin met de vragen waarbij we specifiek om reacties hadden gevraagd.
In reactie op de vraag naar verwerking van de wijzigingen in een minor- of majorversie zijn twee verschillende antwoorden gegeven. Ik begrijp goed dat implementatie van een majorversie extra werk oplevert. Tegelijkertijd stellen de API-design rules klip en klaar dat "when releasing a new version which contains backwards-incompatible changes, a new major version must be released". Punt waarover dan nog gediscussieerd kan worden is de vraag of de voorgestelde wijzigingen inderdaad "backwards-incompatible changes" met zich meebrengen. In de toelichting is beargumenteerd dat hiervan in dit geval sprake is. In de opmerkingen hierboven is die argumentatie niet betwist. Naar aanleiding daarvan stel ik voor de wijzigingen op te nemen in een 2.0-versie van specificaties voor de Documenten API. Bij het punt over verwacht gedrag heb ik één opmerking gezien. Het lijkt me inderdaad goed om te kijken of we de archiefstatus Dan de tweede vraag.
Naar aanleiding van drie reacties deze vraag constateer ik dat doel en betekenis van de waarde Dan door naar andere opmerkingen over 'archiefstatus'. Eén reactie stelt voor aan te sluiten bij de toegestane waarden in de Zaken API, echter gevolgd door de vraag of het begrip 'archiveren' - en in het verlengde daarvan de waardenaam Mede op basis van andere reacties is mijn conclusie dat duidelijkheid en begrijpelijkheid in dit geval boven consistentie moeten gaan. Als waarden voor 'archiefstatus' stel ik daarom de waarden Omdat de voor archiefstatus voorgestelde description ("Geeft aan in hoeverre het informatieobject duurzaam toegankelijk is en op het voorgeschreven moment vernietigd of overgebracht kan worden.") zonder de waarde Rest nog één discussiepunt; het opnemen van de property 'bevatNietOpenbarePersoonsgegevens'. Omdat twee reacties expliciet vragen om te kijken naar een oplossing die ook voor andere gronden die de openbaarheid beperken voldoet én aansluit bij MDTO, stel ik voor de property 'bevatNietOpenbarePersoonsgegevens' niet op te nemen. Het voorstel voor een volgende versie van de Documenten API zou een zoveel mogelijk bij MDTO aansluitend mechanisme moeten omvatten dat registratie van verschillende gronden die openbaarheid en gebruik beperken mogelijk maakt. Hiervoor is een issue (#2419) aangemaakt. In deze reactie niet besproken wijzigingen nemen we volgens voorstel op. Komende week maken we naar aanleiding van deze bevindingen een OAS voor versie 2.0 van de Documenten API-standaard. Ook gaan we aan de slag met het verwerken van deze wijzigingen in de referentieimplementatie bij deze standaard. |
Beta Was this translation helpful? Give feedback.
-
We zijn erg teleurgesteld dat versie 1.5, die oorspronkelijk al eind december gereed zou zijn, nu niet komt. Duizenden VTH-medewerkers die (vaak zonder dat te weten) deze standaard dagelijks gebruiken zijn hiervan de dupe. een (snel te publiceren) 1.5 met alleen:
een 2.0 met
|
Beta Was this translation helpful? Give feedback.
-
De naar aanleiding van het voorstel van Johannes voorgenomen wijzigingen voor versie 1.5 van de Documenten API zijn gedocumenteerd in pull request #2423. De bijgewerkte OpenAPI-spec is te bereiken via de links in de documentatie van bovenstaand pull request of via #2421. Voordat we bovenstaande documentatie releasen, wachten we nog één collegiale review af. Ik verwacht die begin volgende week binnen te hebben. Verwerking van deze wijzigingen in de referentie-implementatie zal later (maar wel ergens de komende weken) plaatsvinden. |
Beta Was this translation helpful? Give feedback.
-
Deze discussie is bedoeld voor reacties bij de consultatie van wijzigingen in de Documenten API die resulteren in een 1.5.0 of 2.0.0-release van de bijbehorende specificaties. Deze zijn ontstaan op initiatief van een aantal gemeenten en leveranciers. De voorafgaande discussie is gedocumenteerd in issue #2242.
De toelichting bij deze wijzigingen is hier te vinden.
De concept-OAS is hier gepubliceerd (Redoc).
Belanghebbenden worden uitgenodigd op ieder onderdeel van de voorgestelde specificaties of de toelichting daarbij te reageren. We hebben echter ook een tweetal specifieke vragen (overgenomen uit de toelichting):
We horen graag van belanghebbenden:
Over nut en noodzaak van het opnemen van archiefstatus
duurzaam_toegankelijk
was tijdens het voorbereiden van bovenstaande wijzigingen geen volledige overeenstemming. Belanghebbenden met inzichten die helpen bepalen of we deze waarde moeten opnemen of niet zijn daarom van harte uitgenodigd die inzichten te delen.Deze consultatie eindigt op maandag 26 februari 2024.
Beta Was this translation helpful? Give feedback.
All reactions