Widgeter
Nettleserwidget
I konfigurerte sider i Arena kan det defineres visning av en prekonfigurert nettside. Det kan være en ekstern nettside eller intern nettside for ditt sykehus/ helseforetak.
Nettleserwidget og malvariabler
Det er tilrettelagt for bruk av malvariabler sammen med nettleserwidget. Når malvariabel er definert sammen med nettleserwidget får du frem malvariabelinformasjon i den prekonfigurerte nettsiden.
Tilgangskontroll
Det er ikke implementert tilgangskontroll på widgeten. For generell beskrivelse av tilgangskontroll i Arena, se Tilgangskontroll
Tilgang til widgeten styres gjennom tilgang til den konfigurerte siden widgeten benyttes i. Dette vil si at dersom du har tilgang til siden widgeten benyttes i, har du også tilgang til alle data/ funksjoner i widgeten for den aktuelle siden.
Sakstre Widget
Denne widgeten viser saker og undersaker i form av et sakstre. Den settes opp med en bestemt sakstype som rot. Alle saker av den typen vil bli lastet for aktiv pasient, under hver av disse vil alle barnesaker lastes uavhengig av type. Når en bruker markerer en av disse sakene vil det bli sendt ut et en melding som kan brukes av "Sakssammendrag-widgetene" for å vise sammendrag.
Det er kun dokumenter som tilhører journalgruppene man har lesetilgang til, som vil vises.
Konfigurasjon Sakstre Widget
"RootFolderType" her settes hvilken sakstype (ID) som skal gjelde som rot. (Påkrevd)
"RootFolderTypes" her settes sakstype (ID) når du vil vise flere sakstyper i samme sakstre. ["<guid>", "<guid>", "<guid>"] Det er fortsatt mulig å bruke den gamle egenskapen RootFolderType, men denne overstyres av det som eventuelt står i RootFolderTypes.
"ViewMode" her settes hovedvisning. Alle røttene og deres trær vises i utgangspunktet sammen i hovedvisningen (FullTree). Ved å sette "ViewMode" til "SlideIn" vil røttene trekkes ut i en skuff, hvor du kan velge å vise ett-og-ett tre i hovedvisningen.
"MaxClosedFolderAge": Filtrering av hvor gammel en lukket sak kan være i standard visning.
"ShowSelectAll" hukes av om man ønsker at "Velg alle" knappen skal vises. (Ingen reel funksjonalitet i dag. Vil fjernes)
"SelectAllText" er tekst som vises på "Velg alle" knappen. (Vil fjernes ref. punkt over)
"ExcludedFolders" indikerer hvilke sakstypeer (ID) som skal ignoreres ved henting av data.
"InitialSelectionFolderType" markerer nyeste sak av valgt sakstype (sortert på starttid) automatisk, når treet lastes.
"AddAndRemoveDocumentsDisabled" gir anledning til å legge til/fjerne dokumenter på saksnivå.
"AdditionalFolderInfoConfigs" benyttes for å kunne legge inn info på sak.
Eksempel:
Arena Olafia Medikamentliste
Arena Olafia Medikasjonsliste viser all historikk for valgt pasient på den aktuelle avdelingen widgeten gjelder for. Medikamentene registreres i aktuelle skjema og vises når skjemaene blir godkjent.
Skjermbildereferanser
Medikament
Navnet på legemidlet
Dose
Hvilken dose som skal tas når
Medikamentstatus
Viser hvilken status medikamentet har. Følgende statuser er tilgjengelig: Medikasjon forordnet Medikamentet er forordnet, men ennå ikke gitt pasienten Resept utdelt Pasienten har fått resepten Medikasjonen utdelt Pasienten har fått medikamenten, slik at han kan ta det selv Medikasjon administrert Medikamentet er administrert
Utdelttid
Når medikamentet ble utdelt
Gitt av
Hvem som har gitt medikamentet
Kriterie for at medikamentene skal vises
For at medikamentenen skal vises, så må kontakten til pasienten være knyttet mot samme avdeling som standard avdelingen på brukerrollen til pålogget bruker. Og skjemaet hvor medikamentene registreres må være godkjent.
Konfigurasjon av Arena Olafia Medikamentliste
Widgeten kan ikke konfigureres.
Vital Signs widget
Vital Signs Widget
Vital Signs Widget er en konfigurerbar widget for å presentere kliniske nøkkeltall. Datagrunnlaget er kliniske data tilgjengelig som openEHR data. Uttrekk av data defineres gjennom strukturerte spørringer, dvs. VAQM konfigurasjoner.
Komponentene ble i første omgang utviklet for å støtte visning av vitale tegn i behandlingsplan. Konfigurasjon av komponenten ble gjort så fleksibelt at den nå benyttes i en lang rekke kliniske applikasjoner utviklet for DIPS Arena.
Funksjonelt har Vital Signs Widget tre bruksmåter:
Visning av nøkkeltall
Visning av historikk over nøkkeltall
Registrering av nye verdier
Avhengig av måten Vital Signs Widget konfigureres opp, vil den kunne gi en enkel og oversiktlig fremvisning av data som har blitt lagret i databasen. På denne måten vil du for eksempel kunne se alle registrerte vitale tegn som har blitt registrert på en pasient, både verdien og tidsangivelse for siste registrering. I den utvidede visningen finner du informasjon om hvem som registrerte verdien, samt ytterligere informasjon som er registert på elementet dersom dette er angitt i VAQM for widgetverdien.
Hurtiginnføring for Vital Signs Widget
Hvordan vise data i Vital Signs Widget?
Data hentes automatisk inn i Vital Signs Widget basert på gjeldende konfigurajson. Se oppsett og konfigurasjon for detaljer om hvordan komponenten konfigureres.
Hvordan vise historiske data i Vital Signs Widget?
Komponenten henter automatisk inn historiske målinger. Ved å klikke på en av nøkkeltallene vises en tabellarisk liste med historiske data. Data er sortert med nyeste data først.
Hvordan registrere nye data til Vital Signs Widget?
Komponentene kan tilby integrert registrering av nye data. Dette skjer ved å definere et dokumentkonsept som definerer hvilket skjema som benyttes. Bruker får opp skjema i redigeringsmodus ved å klikke på komponenten.
Tabell: Hurtiginnføring {.tableblock .frame-all .grid-all .stripes-odd .stretch}
Bruke Vital Signs Widget
Vital Signs Widget gir deg både en rask og enkel oversikt over registreringer av definerte verdier, uansett hvor i Arena de er registrert, og samtidig gir deg en enkel måte å registrere inn nye verdier dersom widgten er konfigurert opp for direkteregistrering. Et eksempel på hvordan widgeten kan se ut i Arena er vist på bildet under.
Godkjente bruksområder
Komponenten er utviklet for å presentere tidsfestede kliniske data definert som openEHR data i DIPS Arena. Det forutsettes at den som konfigurerer og setter opp komponenten har god kunnskap om de kliniske konseptene som trekkes inn, VAQM for strukturerte spørringer mot openEHR data og har kunnskap om forvaltning av arketyper i systemet.
Oppdatere widget med data/informasjon
Ettersom widgeten henter inn og viser informasjon knyttet til spesifikke arketyper, og igjen spesifikke områder av denne, vil data i widgeten endre seg hver gang noen legger inn data i et skjema som benytter samme arketype, uavhengig av hvilken kontekts det har blitt registrert i. På denne måten kan du til envher tid se hvilke verdier som er registrert vedrørende et område uten å måtte søke opp og lese gjennom dokumentasjonen denne er registrert inn i.
For å kunne oppdatere widgetverdien direkte ved å klikke på verdien må widgetverdien være konfigurert opp med hvilket dokumentkonsept som skal benyttes, for mer informasjon se kapittel under som omhandler oppsett og konfigurasjon av Vital Signs Widget.
Du vil når du klikker på en verdi bli presentert for et skjema hvor du kan legge inn dataverdien du ønsker å registrere, for så å lagre endringen. Elementet vil da oppdatere seg med den verdien du la inn og det vil gjenspeile seg på elementet når denne endringen ble lagt inn.
Skulle du ønske å redigere på dokumentet du lagret kan du dobbeltklikke på det i historikkvisningen. Dokumentet åpnes da i Arbeidsflaten og du kan gjøre endrigner på det på lik linje med endring av alle andre journaldokumenter. Når du godkjenner endringen vil widgeten også oppdateres og vise status etter redigeringen.
Historikkvisning av registrerte verdier.
Alle verdier som registreres i widgeten kan vises som en kronologisk listevisning dersom du ønsker det. Ved å trykke på widgetvisningen av en verdi vil du bli presentert for tidligere registrerte verdier, samt øvrig informasjon som widgeten er satt opp til å vise.
Dersom det ønskes en begrensning av antall verdier som skal vises, settes dette på nøkkelverdien Limit i systemkonfigurasjonen i Arketype Admin. Hvis ingen verdi bli satt benyttes standardverdien. Se nøkler for systemkonfigurasjon for mer informasjon om denne attributten og dens standardverdier.
Angi ikon på widgetvisningen
Det kan knyttes et ikon som symboliserer verdien som vises i widgeten. For at dette skal være mulig må det i widgetkonfigurasjonen legges inn ikongeometri som angir ønsket ikon. Dersom ingen ikoner er representative, og dermed ikke angis ikongeometri, vil verdien vises i widgeten med en sirkel foran verdien. Ved å angi et kortnavn på verdien kan dette vises inne i sirkelen slik at det kan gi deg et hint om hva verdien representerer.
Hvis du fremdeles ikke er sikker på hva verdien i widgeten representerer holder du musepekeren over området og du får opp en hinttekst som gir deg utvidet informasjon om widgetverdien.
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 Vital Signs Widget:
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: Krav til oppsett av AQL binding i VAQM {.tableblock .frame-ends .grid-none .stripes-odd .stretch}
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.
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: Skjermfeltbeskrivelser Konfigurasjonsverktøy for widget {.tableblock .frame-ends .grid-none .stripes-odd .stretch}
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 = Y Måned(er) = M Dag(er) = D Time(r) = H Eksempel Komponenten skal vise at verdien er foreldet etter 24 timer. Attributten OldMeasurement settes da til verdien 24H i 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
Komponenten KAN settes opp til å åpne et skjema for registrering av nye data. Dette gjøres ved å definere attributten Concept 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. Dersom concept name er 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.
Sist oppdatert