TweedeKamerDerStaten-Generaal / OpenDataPortaal

GitHub van het officiële Open Data Portaal van de Tweede Kamer der Staten-Generaal.
https://opendata.tweedekamer.nl
49 stars 3 forks source link

Verband motie-nummer in publicatie en opzoeken in portaal #100

Closed paulmelis closed 1 year ago

paulmelis commented 1 year ago

Het lijkt er op dat het lastig is om de onderliggende data van een gepubliceerde motie (bijv. de PDF, of bekende rood/groene vinkjes uitslag) terug te zoeken in het data-portaal.

Voorbeeld: van deze motie (https://www.tweedekamer.nl/kamerstukken/moties/detail?id=2020D54260&did=2020D54260) zijn in de PDF bekend het vergaderjaar 2020-2021, 35393 en nr 21.

Het bijbehorende record in het portaal is https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Zaak(dcd99b99-8ddd-4ac1-a0ab-87678a7e244d), maar daarin is alleen het Volgnummer 21 terug te vinden (maar dat is niet uniek). Bijvoorbeeld https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Zaak?$filter=Vergaderjaar%20eq%20%272020-2021%27%20and%20Soort%20eq%20%27Motie%27%20and%20Volgnummer%20eq%2021 geeft veel resultaten terug.

Het record heeft wel een Nummer, namelijk 2020Z25819, maar dit is dan weer niet terug te leiden tot de data uit de motie tekst. Is de match echt alleen te vinden door op titel te zoeken?

NoWarries commented 1 year ago

De Zaak Entiteit heeft een veel op veel relatie met Document

Deze kan je opvragen door de entiteit Document te expanden

https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Zaak/dcd99b99-8ddd-4ac1-a0ab-87678a7e244d?$expand=Document Dit kan je doen door ?$expand=Document aan de endpoint toe te voegen

Vervolgens kan je de resource van het/de document(en) weer opvragen

https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Document/8a6a6795-8f53-4abd-bc5a-723c4bfab5ef/Resource

Dit levert volgens mij het gewenste resultaat op en een download van het bijhorende document (PDF)

paulmelis commented 1 year ago

Dit levert volgens mij het gewenste resultaat op en een download van het bijhorende document (PDF)

Yikes, dat is wel erg omslachting om van een PDF link naar een data record te komen. Waarom is er geen manier om van motie-nummer naar record te gaan?

Edit: punt is, ik vind de PDFs niet heel interessant. Vaak zie je een screenshotje van een motie-uitslag langskomen en daar staat een nummer in (2023Z.... + volgnummer) en dat nummer wil ik gebruiken om mee te queryen

NoWarries commented 1 year ago

Dit levert volgens mij het gewenste resultaat op en een download van het bijhorende document (PDF)

Yikes, dat is wel erg omslachting om van een PDF link naar een data record te komen. Waarom is er geen manier om van motie-nummer naar record te gaan?

Edit: punt is, ik vind de PDFs niet heel interessant. Vaak zie je een screenshotje van een motie-uitslag langskomen en daar staat een nummer in (2023Z.... + volgnummer) en dat nummer wil ik gebruiken om mee te queryen

Een volgnummer is een "Uniek nummer van een Zaak binnen een Kamerstukdossier."

paulmelis commented 1 year ago

Een volgnummer is een "Uniek nummer van een Zaak binnen een Kamerstukdossier."

Okee, dus het nummer 35393 in het voorbeeld is het kamerstukdossier, en samen met volgnummer 21 levert dat de juiste zaak op. Dank!

OpenDataPortaal commented 1 year ago

Klopt helemaal. Vanuit de Zaak zal je dan altijd bij het corresponderende Kamerstukdossier uitkomen.

Wel is het wellicht handig om te weten dat een Kamerstukdossier ook het attribuut 'Toevoeging' heeft. Dit heeft meestal een null-waarde. Een Nummer kan vaker voorkomen (bijvoorbeeld nummer 36200), en de Toevoeging maakt het dossier uniek (buiten het id natuurlijk). Een Kamerstuknummer zoals vermeld op de pdf wordt dus opgebouwd uit , en . Voorbeelden van Kamerstukdossiers met een Toevoeging zijn: