Element cause

The element cause can be used to indicate the cause(s) of a situation component. If the cause is a situationRecord from another road manager, a cause type and a cause description are included under the element cause. For causes from the same road manager, the specialization ManagedCause is used.

These two methods both have their own elements.

Elements

Method 1 - Description and cause

A description and cause type are given of the cause of the situation component. Due to the limited domain, the inclusion of a ManagedCause (method 2) is preferred.

Element causeDescription

This element can be used to provide further explanation of the cause. This element is mandatory if the value “other” is used for causeType.

Type:	Mandatory	Domain
MultilingualString	see above	N/A

Element causeType

Represents a characterization of the cause.

Type:	Required	Domain
CauseTypeEnum	Yes	abnormalTraffic, accident, animalPresence, authorityOperation, constructionWork, disturbance, drivingConditions, environmentalObstruction, equipmentOrSystemFault, infrastructureDamageObstruction, instructionToRoadUsers, networkManagement, nonWeatherRelatedRoadConditions, obstruction, poorEnvironment, publicEvent, rerouting, roadMaintenance, roadOperatorServiceDisruption, roadOrCarriagewayOrLaneManagement, roadsideAssistance, road sideServiceDisruption, speedManagement, transitServiceDisruption, vehicleObstruction, weatherRelatedRoadConditions, winterEquipmentManagement, earlierEvent, earlierIncident, holidayTraffic, problemsAtBorderPost, problemsAtCustomPost, problemsOnLocalRoads, roadsideEvent, rubberNecking, technicalProblems, vandalism, other

Example

Element cause

Het element cause kan gebruikt worden om de oorza(a)k(en) van een situatieonderdeel aan te geven. Indien de oorzaak een situationRecord van een andere wegbeheerder dan wordt een oorzaaktype opgenomen en een oorzaakbeschrijving onder het element cause. Bij oorzaken van dezelfde wegbeheerder wordt gebruikt gemaakt van de specialisatie ManagedCause.

Deze twee methoden hebben allebei weer hun eigen elementen.

Elementen

Methode 1 - Beschrijving en oorzaak

Er wordt een beschrijving en oorzaaktype gegeven van de oorzaak van het situatieonderdeel. Vanwege het beperkte domein geniet het opnemen van een ManagedCause(methode 2) de voorkeur.

Element causeDescription

Met dit element kan een nadere toelichting gegeven worden op de oorzaak. Dit element is verplicht indien er bij causeType de waarde “other” wordt gebruikt.

Type:	Verplicht	Domein
MultilingualString	zie hierboven	NVT

Element causeType

Geeft een typering van de oorzaak weer.

Type:	Verplicht	Domein
CauseTypeEnum	Ja	abnormalTraffic, accident, animalPresence, authorityOperation, constructionWork, disturbance, drivingConditions, environmentalObstruction, equipmentOrSystemFault, infrastructureDamageObstruction, instructionToRoadUsers, networkManagement, nonWeatherRelatedRoadConditions, obstruction, poorEnvironment, publicEvent, rerouting, roadMaintenance, roadOperatorServiceDisruption, roadOrCarriagewayOrLaneManagement, roadsideAssistance, roadsideServiceDisruption, speedManagement, transitServiceDisruption, vehicleObstruction, weatherRelatedRoadConditions, winterEquipmentManagement, earlierEvent, earlierIncident, holidayTraffic, problemsAtBorderPost, problemsAtCustomPost, problemsOnLocalRoads, roadsideEvent, rubberNecking, technicalProblems, vandalism, other

Voorbeeld

XML Voorbeeld

<sit:cause>
  <sit:causeDescription>
    <com:values>
      <com:value lang="nl">Leggen van kabels en leidingen</com:value>
    </com:values>
  </sit:causeDescription>
  <sit:causeType>other</sit:causeType>
</sit:cause>

Methode 2 - Element managedCause

De werkelijke verwijzing naar een situationRecord met betrekking tot de oorzaak is gecodeerd in het verplichte element managedCause. Dit element heeft geen subelementen, de relatie wordt uitgedrukt in de vorm van drie verplichte attributen.

Attribuut id

Id van het van toepassing zijnde situationRecord.

Type:	Verplicht	Domein
String	Ja	Geldige id

Attribuut version

Het attribuut version verwijst naar de versie van het situationRecord waarna verwezen wordt. Hiermee is het mogelijk een rechtstreekse koppeling te maken tussen de specifieke versies van een situationRecord. Indien de verwijzing gebruikt wordt om enkel een koppeling aan te geven tussen situatieRecords dient de waarde 'last' gebruikt te worden. Met deze waarde wordt aangegeven dat de meest recente versie van de gerelateerde situatieRecord bedoeld wordt.

Type:	Verplicht	Domein
String	Ja	Zie hierboven

Attribuut targetClass

Waarde waarmee de klasse wordt benoemd waar naar verwezen wordt.

Type:	Verplicht	Domein
String	Ja	sit:SituationRecord

Voorbeeld managedCause

XML Voorbeeld

<sit:cause>
  <sit:managedCause>
    <sit:objectReference id="NDW06_ff8e36ff-b75c-4c49-bd69-70a5b32ab930_2" targetClass="sit:SituationRecord" version="last"/>
  </sit:managedCause>
</sit:cause>

Method 2 - Element managedCause

The actual reference to a situationRecord with respect to the cause is encoded in the mandatory element managedCause. This element has no subelements, the relationship is expressed in the form of three mandatory attributes.

Attribute id

Id of the applicable situationRecord.

Type:	Mandatory	Domain
String	Yes	Valid id

Attribute version

The attribute version refers to the version of the situationRecord that is being referred to. This makes it possible to create a direct link between the specific versions of a situationRecord. If the reference is used to indicate a link between situationRecords only, the value 'last' should be used. This value indicates that the most recent version of the related situationRecord is meant.

Type:	Mandatory	Domain
String	Yes	See above

Attribute targetClass

Value used to name the class being referenced.

Type:	Mandatory	Domain
String	Yes	sit:SituationRecord

Example managedCause

``` xml
<sit:cause>
  <sit:managedCause>
    <sit:objectReference id="NDW06_ff8e36ff-b75c-4c49-bd69-70a5b32ab930_2" targetClass="sit:SituationRecord" version="last"/>
  </sit:managedCause>
</sit:cause>
```

Go back to the previous page