AWV Object

Dit document beschrijft een implementatiemodel, in dit geval AWV Object. Een implementatiemodel is een toepassing van vocabularia voor een concreet doel. Het beschrijft in alle detail (zoals kardinaliteiten, codelijsten, datatypes, ...) de gewenste datastructuur.

Samenvatting

Dit is een implementatiemodel op bestaande vocabularia m.b.t. (weg)aanhorigheden waaronder:

Status van dit document

Dit implementatiemodel dient om het specifieke gebruik van de entiteiten relevant voor de beschreven applicatie te verduidelijken.

Dit document werd gepubliceerd als Kandidaat-standaard. De specificatie zoals in dit document beschreven doorloopt momenteel een periode van publieke review, tijdens het welke geen wijzigingen aan deze specificatie worden doorgevoerd.
Dit document is bedoeld om uit te groeien tot een standaard in het beschreven domein. Desalniettemin heeft het op dit ogenblik geen officieel statuut en vertegenwoordigt het geen consensus binnen OSLO.

Feedback, een vraag of een melding van een probleem op deze specificatie kan gegeven worden via ons contactformulier.

Licentie

Deze specificatie van Informatie Vlaanderen is gepubliceerd onder de "Modellicentie Gratis Hergebruik - v1.0".

Conformiteit

Een implementatiemodel is een specificatie voor gegevensuitwisseling dat bijkomende beperkingen introduceert voor het toepassen van vocabularia. Dergelijke bijkomende beperkingen kunnen de volgende elementen bevatten:

  • verfijning van de terminologie (klassen en eigenschappen) consistent met de semantiek uit de betreffende specificaties met een welbepaald gebruik als doel;
  • externe terminologie (klassen en eigenschappen) gebruikt voor nieuwe/extra termen die niet in de bestaande vocabularia voorkomen.

Om conform te zijn met dit implementatiemodel, geldt voor een implementatie dat ze:

  • MOET Voor elke klasse steeds de eigenschappen bevatten die als minimum kardinaliteit 1 hebben.
  • MAG NIET meer dan 1 instantie bevatten van eigenschappen die 1 als maximum kardinaliteit hebben.
  • MAG terminologie (klassen en eigenschappen) gebruiken op een manier die consistent is met haar semantiek (definitie, gebruik, domein en bereik).
  • MAG NIET terminologie van andere gecontroleerde vocabularia gebruiken dan diegene die gedefinieerd wordt in dit implementatiemodel.
  • MAG uitgebreid worden met klassen en eigenschappen van andere datamodellen (vocabularia) die niet overlappen met terminologie uit dit implementatiemodel.

Overzicht

In dit document wordt correct gebruik van de volgende entiteiten toegelicht:
| AWV naam object | AWV naampad object | AWV object | Bevestiging | Derdenobject | EM-infra levenscyclus | EM-infra toezicht | Sturing | Voedt |

In dit document worden de volgende datatypes toegelicht:
| AWV-identificator | Bestandsbijlage | Boolean | Datum | Datumtijd | Decimaal getal | Kwantitatieve waarde in Volt | Literal | String | Tekstblok | URI |

Entiteiten

AWV naam object

Beschrijving
Abstracte als de basisklasse voor elk OTL object dat benoemd wordt met een mensleesbare identificator.
Subklasse van
AWV object
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: naam.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
naam String 1 De mensleesbare naam van een AWVObject zoals dit bv. ook terug te vinden is op een etiket op het object zelf. AWV kent deze naam toe of geeft de opdracht om deze toe te kennen. Indien een object een algemeen gangbare naam heeft zoals bv. bij een waterloop dan wordt deze gebruikt.

AWV naampad object

Beschrijving
Abstracte als de basisklasse voor elk OTL object dat gebruik maakt van een naampad.
Subklasse van
AWV naam object
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: naampad.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
naampad String 1 Een set van objecten (bv. collecties) die aanduiden waar het object zich bevindt in de objectenboom (EM-Infra).

AWV object

Beschrijving
Abstracte als de basisklasse (super class) voor alle uniek geïdentificeerde OTL objecten met de basiseigenschappen die elk OTL object minstens heeft.
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: bevestiging, datum oprichting object, id, notitie, sturing, uri type, voedt.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
bevestiging Derdenobject Deze relatie geeft aan dat twee onderdelen direct fysiek op elkaar bevestigd zijn. Dit kan zowel aan de buitenkant als aan de binnenkant zijn zoals bv. een camera aan een paal of een laagspanningsbord in een kast. Deze relatie heeft geen richting.
datum oprichting object Datum 1 Datum van de oprichting van het object
id AWV-identificator 1..* De identificator van het object. Zodra een object bestaat binnen de omgeving van AWV moet de id gebruikt worden zoals die daar gekend is. Bij aanlevering van nieuwe objecten wordt een lokale-id (zoals gekend bij de aannemer) ingevuld.
notitie String 1 Extra notitie voor het AWV object.
sturing Derdenobject Deze relatie geeft aan of er een of andere vorm van dataverkeer is tussen 2 onderdelen. Een wegverlichtingstoestel dat aan staat wordt ook als sturing beschouwd, in dit geval is het een lang ononderbroken elektrisch aan-signaal. Deze relatie heeft geen richting.
uri type URI 1 De URI van het AWV Object volgens https://www.w3.org/2001/XMLSchema#anyURI .
voedt Derdenobject Deze relatie wordt enkel gelegd naar onderdelen die permanent onder spanning staan in normaal bedrijf. Aan deze relatie wordt steeds een richting toegekend van de voedinggever naar de ontvanger.

Bevestiging

Beschrijving
Deze relatie geeft aan dat twee onderdelen direct fysiek op elkaar bevestigd zijn. Dit kan zowel aan de buitenkant als aan de binnenkant zijn zoals bv. een camera aan een paal of een laagspanningsbord in een kast. Deze relatie heeft geen richting.
Eigenschappen
Voor deze entiteit zijn geen eigenschappen gedefinieerd.

Derdenobject

Beschrijving
Object niet in eigendom van AWV maar verbonden met een object van AWV.
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: bevestiging, contactgegevens, foto, heeft aansluitkast geintegreerd, omschrijving, sturing, voedt.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
bevestiging AWV object Deze relatie geeft aan dat twee onderdelen direct fysiek op elkaar bevestigd zijn. Dit kan zowel aan de buitenkant als aan de binnenkant zijn zoals bv. een camera aan een paal of een laagspanningsbord in een kast. Deze relatie heeft geen richting.
contactgegevens String 1 Naam, voornaam, telefoonnummer en/of e-mailadres van de contactpersoon.
foto Bestandsbijlage 1..* Een foto van het derdenobject die eventuele detailinformatie weergeeft Enkel bestanden die een foto zijn.
heeft aansluitkast geintegreerd Boolean 1 Aanduiding of de aansluitkast geïntegreerd is.
omschrijving String 1 Omschrijving van het derdenobject
sturing AWV object Deze relatie geeft aan of er een of andere vorm van dataverkeer is tussen 2 onderdelen. Een wegverlichtingstoestel dat aan staat wordt ook als sturing beschouwd, in dit geval is het een lang ononderbroken elektrisch aan-signaal. Deze relatie heeft geen richting.
voedt AWV object Deze relatie wordt enkel gelegd naar onderdelen die permanent onder spanning staan in normaal bedrijf. Aan deze relatie wordt steeds een richting toegekend van de voedinggever naar de ontvanger.

EM-infra levenscyclus

Beschrijving
Abstracte die de attributen toevoegt die nodig zijn voor de levenscyclus van een object zoals gebruikt binnen EM-infra.
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: status, toestand.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
status EM-infra status 1 TODO Link
toestand Em-infra toestand 1 TODO Link

EM-infra toezicht

Beschrijving
Abstracte die de attributen toevoegt die nodig zijn voor toezicht zoals gebruikt binnen EM-infra.
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: toezichter, toezichtsgroep.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
toezichter String 1 TODO
toezichtsgroep String 1 TODO

Sturing

Beschrijving
Deze relatie geeft aan of er een of andere vorm van dataverkeer is tussen 2 onderdelen. Een wegverlichtingstoestel dat aan staat wordt ook als sturing beschouwd, in dit geval is het een lang ononderbroken elektrisch aan-signaal. Deze relatie heeft geen richting.
Eigenschappen
Voor deze entiteit zijn geen eigenschappen gedefinieerd.

Voedt

Beschrijving
Deze relatie wordt enkel gelegd naar onderdelen die permanent onder spanning staan in normaal bedrijf. Aan deze relatie wordt steeds een richting toegekend van de voedinggever naar de ontvanger.
Eigenschappen
Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: aansluitvermogen.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
aansluitvermogen Kwantitatieve waarde in Volt 1 Vermogen van de aansluiting, dit wordt enkel ingevuld op voedingsrelaties voorbij de hoofdschakelaar.

Datatypes

AWV-identificator

Beschrijving
Complex datatype voor de identifictor van het AWV-object.
Eigenschappen
Voor dit datatype zijn de volgende eigenschappen gedefinieerd: identificator, toegekend door, toegekend op.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
identificator String 1 Een groep van tekens om een AWV object te identificeren of te benoemen.
toegekend door String 1 Gegevens van de organisatie die de toekenning deed.
toegekend op Datumtijd 1 De datum wanneer de toekenning werd uitgevoerd.

Bestandsbijlage

Beschrijving
Complex datatype voor alle bestandsbijlages
Eigenschappen
Voor dit datatype zijn de volgende eigenschappen gedefinieerd: bestandsnaam, mime-type, omschrijving, uri.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
bestandsnaam String 1 De naam van het Document inclusief de bestandsextensie, van de naam gescheiden door een punt.
mime-type Mimetype 1 Het MIME type van het document. Link
omschrijving Tekstblok 1 Een korte toelichting over waar het document juist voor dient.
uri URI 1 De verwijzing naar de bestandslocatie via een link. Bij lokale bestanden kan dit eventueel ook een pad zijn.

Boolean

Beschrijving
Beschrijft een boolean volgens http://www.w3.org/2001/XMLSchema#boolean
Gebruik
http://www.w3.org/2001/XMLSchema#boolean
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

Datum

Beschrijving
Beschrijft een datum volgens http://www.w3.org/2001/XMLSchema#date
Gebruik
http://www.w3.org/2001/XMLSchema#date
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

Datumtijd

Beschrijving
Beschrijft een datumtijd volgens http://www.w3.org/2001/XMLSchema#dateTime
Gebruik
http://www.w3.org/2001/XMLSchema#dateTime
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

Decimaal getal

Beschrijving
Beschrijft een decimaal getal volgens http://www.w3.org/2001/XMLSchema#decimal
Gebruik
http://www.w3.org/2001/XMLSchema#decimal
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

Kwantitatieve waarde in Volt

Beschrijving
Een kwantitatieve waarde die een getal in Volt uitdrukt.
Eigenschappen
Voor dit datatype zijn de volgende eigenschappen gedefinieerd: standaard eenheid, waarde.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
standaard eenheid Literal 1 De standaard eenheid bij dit datatype is uitgedrukt in Volt. "V"^^cdt:ucumunit
waarde Decimaal getal 1 Bevat een getal die bij het datatype hoort.

Literal

Beschrijving
Beschrijft een constante.
Gebruik
http://www.w3.org/2000/01/rdf-schema#Literal
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

String

Beschrijving
Beschrijft een tekstregel volgens http://www.w3.org/2001/XMLSchema#string
Gebruik
http://www.w3.org/2001/XMLSchema#string
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

Tekstblok

Beschrijving
Een tekst welke uit meerdere zinnen bestaat, en ook regeleindes kan bevatten. Een tekstblok bevat maximaal 65.000 karakters.
Eigenschappen
Voor dit datatype zijn de volgende eigenschappen gedefinieerd: waarde.
Eigenschap Verwacht Type Kardinaliteit Beschrijving Gebruik Codelijst
waarde String 1 De string welke uit meerdere zinnen bestaat, en ook regeleindes kan bevatten. Een tekstblok bevat maximaal 65.000 karakters.

URI

Beschrijving
Een tekstwaarde die een verwijzing naar meer informatie van het element bevat volgens http://www.w3.org/2001/XMLSchema#anyURI .
Gebruik
http://www.w3.org/2001/XMLSchema#anyURI
Eigenschappen
Voor dit datatype zijn geen eigenschappen gedefinieerd.

SQLite download

Een herbruikbare SQLite database van alle implementatiemodellen is terug te vinden op: SQLite download

JSON-LD context

(niet normatief)

Een herbruikbare JSON-LD context definitie voor dit implementatiemodel is terug te vinden op: /doc/implementatiemodel/awv-object/ontwerpdocument/v28/context/awv-object.jsonld

SHACL template

(niet normatief)

Een herbruikbare SHACL template definitie voor dit implementatiemodel is terug te vinden op: /doc/implementatiemodel/awv-object/ontwerpdocument/v28/context/awv-object-SHACL.ttl