# Datamodel V2 (vanaf 13/04/2026)

Kort samengevat is Open Proces Huis (OPH\*) een grote database met processen. Elk proces is toegevoegd door een lokale overheid of via een van onze leveranciers.

Wanneer u de beschikbare gegevens in OPH bekijkt, ziet u specifieke gegevens die door de applicatie zelf zijn toegevoegd en andere die zijn toegevoegd door gebruikers binnen een lokaal bestuur of door een leverancier via een OPH-integratie. We gaan dieper in op hoe de gegevens zijn gestructureerd.

## Data

* Interne proces data
* Data door invoer van gebruikers via de OPH applicatie of door leveranciers d.m.v. onze integraties
* Geïmporteerd data vanuit externe bronnen

### Interne data

{% hint style="info" %}
Open Proces Huis is de enige bron van de door hier besproken procesgegevens (met uitzondering van groepsrecords, zie Gebruikersgegevens - Waar?).
{% endhint %}

Procesgerelateerde gegevens worden altijd gegenereerd door acties van een gebruiker.\
Om een proces aan te maken, moet een gebruiker een BPMN-bestand uploaden. Standaard wordt de titel van het proces ingesteld op de titel van het bestand, maar zonder de extensie .bpmn. De titel van het proces kan indien gewenst worden gewijzigd in Open Proces Huis. De titel van het bestand blijft zoals deze was bij het uploaden. De beschrijving van het proces kan achteraf worden ingesteld.

Telkens wanneer een BPMN-bestand wordt geüpload (hetzij bij het aanmaken van een nieuw proces, hetzij bij het bijwerken van een bestaand proces), wordt de openproceshuis-bpmn-service in werking gezet. Deze genereert en slaat de BBO-triples op, evenals de links naar het oorspronkelijke BPMN-bestand en de groep van de gebruiker.

{% embed url="<https://github.com/lblod/openproceshuis-bpmn-service>" %}
openproceshuis-bpmn-service
{% endembed %}

### Data invoer door gebruikers

Alle procesgerelateerde gegevens zijn afkomstig van gebruikers. Daarom heeft *OPH* de nodige gegevens nodig om gebruikers te laten inloggen, evenals organisatorische gegevens om de koppeling tussen gebruikers en processen te kunnen leggen.

\
Een **gebruiker** heeft een *voornaam*, een *achternaam*, een of meer *accounts* en een of meer *groepen/besturen*.\
Een **account** bevat de gegevens die nodig zijn om een gebruiker in te loggen. In OPH kan dit gebeuren via *ACM/IDM*.\
Een **groep/bestuur** (d.w\.z. administratieve organisatie) heeft een *naam*, een *classificatie* en een primaire *locatie*.\
De **classificatie** geeft het type groep/bestuur aan (bijv. gemeente of OCMW).\
De **primaire locatie** beschrijft de locatie van waaruit een groep/bestuur opereert.

{% hint style="danger" %}
Let op het verschil tussen het e-mailadres van de groep/het bestuur (te vinden in de contactgegevens op de primaire website) en het e-mailadres van het proces. Het eerste adres staat vast en is mogelijk te algemeen voor vragen/opmerkingen over een enkel proces, terwijl het laatste adres handmatig kan worden ingesteld en directer naar de persoon leidt die verantwoordelijk is voor het proces.
{% endhint %}

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2FhLzvbqzXDFhNsviL5wUC%2Fimage.png?alt=media&#x26;token=ef4a129d-98fb-4f51-b836-578f76527c97" alt=""><figcaption><p>User data model</p></figcaption></figure>

{% hint style="info" %}
Het gebruikersgegevensmodel komt overeen met de manier waarop gebruikersgegevens worden opgeslagen in andere LBLOD-toepassingen. Het is gebaseerd op het [Besluit Publicatie OSLO-toepassingsprofiel](https://data.vlaanderen.be/doc/applicatieprofiel/besluit-publicatie/) en maakt gebruik van elementen uit de [Persoon OSLO-vocabulaire](https://data.vlaanderen.be/ns/persoon/).
{% endhint %}

### Externe bronnen

Ook gegevens uit Organisatie Portaal (OP) worden gebruikt in OPH. De applicatie gebruikt de LBLOD delta consumer om gebruikersgegevens te importeren. Aangepaste configuraties geven aan welke delen van die oorspronkelijke gegevens moeten worden opgeslagen in de OPH triplestore. Eén configuratie wordt gebruikt voor de eerste invoer (bij de eerste start van de applicatie), een andere wordt gebruikt voor delta-berichten (deze beschrijven verwijderingen, toevoegingen of updates van de oorspronkelijke gegevens).

{% embed url="<https://github.com/lblod/delta-consumer>" %}
delta-consumer
{% endembed %}

{% hint style="info" %}
OP biedt meer gegevens dan daadwerkelijk in OPH worden opgenomen. De consument is zo geconfigureerd dat alleen de gegevens worden opgenomen die hij nodig heeft. Voor alle duidelijkheid: alle gegevens die in het gebruikersgegevensmodel worden beschreven, worden daadwerkelijk opgenomen en zijn dus aanwezig in de triplestore van OPH.
{% endhint %}

Bij de initialisatie van de triplestore worden de OP-gegevens toegevoegd aan de applicatie.\
Gedurende de levensduur van de applicatie haalt de delta-consumer met regelmatige tussenpozen de nieuwste delta-berichten op (indien aanwezig). OPH is geconfigureerd om dit elke minuut te doen.

## Proces

Terwijl we aan het uitzoeken waren welke URI we voor onze processen moesten gebruiken, hebben we gekeken naar de OSLO-standaard `https://data.vlaanderen.be/ns/proces#`, maar deze URI bestond nog niet. Daarom zijn we op zoek gegaan naar een geschikte klasse. We hebben gekozen voor <https://w3id.org/dpv#Process> omdat deze ontologie het beste bij ons gebruiksscenario past. **Van de DPV-pagina:**"*The motivation of DPV is to provide a 'data model' or an 'ontology' of concepts for interoperable representation and exchange of information about processing of (personal) data and the use of technologies. For this, the DPV specification defines concepts and relationships using the \[*[*RDF*](https://w3c.github.io/dpv/2.1/dpv/#bib-rdf)*] standard, and which can additionally be implemented and applied using technologies appropriate to a use-case's specific requirements."*

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2F1wv9rruFPIJpSceykgAE%2Fimage.png?alt=media&#x26;token=a85b4312-ec9f-4ae7-a9c4-62f20ab5e48b" alt=""><figcaption></figcaption></figure>

Het procesdiagram bestaat uit één of meerdere bestanden. Deze bestanden zijn niet rechtstreeks gekoppeld aan het proces zelf. Hier hebben we een abstractielaag toegevoegd, zodat we bestanden kunnen hergebruiken en een structuur kunnen creëren voor alle geüploade bestanden. Structurering kan handig zijn wanneer je één hoofddiagram hebt met meerdere subprocessen (diagrammen).

Het is enkel toegelaten om `.bpmn` en `.vsdx` (visio) bestanden te gebruiken als diagram voor een proces.  Elk BPMN-bestand wordt bewaard zoals het is, maar de inhoud ervan wordt ook opgeslagen als gekoppelde gegevens. Een BPMN-bestand bevat een of meer BPMN-processen, waarbij elk BPMN-proces meerdere BPMN-elementen bevat. De [BPMN Based Ontology (BBO)](https://www.irit.fr/recherches/MELODI/ontologies/BBO/index-en.html) wordt gebruikt om al deze BPMN-processen en BPMN-elementen weer te geven als gekoppelde gegevens.

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2FbY3M1WHIfLZJyseS2DFb%2Fimage.png?alt=media&#x26;token=0db6bf91-5494-4d2b-ab18-d9769b6af2b2" alt=""><figcaption></figcaption></figure>

<a href="datamodel-v2-vanaf-13-04-2026/applicatie-profielen/proces" class="button primary" data-icon="arrow-right-long">Proces Applicatie Profiel</a>

## Diagram Lijst

Binnen het datamodel fungeert een Process als de overkoepelende entiteit die één of meerdere diagram lijsten kan bezitten. Deze lijsten dienen als een organisatorische tussenlaag: ze bevatten een verzameling van individuele items die elk direct gekoppeld zijn aan een specifiek bestand. Deze opzet biedt de flexibiliteit om een proces aan een lijst te koppelen, terwijl die lijst de connectie is naar een reeks bestanden.

Het doel van deze structuur zit in de onderlinge verbondenheid van de items. Elk item kan namelijk weer naar meerdere andere items verwijzen, waardoor er organisch een subproces structuur ontstaat. Om de entiteit lichtgewicht en performant te houden, is de data per item beperkt tot de essentie: de positie in de lijst, de referentie naar het bestand en de links naar onderliggende items.

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2FR2KNHTjQ0b2ojUqjwi3z%2Fimage.png?alt=media&#x26;token=f98dd650-615b-4b7f-a4bd-2ab093c45349" alt=""><figcaption></figcaption></figure>

<a href="datamodel-v2-vanaf-13-04-2026/applicatie-profielen/diagram-lijst" class="button primary">Diagram Applicatie Profiel</a>

## Inventaris Proces

De inventaris van OPH bevat een reeks processen die niet worden geïmplementeerd, zogenaamde conceptuele processen. Ze hebben alleen een titel en zijn toegewezen aan een categorie, domein en groep. De inventaris is beschikbaar voor alle gebruikers, maar wordt uitsluitend beheerd door beheerders. Gebruikers die deel uitmaken van een lokaal bestuur kunnen een regulier proces markeren als een instantie van een inventaris proces dat in de inventaris bibliotheek is opgenomen.

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2FMvmXkGKaAFq8bDNaHs1n%2Fuitbreiding.jpg?alt=media&#x26;token=839ab555-4eeb-431f-b8a6-163766051e91" alt=""><figcaption></figcaption></figure>

<a href="datamodel-v2-vanaf-13-04-2026/applicatie-profielen/inventaris-proces" class="button primary" data-icon="arrow-right-long">Inventaris Proces Applicatie Profiel</a>

## Informatie Classificatie

Informatieclassificatie (*ICR\*)* helpt bij het classificeren van entiteiten zodat u de nodige maatregelen kan nemen om uw gegevens te beschermen. Een classificatie geeft meer inzicht in de beschikbaarheid, integriteit en vertrouwelijkheid van informatie en of deze persoonlijke, gevoelige of professionele informatie bevat.

Een IC&#x52;*\** kan alleen worden toegevoegd aan een proces dat is gemarkeerd als een ‘blauwdruk’. Een blauwdruk is een gestandaardiseerd proces dat alleen kan worden goedgekeurd door beheerders van ABB of Digitaal Vlaanderen. Om als blauwdruk te worden gekwalificeerd, wordt een proces onderworpen aan een strenge evaluatie op basis van een aangepast cyberbeveiligingskader. Zodra een proces officieel als blauwdruk is gemarkeerd, worden er aanvullende metagegevens toegewezen, waarin de resultaten van deze beoordeling worden vastgelegd.

<figure><img src="https://1215024363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsmCwNfbW4ier30bqNiE7%2Fuploads%2FhTheZfMCzn4dhFFVpms1%2Fimage.png?alt=media&#x26;token=c8bdff59-ae82-4bb8-b885-a0e72ae48850" alt=""><figcaption></figcaption></figure>

<a href="datamodel-v2-vanaf-13-04-2026/applicatie-profielen/informatie-classificatie" class="button primary" data-icon="arrow-right-long">Informatie Classificatie Applicatie Profiel</a>