Page Comparison

• xCal versjon 2.0 skal benyttes

• Obligatorisk informasjon for xcal:vcalendar(gjelder pr. kalender/timebok)

  • Versjon av iCalendar standarden som benyttes (xcal:version)

  • Produktidentifikasjon av det produktet som genererte iCalendar objektet (xcal:prodid)

• Obligatorisk informasjon for xcal:vevent (gjelder pr. timetimeavtale)

  • Starttidspunkt for time (xcal:dtstart)

  • Sluttidspunkt for time (xcal:dtend)

  • Id for hver time på formatet UUID (xcal:uid)

  • HER-id for aktøren kommunikasjonspart som timen tilhører (xcal:contact). Denne er nødvendig for å vite mottager for operasjoner som er tilgjengelig på en timeavtale, slik som avbestilling for en mottatt avtale.

• Valgfri informasjon som kan benyttes i xcal:vevent

  • Id for timeavtalen som et tidspunkt tilhører på formatet UUID relatert timeavtale (xcal:related-to), skal oppgis dersom denne id-en eksisterer. Denne benyttes i to tilfeller:(id-en vil gjerne først eksistere når en timereservasjon bekreftes av EPJ slik at en timeavtale oppstår). Denne verdien skal beholdes når det gjøres endring av tidspunktet for en timeavtale. Related-to anvendes typisk når UID peker på en avtale/slot of time, ikke direkte på timeinstansen i EPJ

    • Ved timebestilling i timebok henter Helsenorge ledige tidspunkt (slot) fra timebok og sender en forespørsel om en av disse. Timeavtalen opprettes i timebok. related-to skal ha verdien til sloten som Helsenorge sendte bestilling på, og uid settes til id til timeavtalen som ble bekreftet.

    • Dersom det gjøres endringer på timeavtaler, der det opprettes en ny instans av timeavtalen skal related-to peke på opprinnelig avtale. Dette gjør det mulig for Helsenorge å identifisere avtalen som endret.

  • Categories (xcal:categories). Benyttes for å angi timetype, se eget avsnitt kategorisering av avtaler. 

  • Emne (xcal:summary). Benyttes for å angi oppsummering av avtale. For hjemmebaserte tjenester navn på tjenesten som utføres, f.eks. «Praktisk Bistand» eller «Hjemmesykepleie»

  • Beskrivelse (xcal:description): Angir fritekstinformasjon om avtalen

  • Regelmessighet. Gjentagelse brukt ved planlagte besøk og eventuelle unntak fra gjentagelse, bruk av Rrule element. Støttes kun for hjemmebesøk

  • Sted (xcal:location). Angivelse av sted avtalen finner sted.

  • Status (xcal:status). Angivelse av status for avtalen

  • Avlysningsårsak (xcal:x-cancellation-reason). Angir hvorfor en avtale har status avlyst

  • Attendee (xcal:attendee) Angivelse av deltagere i avtalen, benyttes blant annet for ansatte som utfører besøk

  • Organizer (xcal:organizer) Angivelse av hvem som utfører avtalen, benyttes for organisasjon som utfører besøk

  • Forventet varighet (xcal:x-expected-duration) Angivelse av forventet varighet for besøk som inngår i en tidsgruppe. Benyttes kun for hjemmebesøk, se egen beskrivelse for bruk.

  • Tidspunkt avtalen tilgjengeliggjøres (xcal:x-available-at) Angivelse av tidspunkt avtalen tilgjengeliggjøres eller gjøres valgbar for innbygger. Benyttes ved visning av ledige tidspunkt for timebestilling, ikke relevant for annen bruk.

XML eksempel på iCalendar med svar fra fastlegen vedørende bekreftelse av reservasjon av en time:

<xcal:vcalendar>
	<xcal:properties>
		<xcal:prodid>
			<xcal:text>System NN</xcal:text>
		</xcal:prodid>
		<xcal:version>
			<xcal:text>2.0</xcal:text>
		</xcal:version>	
	</xcal:properties>
	<xcal:components>
		<xcal:vevent>
			<xcal:properties>
				<xcal:dtstart>
					<xcal:date-time>2012-02-13T09:15:00</xcal:date-time>
				</xcal:dtstart>
				<xcal:dtend>
					<xcal:date-time>2012-02-13T09:30:00</xcal:date-time>
				</xcal:dtend>
				<xcal:summary>
					<xcal:text>Konsultasjon med lege NN</xcal:text>
				</xcal:summary>
				<xcal:description>
					<xcal:text>Din time er bekreftet. Du får SMS påminnelse før 	konsultasjonen. Mvh. Legekontor NN.</xcal:text>
				</xcal:description>
				<xcal:uid>
					<xcal:text>012d1e50-760e-11e2-bcfd-0800200c9a66</xcal:text>
				</xcal:uid>	
				<xcal:contact>
					<xcal:text>91095 </xcal:text>
				</xcal:contact>
				<xcal:related-to>
					<xcal:uri>651b1341-26ca-11e4-8c21-0800200c9a66</xcal:uri>
				</xcal:related-to>	
			</xcal:properties>
			<xcal:components/>
		</xcal:vevent>
	</xcal:components>
</xcal:vcalendar>

Skjemaet definerer ikke makslengder eller innhold i felter. For Digital dialog med innbygger er det innført begrensninger i brukergrensesnitt for feltlengder og ved lagring av data. Begrensninger er vist i tabellen er vist under, dersom det sendes innhold lenger enn dette vil det trunkeres ved mottak.