Hieronder staan de veranderingen die MAGDA gedaan heeft aan de DIV datastructuur om een OSLO ondersteuning te bieden.

Enkel het Titular en zijn onderliggen elementen - Person, Organisation en Address - zijn aangepast voor OSLO. Alle andere onderdelen zijn onveranderd overgenomen.

Context bestand

In de OSLO filosofie moet elk data element dat in het OSLO model gedefinieerd is een URI krijgen die de semantische context van dat element definieert. Deze URI’s worden zoveel mogelijk in een gelikt context bestand geplaatst welke bovenaan de payload gekoppeld is. Op dit moment gebruiken alle DIV REST diensten hetzelfde context bestand.

Structurele aanpassingen

Om de voldoen aan het OSLO model dienen bepaalde aanpassingen gedaan te worden aan de datastructuur die door DIV is aangeleverd.

Tekst elementen

In de OSLO filosofie dienen tekstuele elementen die kunnen vertaald worden vergezeld te zijn van een taal definitie. Om hieraan te voldoen zijn elementen, zoals de straatnaam niet van het type string maar van het type langString welke de tekst en de taal bevat.

Identificatoren

Rijksregister en KBO nummers identificeren respectievelijk een persoon en een onderneming. Deze elementen moeten van het type identificator zijn en hebben een identificator sub-element van het type string. Dit identificator sub-element is van het type string en bevat het rijksregister of KBO nummer

Object types

@type attribuut

Verschillende elementen in het Titular of CrossborderTitular object in de DIV structuren komen in het OSLO model overeen met een bepaald object type. Zo is een Titular een Agent en een

Een Titular of CrossborderTitular is in het OSLO model een Agent object met als subtypes Person voor het person element en Organisation voor het organisation element. Deze semantische bepaling wordt aangeduid met een @type attribuut. Dit attribuut zal voor dat element steeds dezelfde waarde bevatten.

@id attribuut

Een Titular of CrossborderTitular element kan een persoon of een organisatie zijn. In de relatie tussen die twee elementen aan te duiden en in JSON-LD deze twee datastructuren als 1 object te laten beschouwen is een koppeling nodig. Deze koppeling wordt gemaakt met een @id attribuut welke dezelfde waarde heeft bij het Titular en het Person of Organisation element.

Tussenliggende elementen

In het OSLO model heeft een persoon of een organisatie een eigenschap ContactInfo. Deze eigenschap bevat een Adres. Om het adres dus op een semantische manier aan de persoon of de organisatie te koppelen dient boven het adres een contactInfo element gezet te worden. Dit contactInfo en adres element hebben natuurlijk een @type attribuut om hun semantische betekenis en plaats in het OSLO vocabularium aan te duiden.

Aangepaste structuur

Het land element heeft in de DIV swagger een code en omschrijving welke respectievelijk de ISO code en naam van het land bevatten. In de OSLO structuur moet de naam van het land direct onder het Adres element staan. Om die reden zijn de landnaam en ISO code plat geslagen en rechtstreeks onder het adres element geplaatst. Om dezelfde reden zijn ook andere elementen verplaatst.

Aangepaste elementnamen

Om de OSLO URIs te kunnen koppelen aan specifieke elementen via het Context bestand dient de naam van het element uniek te zijn. Om deze reden zijn een aantal elementen zoals organisation.type hernoemt naar organisation.organisationType.

Op deze pagina

Binnen deze handleiding