Documentatie

Data rond de besluitvorming van de Vlaamse Regering wordt gepubliceerd in gestandardiseerde formaten die zowel door mens- als machine geïnterpreteerd kunnen worden. Ontdek de data en ga er zelf mee aan de slag!

Besluitvormingscatalogus

Themis ontsluit momenteel een catalogus: de besluitvormingscatalogus. De verschillende datasets en bijhorende representaties die in deze catalogus aangeboden worden, worden hierna verder beschreven. In de toekomst kan Themis uitgebreid worden met bijkomende catalogussen en datasets.

De besluitvormingscatalogus omvat datasets rond de besluitvorming van de Vlaamse Regering. De meeste informatie in deze catalogus is afkomstig uit de Kaleidos applicatie.

De catalogus bevat verschillende soorten datasets:

• beslissingen van de Vlaamse Regering per ministerraad in kort bestek
• samenstelling van de Vlaamse Regering
• levensboom van een dossier en de bijhorende procedurestappen (toekomst)
• concept schemes en codelijsten

De verschillende soorten datasets en de inhoud van de bijhordende representaties worden hieronder in detail toegelicht.

Vlaamse Regering in kort bestek per ministerraad

Na afloop van iedere ministerraad worden de beslissingen van de Vlaamse Regering via diverse kanalen gecommuniceerd in kort bestek aan de hand van nieuwsberichten. Een van deze kanalen is het Themis platform. De data wordt in Turtle formaat ter beschikking gesteld. Een werkdag later worden ook de bijhorende documenten bij de nieuwsberichten in PDF-formaat gepubliceerd.

Dataset en distributions

Iedere publicatie van de beslissingen van een ministerraad wordt gerepresenteerd door een dcat:Dataset met een specifiek type (dct:type). De dataset verwijst naar de mininsterraad (besluit:Vergaderactiviteit) die het onderwerp is van de dataset via dct:subject. De dataset heeft verschillende distributions:

• een dcat:Distribution in Turtle formaat die de data zoals de agenda, agendapunten en nieuwsberichten bevat. Het model wordt verder gespecificeerd in Inhoud van de Turtle distribution.
• een dcat:Distribution in PDF formaat per document dat toegevoegd wordt als bijlage bij een nieuwsbericht

De distributions zijn te onderscheiden op basis van hun type-eigenschap (dct:type). Iedere distribution bevat via dct:subject een verwijzing naar het bestand (nfo:FileDataObject) dat het representeert.

Herpublicaties, bijvoorbeeld bij de vrijgave van de documenten of na een aanpassing van een nieuwsbericht, worden gerepresenteerd door een nieuwe dcat:Dataset. Deze nieuwe dataset wordt via prov:wasRevisionOf gerelateerd aan de vorige versie. Op die manier ontstaat er een linked list van datasets voor een bepaalde ministerraad. De download URLs van de distributions van de voorgaande versie worden op dat moment ook onbeschikbaar gemaakt. Deze kunnen niet langer gedownload worden. Enkel de distributions van de laatste versie kunnen gedownload worden.

Uitzonderlijk moet een publicatie van de beslissingen van een ministerraad ongedaan gemaakt worden. Er wordt dan een nieuwe beperkte dataset gepubliceerd (zie Inhoud van de Turtle distribution). Net zoals bij herpublicatie wordt de nieuwe dataset via prov:wasRevisionOf gerelateerd aan de vorige versie en worden de download URLs van de vorige versie onbeschikbaar gemaakt.

Gebruikers van de datasets moeten nieuwe publicaties overnemen en data van voorgaande publicaties, net als het Themis platform, onbeschikbaar maken.

Inhoud van de Turtle distribution

Onderstaand diagram illustreert het data model dat gehanteerd wordt om de nieuwsberichten uit het kort bestek van een ministerraad te ontsluiten. De data is beschikbaar in Turtle formaat. Het model is een uitbreiding van het OSLO besluitvorming applicatieprofiel.

Volgende prefixes worden gebruikt:

Het bereik van ieder predicaat wordt aangegeven in het diagram. Code verwijst hierbij naar een element uit een codelijst. De exacte definities van de classes en eigenschappen kunnen gevonden worden in de relevante vocabualaria en bijhorende applicatieprofielen .

Iedere dataset voor een (her)publicatie van de beslissingen bevat een publicatie activiteit (prov:Activity met specifiek dct:type). De publicatie activiteit verwijst via prov:used naar de ministerraad (besluit:Vergaderactiviteit) waarop de publicatie van toepassing is. De activiteit resulteert (prov:generated) in een publieke agenda (besluitvorming:Agenda) en bijhorende publieke agendapunten (besluit:Agendapunt).

Iedere herpublicatie van een ministerraad resulteert in een nieuwe publicatie activiteit, agenda en agendapunten. De agenda en agendapunten verwijzen elk naar hun overeenkomstig item in de voorgaande dataset versie via prov:wasRevisionOf. Op die manier onstaat er voor iedere agenda en ieder agendapunt een linked list van versies over de verschillende datasets heen. Daarnaast bevat de agenda en elk agendapunt ook een verwijzing naar het overeenkomstige originele item in Kaleidos waaruit ze afgeleid zijn via prov:wasDerivedFrom. Een uitzondering hierop is het ongedaan maken van een publicatie. In dit geval zal de dataset enkel een publicatie activiteit bevatten met een verwijzing naar de ministerraad, maar zonder publieke agenda en agendapunten.

De agendapunten van een agenda worden geagendeerd in een bepaalde volgorde. Ook dit wordt, volgens het OSLO besluitvorming applicatieprofiel, gemodelleerd aan de hand van een linked list gevormd via besluit:aangebrachtNa. Om praktische implementaties te vereenvoudigen wordt deze volgorde ook geexpliciteerd aan de hand van een volgnummer (schema:position) per agendapunt. Merk op dat deze volgorde niet noodzakelijk overeenstemt met de volgorde van de nieuwsberichten. Zij hebben een eigen volgnummer.

Uit iedere agendapunt wordt via prov:wasDerivedFrom een nieuwsbericht afgeleid. Een nieuwsbericht is een stuk uit een dossier (dossier:Stuk) met een specifiek type (dct:type). De belangrijkste eigenschap van een nieuwsbericht is nie:htmlContent wat de HTML inhoud van het nieuwsbericht bevat. De bevoegde minister(s) (mandaat:Mandataris) zijn gelinkt aan het nieuwsbericht via prov:qualifiedAssociation. De volgorde van de nieuwsberichten wordt uitgedrukt aan de hand van een volgnummer (schema:position) per nieuwsbericht. Zoals eerder gesteld stemt deze volgorde niet noodzakelijk overeen met de volgorde van de agendapunten.

Een werkdag na de publicatie van de beslissingen worden de bijhorende documenten gepubliceerd. Deze datum wordt via themis:geplandePublicatieDatumDocumenten gezet als eigenschap van de publicatie activiteit. Een nieuwsbericht kan een of meerdere documenten bevatten via besluitvorming:heeftBijlage. De bijlagen zijn op hun beurt weer een stuk van een dossier (dossier:Stuk).

De bijlage (dossier:Stuk) bevat enkel metadata van de bijlage. Het PDF bestand (nfo:FileDataObject) met de eigenlijke inhoud is gerelateerd via prov:value aan de bijlage. Het model dat gehanteerd wordt voor de PDF bestanden wordt verder toegelicht in de documentatie van de file service van het gebruikte framework. De URL waarop het PDF bestand gedownload kan worden is tevens de dcat:downloadURL van de bijhorende distribution.

Samenstelling van de Vlaamse Regering

Dataset en distributions

De samenstelling van de Vlaamse Regering, zowel uit het heden als het verleden, wordt gerepresenteerd door een dcat:Dataset met een specifiek type (dct:type). De dataset omvat informatie over de verschillende bestuursorganen, legislaturen, mandaten, mandatarissen en personen die deel uitmaken of hebben uitgemaakt van de Vlaamse Regering. De dataset heeft momenteel slechts een distribution:

• een dcat:Distribution in Turtle formaat die de volledige historiek van de samenstelling van de Vlaamse Regering bevat. Dit zijn o.a. de bestuursorganen, legislaturen, mandaten, mandatarissen en personen zowel uit het heden als het verleden die samen de Vlaamse Regering vormen. Het model wordt verder gespecificeerd in Inhoud van de Turtle distribution.

Herpublicaties, bijvoorbeeld bij de aanstelling van een nieuwe regering, worden gerepresenteerd door een nieuwe dcat:Dataset. Deze nieuwe dataset wordt via prov:wasRevisionOf gerelateerd aan de vorige versie. Op die manier ontstaat er een linked list van datasets. De laatste versie omvat opnieuw de volledige historiek van de samentelling van de Vlaamse Regering, niet enkel de wijzigingen. Distributions van vorige versies blijven beschikbaar om te downloaden.

Inhoud van de Turtle distribution

Het datamodel dat gehanteerd wordt om de historiek van de samenstelling van de Vlaamse Regering te ontsluiten is gebasseerd op het OSLO applicatieprofiel van de Mandatendatabank. De exacte definities van de classes en eigenschappen kunnen gevonden worden in de relevante OSLO vocabualaria zoals het besluit-vocabularium en het mandaat-vocabularium.

In wat volgt worden enkele praktische implementaties van het informatiemodel toegelicht zoals ze toegepast worden in de ontsloten dataset van de samenstelling van de Vlaames Regering.

Bestuurseenheid

De hele dataset handelt over de samenstelling van bestuursorganen van één bestuurseenheid: het Vlaams Gewest, met als URI http://themis.vlaanderen.be/id/bestuurseenheid/e7a239de-c48c-441c-8293-ec365eedce93. De samenstellingen van de andere gewesten vallen buiten de scope van deze dataset.

Bestuursorgaan en bestuursorgaan (in periode)

In het OSLO applicatieprofiel van de Mandatendatabank worden bestuursorganen gerepresenteerd d.m.v. bestuursorgaan en bestuursorgaan (in bestuursperiode), waarbij de tweede entiteit een tijdspecialisatie is van de eerste. Beiden hebben dezelfde rdf:Class, nl. besluit:Bestuursorgaan, maar de tijdsgebonden entiteit bevat enkel de eigenschappen die wijzigen doorheen de tijd. Alle andere eigenschappen worden impliciet overgenomen van de niet-tijdsgebonden entiteit.

In de toepassing van het applicatieprofiel in de dataset van de samenstelling van de Vlaamse Regering resulteert dit in een structuur met 3 'lagen':

1. Bestuursorgaan (niet-tijdsgebonden)
2. Legislatuur (tijdsgebonden)
3. Regeringssamentelling (tijdsgebonden)

De lagen worden geïllustreed in bovenstaand diagram. In wat volgt wordt elk van de lagen verder toegelicht.

Bestuursorgaan (niet-tijdsgebonden)

De bovenste laag bevat de niet-tijdsgebonden bestuursorganen die bevoegd zijn om rechtshandelingen te stellen voor het Vlaamse Gewest. In de huidige staatstructuur zijn dit er twee:

• de Vlaamse Regering (http://themis.vlaanderen.be/id/bestuursorgaan/7f2c82aa-75ac-40f8-a6c3-9fe539163025)
• het Vlaams Parlement (http://themis.vlaanderen.be/id/bestuursorgaan/17caac00-34a2-4b84-b400-30823555c15e)

Beide bestuursorganen zijn opgenomen in de dataset, maar enkel voor het bestuursorgaan van de Vlaamse Regering zijn er verdere tijdspecialisaties uitgewerkt.

Legislatuur (tijdsgebonden)

Het bestuursorgaan van de Vlaamse Regering bevat een tijdspecialisatie per legislatuur. Dit is de bestuursperiode waarvoor een regering aangesteld wordt d.m.v. een rechtstreekse verkiezing. Momenteel is dit een periode van 5 jaar.

Regeringsamenstelling (tijdsgebonden)

Een legislatuur kan op zijn beurt verschillende tijdspecialisaties bevatten, nl. een per samenstelling van de regering. In een 'ideaal scenario' is er slechts een regeringsamenstelling per legislatuur, maar bijvoorbeeld bij ontslag van een regeringslid of een herverdeling van bevoegdheden wordt een nieuw bevoegdheidsbesluit opgesteld (i.e. een wijziging van de regeringssamenstelling) voor de resterende looptijd van legislatuur. In de data reflecteert dit zich als een nieuwe regeringsamenstelling-entiteit die een tijdspecialisatie is van dezelfde legislatuur als de vorige regeringsamenstelling. In de volksmond wordt dit meestal uitgedrukt aan de hand van een wijziging van de naam van de regering, zoals bijvoorbeeld Jambon I, Homans II, enz.

Als uitbreiding van het OSLO applicatieprofiel van de Mandatendatabank worden mandatarissen die deel uitmaken van een regeringsamenstelling rechtstreeks gelinkt aan een regeringssamenstelling via het predicaat prov:hadMember.

Bestuursfuncties en mandaten

In de Vlaamse Regering kan men volgende drie bestuursfuncties (org:Role) uitoefenen:

1. Minister-president (http://themis.vlaanderen.be/id/bestuursfunctie/5fed907ce6670526694a03de)
2. Viceminister-president (http://themis.vlaanderen.be/id/bestuursfunctie/5fed907ce6670526694a03df)
3. Minister (http://themis.vlaanderen.be/id/bestuursfunctie/5fed907ce6670526694a03e0)

Elk van deze functies zijn een concept in het concept schema 'Bestuursfuncties' (http://data.vlaanderen.be/id/conceptscheme/BestuursfunctieCode).

Voor iedere legislatuur zijn er drie mandaten (mandaat:Mandaat), één per bestuursfunctie. Het mandaat is gelinkt aan de legislatuur (besluit:Bestuursorgaan) via het predicaat org:hasPost. Mandaten zijn niet gelinkt aan een niet-tijdsgebonden bestuursorgaan en een bestuursorgaan op het niveau van regeringsamentelling. Een mandaat stelt één of meerdere zetels voor en kan dus door meerdere mandatarissen ingevuld worden (org:holds).

Mandatarissen

Een mandataris is de representatie van het uitoefenen van een mandaat door een bepaalde persoon. Een mandataris is tijdsgebonden en heeft daarom een start- en einddatum. Deze datums stemmen niet noodzakelijk overeen met de datums van de legislatuur of de regeringsamenstelling. De bevoegdheden van een minister kunnen bijvoorbeeld wijzigen doorheen de tijd binnen dezelfde regeringsamentelling. Dit reflecteert zich in de data in een nieuwe mandataris-entiteit die nog steeds gelinkt is aan dezelfde regeringsamenstelling (prov:hadMember) en hetzelfde minister-mandaat (org:holds) als de vorige mandataris. Enkel de start- en einddatum en beleidsdomeinen van de mandataris zijn gewijzigd.

Om dus de exacte samenstelling van de regering op een specifiek tijdstip te bekomen, moet er een subset gemaakt worden van alle mandatarissen uit een regeringsamenstelling. De subset wordt gemaakt door te filteren op mandatarissen die een startdatum hebben vóór het specifieke tijdstip en een einddatum die ongedefinieerd is of valt na het specifieke tijdstip.

Levensboom van een dossier

Te vervolledigen.

Concept schemes en codelijsten

Voor sommige eigenschappen zijn er maar een beperkte set van waarden mogelijk (vb. het type van een agendapunt). Deze waarden worden gedefineerd in een codelijst: een gecontroleerde lijst van concepten. De modellering van deze codelijsten gebeurt doorgaans volgens de W3C SKOS vocabulary. Iedere mogelijke waarde is een skos:Concept. Tussen de concepten kunnen (hiërarchische) relaties gedefinieerd worden. Concepten kunnen samen geaggregeerd worden in een skos:ConceptScheme.

Hieronder wordt een overzicht gegeven van de codelijsten die beschikbaar zijn in de besluitvormingscatalogus. De codelijsten kunnen als aparte datasets in Turtle formaat gedownload worden of opgevraagd worden via het SPARQL endpoint. Ieder concept heeft ook een subject page. Andere datasets kunnen verwijzingen naar concepten uit de codelijsten bevatten, maar zullen zelf geen verdere eigenschappen van de concepten uit de codelijst ontsluiten. De codelijsten zijn dus een aanvulling bij de andere datasets.

Om alle concepten uit een concept scheme op te lijsten, kan volgende SPARQL query gebruikt worden:

PREFIX skos: <http://www.w3.org/2004/02/skos/core#>
SELECT *
WHERE {
  ?s a skos:Concept ;
     skos:inScheme <http://my-concept-scheme-uri.org> .
}

Dataset types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/e93481b2-342d-468b-8def-2d629232d3a5.

Een dcat:Dataset heeft een eigenschap dct:type waarmee het type van de dataset gespecifieerd kan worden. De codelijst van dataset types bevat volgende concepten:

Distribution types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/f27ae84d-fded-4ea5-a8f8-f4b98664214b.

Een dcat:Distribution heeft een eigenschap dct:type waarmee het type van de distribution gespecifieerd kan worden. De codelijst van distribution types bevat volgende concepten:

Activiteit types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/eabe9bb8-d4e1-409e-9132-2d09e5a89bef.

Een prov:Activity heeft een eigenschap dct:type waarmee het type van de activiteit gespecifieerd kan worden. De codelijst van activiteit types bevat volgende concepten:

Vergaderactiviteit types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/8030c0c4-aff1-4548-92d9-3299ebc43832.

Agendapunt types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/55c9120c-6a3d-49c4-80c8-ed01e9b92a9b.

Document types

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/559774e3-061c-4f4b-a758-57228d4b68cd.

Thema's

Al deze concepten zijn onderdeel van het concept scheme http://themis.vlaanderen.be/id/concept-scheme/459cbdb0-86ff-4106-879c-6aecda7d3dcc.