Innhold

Kalender-objekter

Definisjon av dager, dagtyper, operasjonelle perioder og andre kalendar-objekter, samt tilknytninger mellom disse, gjøres i en Service Calendar. Disse definisjonene brukes videre i oppsett av (hovedsakelig) Timetable, for å spesifisere når en Line betjenes.

Lenke

Hele XML eksempelfilen ligger på prosjektets GitHub-repository: https://github.com/entur/profile-norway-examples/blob/master/netex/schedule/ServiceCalendar-example.xml

Elementer

Under følger en nærmere beskrivelse av de viktigste elementene ved modellering av kalender-objekt.

Merk at dette kun er en forenklet oppbygning av NeTEx-XML. I henhold til norsk profil må det være med flere elementer for at filen skal være gyldig for dataoverføring til holdeplassregisteret.

Se eksempel for enkelt stoppested, buss for XML som inneholder andre nødvendige elementer for å være gyldig i henhold til profilen.

PublicationDelivery

Alle XML-filer etter norsk NeTEx-profil skal være av type PublicationDelivery som inneholder relevante Frames. (Se GitHub for komplett eksempel.)

Beskrivelse av dummy ServiceFrame og TimetableFrame i eksempelet er kun gjort for å indikere en komplett PublicationDelivery.

ServiceCalendarFrame

Alle kalender-objekter er definert i en ServiceCalendarFrame. Det kan gjøres i et ServiceCalendar-objekt, men gitt at de fleste komponentene ofte skal gjenbrukes på tvers av timeplaner anbefales det å definere disse direkte i ServiceCalenderFrame. 

<ServiceCalendarFrame version="any" id="RUT:ServiceCalendarFrame:1">
	<ServiceCalendar version="any" id="RUT:ServiceCalendar">
		<Name>Ukedager</Name>
		<FromDate>2016-04-01</FromDate>
		<ToDate>2016-08-31</ToDate>
	</ServiceCalendar>
[...]

dayTypes

Definisjon av type dag ved hjelp av hvilke ukedager dagtypen gjelder. Typen kan presiseres nærmere med ytterligere egenskaper, f.eks. ferie-type, hvis relevant.

<dayTypes>
	<DayType version="any" id="RUT:DayType:weekdays">
		<Name>Ukedager</Name>
		<properties>
			<PropertyOfDay>
				<DaysOfWeek>Monday Tuesday Wednesday Thursday Friday</DaysOfWeek>
			</PropertyOfDay>
		</properties>
	</DayType>
	[...]
</dayTypes>

timebands

Timeband viser tidsangivelse.

<timebands>
	<Timeband version="any" id="RUT:Timeband:TM15">
		<!--Name>15 minutes past the hour</Name-->
		<StartTime>00:15:00</StartTime>
		<EndTime>00:15:00</EndTime>
	</Timeband>
</timebands>

operatingDays

Spesifisering av en operasjonsdag, evt. også start og lengde for en operasjonsdag. Kan knyttes til en dagtype v.h.a. 637370378.

<operatingDays>
	<OperatingDay version="any" id="RUT:OperatingDay:default:1">
		<CalendarDate>2016-05-01</CalendarDate>
		<EarliestTime>10:10:00</EarliestTime>
		<DayLength>PT12H45M</DayLength>
	</OperatingDay>
	<OperatingDay version="any" id="RUT:od:default:2">
		<CalendarDate>2016-07-07</CalendarDate>
		<EarliestTime>11:11:00</EarliestTime>
		<DayLength>PT9H10M</DayLength>
	</OperatingDay>
</operatingDays>

operatingPeriods

Spesifisering av en operasjonsperiode, med basis i tidligere definerte start- og slutt-dager.

<operatingPeriods>
	<OperatingPeriod version="any" id="RUT:op:default">
		<FromOperatingDayRef ref="RUT:OperatingDay:default:1"/>
		<ToOperatingDayRef ref="RUT:od:default:2"/>
	</OperatingPeriod>
</operatingPeriods>

dayTypeAssignments

Knytning av en dagtype til en spesifikk dato eller pre-definert OperatingDay/-Period for en gitt kalender, dvs. en dagtype vil være gyldig innenfor tidsrommet spesifisert av kalenderobjektet den tilknyttes.

<dayTypeAssignments>
	[...]
	<DayTypeAssignment version="any" order="1" id="RUT:DayTypeAssignment:period">
		<OperatingPeriodRef ref="RUT:OperatingPeriod:default"/>
		<DayTypeRef version="any" ref="RUT:DayType:weekdays"/>
	</DayTypeAssignment>
</dayTypeAssignments>