...
Profilen er basert på R4 Slot - FHIR v4.0.1 (hl7.org)
Gjenerelt om Slot
Slot ressurser brukes til å tilby tidsrom som kan bookes ved hjelp av en avtale. De gir ikke informasjon om tilgjengelige avtaler, bare tiden, og eventuelt hva tiden kan brukes til. Dette er effektivt tidsrom med ledig/opptatt tid. Slotter kan også merkes som opptatt uten å ha tilknyttede avtaler.
...
I noen situasjoner kan en tjeneste ha et spesifikt sett med slotter reservert for spesifikke formål, som "drop-in" eller en spesifikk organisasjon har en "fast booking" for torsdag morgener. Dette bør representeres ved hjelp av feltet appointmentType med en spesifisert og avtalt verdi.
Sikkerhetstillatelser eller spesifikke forretningsregler på systemet kan håndheve at kun berettigede avtaler blir tildelt dem.
Profil for Slot
Info |
---|
Profilen ligger foreløpig på Github her: hn-basis-slot - v0.1Se profil: HnBasisSlot - Codes, extension, profiles and more v0.2.0 (norskhelsenett.github.io) (Plassering er under oppdatering) |
Hvordan feltene benyttes er angitt i figuren og beskrivelse under. For bruk av metadata, id, indentifier og generelt bruk af FHIR på Helsenorge se Bruk av FHIR på Helsenorge - Helsenorge - Confluence (atlassian.net)
Det er også definert invarianter som gjelder for profilen - se egen tabell.
| |
---|---|
Todo: Legg inn figur | identifier (mandatory): En identifikator som identifiserer slot uavhengig av ressursens id på en FHIR-server |
bør hvis mulig være en UUID . Identifier er profilert til å ha kardinalatet 1..1 og det er mandatory å legge til både system og value.
|
| ||||||
meta.profile (mandatory): Meta.profile forteller hvilken profil instans er basert på. Dette er for å forenkle implementering når det er flere profiler som er aktuelle for Helsenorge.
| ||||||
status (mandatory): Status på Sloti henhold til FHIR valueset. http://hl7.org/fhir/R4/valueset-slotstatus.html
| ||||||
schedule (mandatory): referense til den aktuelle time boken. Profil støtter både litteral og logisk referanse
| ||||||
serviceCategory (mandatory): En bred kategorisering av tjenesten som skal utføres i den perioden som slot har definert. Valueset hn-appointment-ServiceCategory-code-vs skal brukes for denne kategoriseringen. hn-appointment-ServiceCategory-code-vs - v0.1.0 (norskhelsenett.github.io). I denne profilen er kardinalitet satt til 1..1
| ||||||
appointmentType (optional): Type appointment som er ment for slot. Feltet er ikke påkrevd men det er ønskelig at det brukes i instanser som er basert på profilen. Følgende valueset er påkrevd.: hn-appointment-AppointmentType-code-vs - v0.1.0 (norskhelsenett.github.io)
|
|
|
|
| ||||||
start (mandatory): Date/time når slot starter
| ||||||
end (mandatory): Date/time når slot avsluttes
|
Terminology Bindinger
Path | Conformance | ValueSet |
Slot.language
CommonLanguagesAdditional BindingsPurposeAllLanguagesMax Binding
Slot.identifier.use |
Slot.serviceCategory |
Slot.serviceType |
Slot. |
appointmentType |
Slot.status |
Invarianter (Regler)
Id | Grade | Path(s) | Details |
dom-2 | error | Slot | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
dom-3 | error | Slot | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
dom-4 | error | Slot | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
dom-5 | error | Slot | If a resource is contained in another resource, it SHALL NOT have a security label |
dom-6 | best practice | Slot | A resource should have narrative for robust management |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
ext-1 | error | **ALL** elements | Must have either extensions or value[x], not both |
inv-4 | error | Slot.serviceCategory.coding, Slot.serviceType.coding, Slot.specialty.coding | If code is used in a codable consept the system must be used |
per-1 | error | Slot.identifier.period | If present, start SHALL have a lower value than end |
ref-1 | error | Slot.identifier.assigner, Slot.schedule | SHALL have a contained resource if a local reference is provided |
Søkeparameter
Info |
---|
Søkeparametere vil utvides for å støtte representasjon men det er ikke lagt inn i vedlagt er liste. Listen viser hvilken søk er definert. Se Search - FHIR v4.0.1 (hl7.org) og Search - FHIR v4.0.1 (hl7.org) |
Name | Type | Description | Expression |
appointment-type | The style of appointment or patient that may be booked in the slot (not service type) | Slot.appointmentType | |
identifier | A Slot Identifier | Slot.identifier | |
schedule | The Schedule Resource that we are seeking a slot within | Slot.schedule | |
service-category | A broad categorization of the service that is to be performed during this appointment | Slot.serviceCategory | |
service-type | The type of appointments that can be booked into the slot | Slot.serviceType | |
specialty | The specialty of a practitioner that would be required to perform the service requested in this appointment | Slot.specialty | |
start | Appointment date/time. | Slot.start | |
status | The free/busy status of the appointment | Slot.status |
Mapping til og delvis fra iCal
Code Block |
---|
BEGIN:VCALENDAR VERSION:2.0 PRODID:-//example.org//Slot to iCal Converter//EN BEGIN:VEVENT UID:[slot.identifier.value]@[slot.identifier.system] DTSTAMP:20231207T000000Z DTSTART:[slot.start] DTEND:[slot.end] SUMMARY:[slot.speciality]. [slot.appointmentType] DESCRIPTION:[slot.comment] Slot status: [slot.status]. Not overbooked {basert på [slot.overbooked]} CATEGORIES:[slot.serviceCategory], [slot.appointmenttype] LOCATION:[slot.schedule.reference] END:VEVENT END:VCALENDAR |
...
Denne omformuleringen er i bunn og grunn en nødløsning for å inkludere viktig informasjon fra FHIR-ressursen i iCal-formatet, som er mer begrenset i sin evne til å beskrive komplekse planleggingsscenarioer. I en praktisk Ved implementering er det viktig å ha en klar avtale eller standard innenfor systemet eller blant brukerne om slike tolkninger og bruk av felt, spesielt når man tilpasser data fra en omfattende helsestandard som FHIR til et mer generelt kalenderformat som iCal.slik bruk av LOCATION.
I tilfelle schedule er logisk referanse brukes X-SCHEDULE-REFERENCE
: [slot.schedule.system]|[slot.schedule.value]
Eksempel:
Code Block |
---|
BEGIN:VCALENDAR VERSION:2.0 PRODID:-//example.org//Slot to iCal Converter//EN BEGIN:VEVENT UID:123e4567-e89b-12d3-a456-426614174000@example.org DTSTAMP:20231207T000000Z DTSTART:20231210T090000Z DTEND:20231210T093000Z SUMMARY:Konsultasjon DESCRIPTION:Gjenerel time for konsultasjon. Slot status: free. Not overbooked. CATEGORIES:Specialist Medical, konsultasjon LOCATION:Schedule/example-schedule-uuid END:VEVENT END:VCALENDAR |
...