FHIR Flag - hn-basis-flag

FHIR Flag inneholder er en kort, tydelig og fremtredende merknad som brukes for å gjøre brukere oppmerksomme på viktige forhold, både administrative og kliniske, knyttet til for eksempel pasient, avtale, behandler eller lokasjon. Det fungerer som en varsling som raskt skal gi nødvendig kontekst, enten det gjelder planlegging, gjennomføring eller oppfølging.

Formålet er å fremheve et begrenset sett med høyt prioriterte opplysninger som kan ha praktiske, faglige, juridiske eller sikkerhetsmessige konsekvenser dersom de overses. Flagg skal supplere, ikke erstatte, ordinær dokumentasjon.

FHIR Flag - benyttes som ‘contained’ ressurs i Appointment i ny timeløsing. Profilen er en implementert profil https://norskhelsenett.github.io/nyTimelosningPages/StructureDefinition-hn-basis-Flag.html#root og er basert på Flag resursen http://hl7.org/fhir/R4/flag.html . I hn-basis-appointment brukes ‘contained’ FHIR Flag for å vise hvilken muligheter innbygger har til å styre/ha effekt på egen time. Flag referes fra appointment.supportingInformation. FHIR Flag er foreløpig ikke implementert på annen måte en som contained ressurs, men har fulle forutsettinger til å brukes som selvstendig ressurs i andre løsninger. I noen tilfeller er det nødvendig å legge inn periode for når flagget er gyldig - det kan for eksempel være nødvendig for å legge inn en periode for hvor lenge en innbygger skal ha mulighet til å kansellere time. Det er derfor lagt til en extension statusPeriod som setter valid periode for status.

Følgende oversikt viser hvilken attributter brukes i hn-basis-appointment-flag. For andre attributter se implementasjons guid.

Elementnavn	Valgfri / påkrevd	Beskrivelse	Eksempel

Elementnavn	Valgfri / påkrevd	Beskrivelse	Eksempel
id	Valgfri	Bør være med som unique id for ressursen	`<id value="fcf8ac7b-4044-463d-938c-51daba8e06b6"/>`
meta.profile	Valgfri	Bør være med for å fortelle hvilken profile er brukt	`<meta> <profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-Flag"/> </meta>`
status	påkrevd	active \| inactive \| entered-in-error. Default = active	`<status value="active"/>`
code	påkrevd	Kode - eller tekst som forteller hva innbygger kan gjøre. Det er lagt til eget lokalt kodeverk. I profilen er coding mandatory og det kan ikke brukes ren tekst alene.	`<code> <coding> <system value="http://helsenorge.no/fhir/CodeSystem/hn-appointment-flag-code-cs"/> <code value="canAcknowledge"/> </coding> <text value="Timen/opphold kan bekreftes av innbygger"/> </code>`
subject	påkrevd	Subjekt for flag. Ikke noen begrensing på referansetype i profilen men for eksisterende implimentasjon er det kun pasient (innbygger) som er i scope og det brukes logisk referanse.	`<subject> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.4.1"/> <value value="08718340110"/> </identifier> </subject>`
periode.start		Start tidspunkt for flag
period.end		I basis profil skal ikke end tidspunkt settes hvis flag er aktiv. For å sette periode for status når den er aktiv bruk extension statusPeriod

Lokalt kodesystem: hn-appointment-flag-code-cs

Code	Display	Definition

Code	Display	Definition
cancel (planlagt men ikke i bruk)	Innbygger kan kansellere timen
canChangeAppointmentDialog	Innbygger kan be om endret time	Innbygger kan be om endret time via dialog melding
canUseShortNotice (planlagt men ikke i bruk)	Innbygger kan komme på kort varsel
canCancelServiceRequest (planlagt men ikke i bruk)	Innbygger kan be om at behandlingsløp avsluttes
canChangeConferenceType (planlagt men ikke i bruk)	Innbygger kan be om endret konferanse type	Innbygger kan som eksempel be om virtuell konferanse i stedet for fysisk
canAcknowledge	Timen/opphold kan bekreftes av innbygger.	Dersom denne er satt må avsender av timen støtte Appointment Response kall for bekreftelse
canChangeAppointment	Innbygger kan be om endret time	Innbygger kan be om endret time via AppointmentResponse
canHaveAppointmentDetails	Det finnes ytterligere timedetaljer som kan hentes.	Helsenorge henter kun disse dersom HasAppointmentDetails er satt til true. Dersom denne er satt må avsender støtte kall for henting av timedetaljer.
canInitiateDialog	Dialog kan initieres	Innbygger kan initialisere dialog

Eksempel - 'Contained FHIR Flag ressurser i Appointment i ny Timeløsning

				<contained>
					<Flag>
						<id value="fcf8ac7b-4044-463d-938c-51daba8e06b6"/>
						<meta>
							<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-Flag"/>
						</meta>
						<status value="active"/>
						<code>
							<coding>
								<system value="http://helsenorge.no/fhir/CodeSystem/hn-appointment-flag-code-cs"/>
								<code value="canAcknowledge"/>
							</coding>
							<text value="Timen/opphold kan bekreftes av innbygger"/>
						</code>
						<subject>
							<identifier>
								<system value="urn:oid:2.16.578.1.12.4.1.4.1"/>
								<value value="08718340110"/>
							</identifier>
						</subject>
					</Flag>
				</contained>
				<contained>
					<Flag>
						<id value="5f9239b7-225a-4407-8c1d-19d2d64e47e8"/>
						<meta>
							<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-Flag"/>
						</meta>
						<status value="active"/>
						<code>
							<coding>
								<system value="http://helsenorge.no/fhir/CodeSystem/hn-appointment-flag-code-cs"/>
								<code value="canChangeAppointmentDialog"/>
							</coding>
							<text value="Innbygger kan be om endret time"/>
						</code>
						<subject>
							<identifier>
								<system value="urn:oid:2.16.578.1.12.4.1.4.1"/>
								<value value="08718340110"/>
							</identifier>
						</subject>
					</Flag>
				</contained>
				<contained>
					<Flag>
						<id value="71dfd17d-e7d5-472c-ae3b-18717fd45afa"/>
						<meta>
							<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-Flag"/>
						</meta>
						<status value="active"/>
						<code>
							<coding>
								<system value="http://helsenorge.no/fhir/CodeSystem/hn-appointment-flag-code-cs"/>
								<code value="canHaveAppointmentDetails"/>
							</coding>
							<text value="Det finnes ytterlige timedetaljer på time/timeavtale som kan hentes"/>
						</code>
						<subject>
							<identifier>
								<system value="urn:oid:2.16.578.1.12.4.1.4.1"/>
								<value value="08718340110"/>
							</identifier>
						</subject>
					</Flag>
				</contained>
				<contained>
					<Flag>
						<id value="7f494e69-fea7-4e13-b7d4-fbaf41323866"/>
						<meta>
							<profile value="http://helsenorge.no/fhir/StructureDefinition/hn-basis-Flag"/>
						</meta>
						<status value="active"/>
						<code>
							<coding>
								<system value="http://helsenorge.no/fhir/CodeSystem/hn-appointment-flag-code-cs"/>
								<code value="canInitiateDialog"/>
							</coding>
							<text value="Dialog kan initieres"/>
						</code>
						<subject>
							<identifier>
								<system value="urn:oid:2.16.578.1.12.4.1.4.1"/>
								<value value="08718340110"/>
							</identifier>
						</subject>
					</Flag>
				</contained>