Widgeter
Vital Signs widget
Oppsett, konfigurasjon og tilgangskontroll
Forutsetninger for bruk
En forutsetning for bruk av Vital Signs Widget er at oppsett og konfigurasjon av denne er utført i henhold til brukerdokumentasjonen og at Vital Signs Widget blir tilgjengeliggjort i en sidekonfigurasjon med bruk av Page Designer.
Oppsett og konfigurasjon forutsetter tilgang og kjennskap til følgende:
Arketype Admin
VAQM-konfigurasjon
Dokumentadmin
Tile Manager / Page Designer
Vital Signs Widget er en visningskomponent over data definert gjennom VAQM. Det forutsettes at bruker kan utvikle og gjøre tilgjengelig VAQM konfigurasjoner som legges inn i komponenten.
Krav til VAQM-konfigurasjon for visning i widget
Følgende krav stilles til en VAQM konfigurasjon for bruk i Vekstkurve:
Predikatet MÅ ha navnet
latest.OID MÅ være den samme for VAQM konfigurasjon, AQL binding og dataelement.
Nøkler for systemkonfigurasjon MÅ være satt på AQL binding. Se nøkler i systemkonfigurasjon
Påkrevede attributter må være satt på AQL binding. Se tabellen under.
1..1
compositionid: String
Sti til compositionid, typisk c/uid/value
1..1
archetypeid: String
Sti til archetypeid, typisk /archetype_details/archetype_id/value
1..1
time: DV_DATE_TIME
Sti til feltet som angir tidspunktet for målingen. For OBSERVATION benyttes gjerne origin eller `time`på POINT_EVENT.
1..1
value: Double
Sti til verdien, typisk `magnitude`på DV_QUANTITY
0..1
unit: string
Sti til enheten, typisk units på DV_QUANTITY
1..1
author: String
Sti til forfatter på dokumentet, typisk c/composer/name
0..1
additionalinfo[1..n]: String
Sti til andre verdier som det ønskes at VAQM skal hente inn.
Tabell 151. Krav til oppsett av AQL binding i VAQM
Merk at attributtene som er angitt er designet for å vise nøkkeltall fra openEHR OBSERVATION data. Likevel kan komponenten benyttes til å vise ethvert datapunkt så lenge VAQM konfigurasjonen for uttrekk tilfredsstiller kravene for konfigurasjon.
Hver widgetobservasjon og tilhørende konfigurasjon må ha et kjent navn og oppfylle en konfigurasjonskontrakt for å kunne vises i widgeten. Dette innebefatter navnet på konfigurasjonen, navnet på kolonner og type resultat som spørring på denne kolonnen skal returnere.
Ved angivelse av sti til time i kontrakten må du tenke over hvilket tidspunkt som hentes ut. Her må det hentes ut verdi for når observasjonen ble gjort og IKKE når observasjonen ble dokumentert (typisk context/start_time). Du vil i så tilfelle kunne oppleve at verdien som vises i widgeten ikke viser siste målte verdi, men siste dokumenterte verdi som var en etterregistrering gjort på et tidligere tidspunkt.
Konfigurasjon av widget på side
Sidekonfigurasjon (Page designer) benyttes for å plassere komponentene på ønsket plassering.
For å definere høyden på komponenten er det to ulike modus:
Dynamisk høyde Ved å velge minimumshøyde i sidekonfigurasjon vil komponenten selv ta den plassen den krever.
Fast høyde Dersom bruker i sidekonfigurasjon velger en spesifikk høyde som vil denne beholdes for sluttbruker.
Det anbefales å bruke dynamisk høyde slik at siden blir responsiv i forhold til størrelsen på siden og plassen som kreves for komponenten.
Konfigurasjon av innhold i widget
Konfigurasjon av innholdet i widget gjøres ved å trykke på tannhjulet til høyre for å åpne konfigurasjonsverktøyet. Det rødmerkede området tilsvarer de felter som kan benyttes per widgetverdi som angis i widgeten.
Ingen av feltene i konfigurasjonen er obligatoriske, men for at du i det hele tatt skal få opp verdier i widgetvisningen må du i det minste angi OID til en VAQM konfigurasjon.
Rekkefølgen av de konfigurerte VAQM definisjonene blir rekkefølgen som de ulike nøkkeltallene vises på i siden.
Figur 17. Konfigurasjonsverktøy for widget
Columns
Angir hvor mange kolonner verdiene skal vises i. Se Kolonneangivelse for mer informasjon.
Vaqm name
Her angis OID til VAQM konfigurasjonen som definerer nøkkeltallen. Se VAQM-navn for mer informasjon.
Concept name
Her angis hvilket dokumentkonsept som benyttes for å redigere innhold. Se Dokumentkonsept for mer informasjon.
Icon path
Dersom det ønskes at widgetverdien skal vise et ikon angis geometrien for ikonet her. Se Ikongeometri for mer informasjon.
Short name
Angi et kortnavn som representerer widgetverdien. Kortnavnvisning for mer informasjon.
+ Legg til
Legger til en ny bolk for konfigurasjon av ny verdi som skal vises i widgten.
Endre konfigurasjon
Åpner opp for mer avansert konfigurasjon. Anbefalt konfigurasjonsalternativ dersom du ønsker å endre på visinngsrekkefølgen på widgetverdiene. Se Endre konfigurasjon for mer informasjon.
Tabell 152. Skjermfeltbeskrivelser Konfigurasjonsverktøy for widget
Kolonneangivelse
Her angir du antall kolonner du ønsker at widgetveridene skal vises i. Ønsker du å vise alle verdier på 1 linje setter du kolonneverdi tilsvarende det antall vaqm-verdier du setter i konfigurasjonen.
VAQM-navn
Her angir du hvilken verdi du ønsker å vise i widgeten ved å angi VAQM-konfigurasjonens unike Oid. Her eksemplifisert med VAQM for blodtrykk. Oid finner du på VAQM-konfigurasjonen i Arketype Admin.
Dokumentkonsept
For å kunne muliggjøre direkteregistrering av nye verdier i widgeten, må det på den eller de verdier dette er ønskelig angis et dokumentkonsept. Dersom det allerede foreligger, det vil si allerede er opprettet et dokumentkonsept du vet er dekkende for behovet i widgeten, angir du dette unike dokumentkonseptet i widgetkonfigurasjonen. Alternativt kan du i motsatt retning navngi dokumentkonseptet i widgetkonfigurasjonen, for så å opprette dokumentkonseptet i Dokumentadmin senere.
Det at det i konfigurasjonen er angitt et dokumentkonsept er ikke ensbetydende med at bruker kan registrere inn en ny verdi. Du kan slå av/på denne funksjonaliteten ved å fjerne/legge til referansen til dokumenttype og dokumentmal i dokumentkonseptet i Dokumentadmin.
Dersom det ikke angis et dokumentkonsept i konfigurasjonen eller at dokumentkonseptet ikke er tilknyttet dokumenttype og dokumentmal, så vil widgetverdien ha lesemodus. Det vil si at den vil fortsatt vise siste registrerte verdi og dersom du trykker på widgetverdien så vil du få opp historikk på tidligere registrerte verdier.
For ytterligere informasjon om dokumentkonsept og opprettelse av dette henvises det til brukerdokumentasjonen for Dokumentadmin.
Ikongeometri
Dersom du ønsker at widgetverdien skal symboliseres med et ikon, må du på dette feltet angi ikongeometrien for det ikonet du ønsker å benytte.
Dersom det ikke angis ikongeometri vil widgetverdien vises med et standardikon som er en sirkel.
Kortnavnvisning
Du kan velge å definere et kortnavn som gjenspeiler widgetverdien. Dette navnet vil så vises inne i den forhåndsdefinerte sirkelen som vises foran widgetverdien dersom det ikke er definert et særeget ikon for verdien. Grunnet begrenset plass for visning av tekst inne i sirkelen anbefales det ikke å overskride 5 tegn/bokstaver når du angir et kortnavn.
Endre konfigurasjon
Ved å trykke på Endre konfigurasjon i konfigurasjonsverktøyet endres måten du konfigurerer opp widgeten fra standardoppsettet som er Enkel registrering og du får følgende konfigurasjonsoppsett og hvor det røde feltet tilsvarer det samme feltet som var markert i den enkle redigeringen:
Fyll deretter ut de ønskede felter på lik linje som ved Enkel redigering. For å registere inn flere widgetverdier dupliseres det rødmerkede feltet som vist på bildet over.
Dette konfigurasjonsalternativet anbefales dersom du ønsker å endre på visningsrekkefølgen av widgetverdiene. Klipp ut den verdien du ønsker å endre plassering på og lim den inn på ønsket plass. Alternativt må du slette hele oppsettet og starte på nytt da det ikke lar seg gjøre å redigere rekkefølge når du har valgt Enkel redigering.
Støttede nøkkelverdier i Vital Signs Widget
Nøkkelverdier er pekere til verdier i systemkonfigurasjon for VAQM. Formålet med disse oppsettene er å muliggjøre skreddersøm av enkelte egenskaper i Vital Signs Widget for den enkelte innstallasjon.
Merk at alle nøkkelverdiene her fornuftige standardverdier. Likevel er det påkrevet å angi alle nøkkelverdiene som "key/value" definisjoner i AQL bindingen for VAQM.
Alle nøkkeltallsverdiene MÅ være satt i VAQM og på AQL binding for at Vital Signs Widget skal fungere. De behøver derimot ikke ha noen verdi i systemkonfigurasjonen for VAQM (i Arketype Admin).
Limit
Angir antall tidligere registrerte verdier som skal vises i historikken på en widgetverdi.
10
FractionalPartSize
Angir hvor mange desimaler som skal vises dersom widgetverdien returnerer tall med desimaler.
Alle
DecimalSeparator
Angir om kommaseparator for desimaler skal være punktum (.) eller komma (,).
Komma (,)
OldMeasurement
Angir om visningen av widgetverdien skal endres til en svakere gråtone etter en gitt tid for å antyde for bruker at siste registrerte verdi kanskje ikke lengre er representativ. Gyldige parameterangivelser er :År = YMåned(er) = MDag(er) = DTime(r) = HEksempelKomponenten skal vise at verdien er foreldet etter 24 timer. AttributtenOldMeasurementsettes da til verdien24Hi systemkonfigurasjonen i VAQM.
Aldri
Nødvendige beslutninger
Hva slags data skal vises?
Komponenten kan i prinsippet vise alle tidsfestede kliniske data som er lagret i som openEHR i DIPS. Det kreves god dialog med sluttbrukere med tanke på hvilke data som skal vises, hvordan de skal navngis og hvilke symboler som eventuelt skal benyttes. Designet av dette overlates til brukeren av Vital Signs Widget.
Tillate registrering av ny verdi via widgeten
KomponentenKANsettes opp til å åpne et skjema for registrering av nye data. Dette gjøres ved å definere attributtenConcept name. Dette attributtet defineres med et dokumentkonsept. Det forventes at den som setter opp komponenten er godt kjent med bruk av dokumentkonsept i DIPS Arena. Dersom det angis et dokumentkonsept og det peker på en definert dokumenttype og -mal vil skjema presenteres for bruker når hen klikker på komponenten. Dersomconcept nameer tomt eller at dokumentkonsept ikke har angitt dokumentype/-mal vil komponenten vise blankt der skjema normal ville vært.
Tilgangskontroll
For en generell beskrivelse av tilgangskontroll, forutsettes det at brukerdokumentasjonen for "Tilgangskontroll" leses. Du kan finne dette i DIPS Arena brukerdokumentasjon.
Det er ingen tilgangskontroll knyttet til bruken av Vital Signs Widget. Tilgang til dokumenter følger ordinær tilgangskontroll til dokumenttype som dokumentmal kobles til i Dokumentkonseptet for den gitte widgetverdi.
Oppsett, konfigurasjon og tilgangskontroll
Nødvendige beslutninger
Tilgangstyring for dokumenter
Beslutte hvilke brukere som skal ha tilgang til journalgruppen som dokumenttypene knyttes til.
Tilgangsstyring for pasientliste
Beslutte hvilke brukere skal ha tilgang til elementtypen som pasientlisten skal knyttes til.
Ta ibruk kolonne "Planlagt behandling"
Beslutte om det er ønskelig å ta ibruk kolonne "Planlagt behandling".
Tabell 155. Nødvendige beslutninger
Konfigurasjon
Knytte dokumenttyper til journalgruppe
Gjøres i Arena Dokumentadmin → Dokumenttyper
Kopiere pasientliste og redigere pasientlistenavn
Gjøres i Arena Pasientlisteadmin
Konfigurere kolonne "Planlagt behandling"
Gjøres i Arena Pasientlisteadmin
Knytte enheter til side
Gjøres i Arena Konfigurerte sider
Tilgangskontroll i Arena Pakkeforløp kreft
Knytte elementtyper og tildele rettigheter til brukere. Knytning til elementtyper gjøres i Pasientlisteadmin og i Konfigurerte sider. Tildeling av tilgang til brukere gjøres i DIPS Admin.
Knytte dokumenttyper til journalgruppe
Dokumenttyper må knyttes til journalgruppe før de blir synlige for bruker i Arena. Dette gjøres i Arena Dokumentadmin → Dokumenttyper.
PK Annen hendelse
-2186
PK Annen hendelse
PK Avslutt pakkeforløp
-2188
PK Avslutt pakkeforløp
PK Forløpskoordinator
-2190
PK Forløpskoordinator
PK Første fremmøte
-2192
PK Første fremmøte
PK Klinisk beslutning
-2195
PK Klinisk beslutning
PK Pasientutsatt behandling
-2343
PK Pasientutsatt behandling
PK Planlagt fremmøte
-2203
PK Planlagt fremmøte
PK Sammendrag for utskrift
-2199
PK Sammendrag for utskrift
PK Start pakkeforløp kreft
-2201
PK Start pakkeforløp kreft
PK Utsatt første fremmøte
-2423
PK Utsatt første fremmøte
PK Utsatt klinisk beslutning
-2425
PK Utsatt klinisk beslutning
Tabell 157. Dokumenttyper som må knyttes til journalgruppe
Kopiere pasientliste og redigere pasientlistenavn
Pasientliste levert av DIPS er prefikset med "DIPS_AS.". Denne pasientlisten skal ikke renavnes eller brukes av kunde for registrering av pakkeforløp. Det skal tas en kopi av pasientlisten før bruk. Kopien får automatisk navnet "DIPS_AS.Pakkeforløp kreft-Copy 1". Denne må renavnes til "Pakkeforløp kreft" og vil med det også fungere i siden "Pakkeforløp kreft" uten at man trenger å gjøre endringer i "Konfigurerte sider".
Dersom det allerede finnes en pasientliste med navnet "Pakkeforløp kreft", må denne renavnes til noe annet, f.eks prefikse med "X" eller "Utgått" før du kopierer ny pasientliste.
Sånn gjør du:
Åpne Arena Pasientlisteadmin og søk frem aktuell pasientliste.
Klikk på de tre prikkene i aktuell pasientliste, velg "Lag kopi", klikk "Ja".
Fjern "DIPS_AS." og fjern "-Copy 1" i feltet "Navn". Verdien i Id-feltet skal ikke redigeres.
Klikk lagre.
Husk at dersom pasientlisten har endret navn fra tidligere, må det også oppdateres i DIPS Admin → Organisasjon → Systemoppsett → Pasientoversikt: Valgte oppsett.
Konfigurerer kolonne "Planlagt behandling"
Hvis det er ønskelig å ta ibruk kolonnen, må dette gjøres i "Pasientlisteadmin":
Åpne Arena Pasientlisteadmin og søk frem og velg aktuell pasientliste.
I fane "Kolonneoppsett", åpne VAQM og Pakkeforløp kreft under "Tilgjengelige kolonner".
Velg "PK Planlagt behandling" og sett scope til "Sak". Trykk "Forhåndsvis" og "Lagre endringer"
Knytte enheter til side
Det må legges til aktuelle enheter til siden "Pakkeforløp kreft" før siden aktiveres. Dette gjøres i siden "Konfigurerte sider". Klikk på følgende parameterverdier i raden for "Pakkeforløp kreft":
Org.enhet
Aktuell(e) avdeling(er) må manuelt settes.
Aktiv
Når avdeling(er) er valgt, må "Aktiv" hakes av. DIPS Arena må restartes for at endringer skal bli gjeldende.
Tabell 158. Sideoppsett
Tilgangskontroll i Arena Pakkeforløp kreft
For generell beskrivelse av tilgangskontroll, forutsettes det at brukerdokumentasjon for generell "Tilgangskontroll" leses. Nedenfor beskrives oppsett av tilgangskontroll for Arena Pakkeforløp kreft.
Elementtyper
ElementtypeId
Elementtyper
Beskrivelse
4370
Pakkeforløp - Kreft
Benyttes for å gi tilgang til Pakkeforløp kreft i Dips Classic.
6216
Arena Pakkeforløp - Kreft
Benyttes for å gi tilgang til siden "Pakkeforløp kreft" og pasientlisten "Pakkeforløp kreft"
6756
Arena Pakkeforløp kreft saksdata uten BT
Elementtypen gir tilgang til å se sakstypen for Pakkeforløp kreft (lesetilgang), og derved tilgang til å se pakkeforløpssaker i pasientlisten. Elementtypen støtter ikke beslutningsstyrt tilgang (BT). Vi anbefaler at kunden ikke avgrenser tilgang til saker lenger ned enn til Sykehus på autorisasjonen.
På bildet vises hvordan autorisasjonen bør se ut i Classic på elementtypen "Arena Pakkeforløp kreft saksdata uten BT" (6756). (Enkelte valg kan oppfattes som noe misvisende fordi det er det gamle Classic-autorisasjonsoppsettet som brukes og som ikke er tilpasset nyere elementtyper. Dette blir endret når admin.data flyttes til Arena.)
Figur 18. Oppsett DIPS Classic for elementtypen Arena Pakkeforløp kreft saksdata uten BT
Tilgangsoppsett for pasientliste
Følgende må være på plass for at bruker skal kunne se pakkeforløp i pasientlisten:
Bruker har tilgang til elementtypen "Arena Pakkeforløp - Kreft" (6216), som styrer hvem som får se pasientlisten. Merk at tilgang til innholdet i listen ikke styres av denne elementtypen.
Bruker har tilgang til elementtypen "Arena Pakkeforløp kreft saksdata uten BT" (6756), som styrer hvem som får se pakkeforløpssaker.
Bruker har tilgang til journalgruppen som Start-dokumentet er knyttet til.
Bruker har tilgang til avdeling satt i feltet "Behandlende avdeling" i "Opplysninger" i Start-dokumentet.
Tilgangsoppsett for "Pakkeforløp kreft"-siden
Siden er knyttet til elementtypen "Arena Pakkeforløp - Kreft" (6216). For å se innholdet i pasientlisten, se beskrivelse for "Tilgangsoppsett for pasientliste".
Last updated