Arketypeadmin

Arketyper i Arena er en tilnærming til OpenEHR sin standard for registrering og visning av informasjon til bruk i en elektronisk journal. En arketype inneholder en eller flere datatyper og informasjon om hvordan disse skal oppføre seg, slik som grenseverdier, format, type etc.

En operational template (OPT) er en enkelt eller en samling arketyper med mulighet for ytterligere spesifisering av hvordan arketypen og data registrert på denne skal oppføre seg.

Når systemet har en OPT, kan du bruke denne til å registrere data og vise data; fordelene er fleksibilitet, gjenbruk og trygghet for at fremtidige versjoner av programvaren kan vise historiske data. Gjenbruk av data er en av fordelene med arketyper, fordi du kan vise verdier fra en arketype uavhengig av hvor og når data ble lagret.

«Arketypeadmin» er en egen administrasjonsmodul i Arena som er utviklet med det formål å kunne importere OPT-er og VAQM-konfigurasjoner i Arena.

Arketypeadmin - hurtiginnføring

Oppgave
Hvordan?

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM, trykk på plusstegnet øverst i venstremargen. En ny konfigurerbar VAQM vises til høyre, hvor du fyller ut nødvendige felter for å lage en ny VAQM-konfigurasjon.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Trykk på Lagre endringer for å lagre endringer i flere VAQM-konfigurasjoner samtidig, eller trykk på diskettikonet for å lagre bare den VAQM-konfigurasjonen som er synlig i arbeidsflaten.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Trykk på hakeikonet for å godkjenne VAQM-konfigurasjonen.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Trykk på importikonet for å importere en VAQM-konfigurasjon fra et annet system.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Trykk på eksportikonet for å eksportere en VAQM-konfigurasjon fra arketypeadmin.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Finn frem til ønsket VAQM i venstremargen, klikk på den for å åpne den. Trykk på blyantikonet øverst for å redigere.

Fra arketypeadministrasjonsmodulen, velg arkfane VAQM. Finn frem til ønsket VAQM i venstremargen, klikk på den for å markere den. Trykk på minusikonet øverst til høyre for å slette.

Fra arketypeadministrasjonsmodulen, velg arkfanen Arketyper og trykk + Importer arketype, deretter velger du aktuell fil og åpner denne.

Fra arketypeadministrasjonsmodulen, velg arkfanen Arketyper, i filtreet finner og velger du aktuelle arketype, et eget skjermbilde vises med detaljer, skrivbare felt og radioknapper for status. Lagre når endringer er gjort.

Fra arketypeadministrasjonsmodulen, velg arkfanen Operational Templates og trykk Importer, deretter velger du aktuell fil og åpner denne.

Tabell: Hurtiginnføring {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Forutsetninger for å ta i bruk Arketypeadmin

Sykehuset må ha følgende moduler av DIPS:

  • DIPS EPJ/PAS Grunnmodul, produktnummer 1000

  • DIPS Arketypeadmin, produktnummer 1000

  • DIPS Arena, en del av DIPS EPJ/PAS Grunnmodul, produktnummer 1000

Bruken av arketyper i DIPS er basert på arketypedefinisjonen til openEHR (www.openehr.org). Arketyper som støttes i Arena versjon 17.1 er:

  • COMPOSITION

  • OBSERVATION (kun med en EVENT av typen POINTEVENT eller ANYEVENT)

  • ACTION

  • EVALUATION

  • INSTRUCTION

Underkategorier av arketyper som linkes inn i en av hovedarketypene over:

  • CLUSTER

  • ELEMENT

  • ITEM_TREE

  • ITEM_SINGLE

  • ITEM_LIST

Felttypene som støttes i Arena i versjon 17.1 er:

  • Text

  • Quantity

  • Date Time, men ikke Date only eller Time only

  • Boolean

  • Duration

  • Count

  • URI-resource identifier

Felttyper som samler eller linker til andre felttyper/arketyper:

  • Cluster

  • Slot

  • Choice, men kun de felttypene som støttes (over)

  • Text

  • DateTime

  • CodedText

  • Quantity

  • Date

  • Time

  • Boolean

  • Ordinal

  • Duration

  • Proportion

  • Identifier

  • Count

  • State

  • Uri

  • EhrUri

Merk at det er Data | Events som styrer måletidspunktet for arketypen, du trenger ikke legge inn et datofelt i Structure for å få med dette. Under Events støtter vi point-event og any-event for OBSERVATION. Det kan være gjort begrensinger fra det som er beskrevet over for de ulike modulene som benytter arketyper, se de aktuelle modulenes brukerdokumentasjon.

Godkjente bruksområder

Arketypeadmin benyttes av adminstratorer for å forvalte arketyper, OPT-er og VAQM-konfigurasjoner.

VAQM-konfigurasjon

Om VAQM

openEHR og de tilhørende Arena-verktøyene for openEHR tilbyr en fleksibel løsning for å skape nye kliniske konsepter som kan tas i bruk gjennom konfigurasjon. Et viktig funksjonelt behov blir da å kunne trekke ut og presentere slike data. VAQM (Virtual Archetype Query Manager) er verktøyet som gjør det mulig å definere både hvilke data som skal trekkes ut og hvordan de skal visualiseres.

VAQM-modellen

Dette er rotnode for enhver VAQM-konfigurasjon. Figuren under viser hvilke attributter og elementer som inngår i konfigurasjonen.

vaqm p1

En VAQM-konfigurasjon består av en eller flere AQL-bindinger og ingen eller flere dataelementer. AQL-bindinger og dataelementer innen samme VAQM-konfigurasjon er ikke nødvendigvis knyttet til hverandre; resultatsettet fra én AQL-binding kan benyttes i flere dataelementer, og et dataelement kan inneholde en kombinasjon av resultatsett fra flere AQL-bindinger.

Skjermbildereferanser VAQM

Følgende skjermelementer benyttes for administrasjon av VAQM-konfigurasjoner:

Skjermelement
Beskrivelse
Ikon

Filter (søkefelt)

Lar deg søke etter eksisterende VAQM-konfigurasjoner.

Legg til ny VAQM-konfigurasjon

For å opprette en ny VAQM-konfigurasjon.

16

Import

Trykk på dette ikonet for å importere en VAQM-konfigurasjon.

16

Oppdater

For å oppdatere filstrukturen i sidepanelet.

16

Inkluder slettede

Viser slettede VAQM-konfigurasjoner i sidepanelet.

Filstruktur i sidepanel

Filutforsker med oversikt over VAQM-konfigurasjoner med tilhørende AQL-bindinger og dataelementer.

Lagre VAQM

For å lagre VAQM-konfigurasjonen du jobber med.

16

Godkjenne VAQM

For å godkjenne VAQM-konfigurasjonen du jobber med.

16

Redigere VAQM

For å redigere en eksisterende VAQM-konfigurasjon.

16

Kopier VAQM-konfigurasjon til utklippstavle

Kopierer VAQM-konfigurasjonen i XML-format til utklippstavlen.

16

Eksporter VAQM-konfigurasjon

Trykk på dette ikonet for å eksportere en VAQM-konfigurasjon.

16

Ta kopi av en VAQM-konfigurasjon

Trykk på dette ikonet for å ta kopi og opprette en ny VAQM-konfigurasjon.

16

GUI-arkfane

Viser en GUI-representasjon av VAQM-konfigurasjonen.

XML-arkfane

Viser en XML-representasjon av VAQM-konfigurasjonen.

Lagre endringer

Lagrer endringer på én eller flere VAQM-konfigurasjoner (hvis du jobber med flere samtidig).

Slett VAQM

Sletter valgt VAQM-konfigurasjon fra filstrukturen i sidepanelet

16

VAQM-konfigurasjon {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Brukergrensesnittet til en VAQM-konfigurasjon er delt i to:

Sammendrag

Her vises et sammendrag av VAQM-konfigurasjonen

Elementer

Her vises VAQM-konfigurasjonens AQL-bindinger og dataelementer

Opprette en VAQM-konfigurasjon

For å opprette en VAQM-konfigurasjon, trykk på plussymbolet over listen med VAQM-konfigurasjoner. Et nytt innslag vil vises i filstrukturen i sidepanelet. I midten av skjermbildet vises skallet for VAQM-konfigurasjonen.

Felt
Beskrivelse

OID

Unik stringidentifikator for VAQM-bindingen. Skrives på følgende format: vaqm.namespace.name. Du kan ha flere namespace adskilt med punktum.

Navn

Navnet på VAQM-konfigurasjonen. Det er dette navnet som vises i filstrukturen. Hvis du eksporterer en VAQM, vil filnavnet være <navn>.<versjon>.vaqm.

Versjonskommentar

For å holde tritt med endringer fra versjon til versjon, bør du angi en kommentar i dette feltet vedrørende hva som er endret. Feltet er påkrevd når en VAQM-konfigurasjon opprettes.

VAQM-konfigurasjon → Sammendrag {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

En del metadatafelter er ikke redigerbare. Disse vises nederst i sammendraget:

Felt
Beskrivelse

ID (GUID)

En unik generert GUID for denne konfigurasjonen.

Importert

Angir om konfigurasjonen ble importert i det aktuelle systemet (true).

Godkjent

true dersom versjonen er godkjent, false ellers.

Slettet

Viser om en VAQM-konfigurasjonen er slettet eller ikke. Blank hvis ikke.

Slettet av

Viser hvem som eventuelt har slettet VAQM-konfigurasjonen.

Opprettet

Tidsstempelet for når versjonen ble opprettet.

Opprettet av

Brukernavnet til brukeren som opprettet konfigurasjonen.

Basert på versjon

Angir hvilken versjon konfigurasjonen er basert på. Dette gir VAQM-administratoren en mulighet til å følge historikken gjennom ulike versjoner.

Versjon

En semantisk versjonsidentifikator på versjonen. Settes automatisk av brukergrensesnittet.

VAQM-konfigurasjon → Sammendrag (Metadata) {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

AQL-bindinger

AQL-bindingen definerer hva som skal hentes ut fra openEHR-serveren gjennom AQL. Kort beskrevet er formålet med denne delen av konfigurasjonen å definere opp ett eller flere predikater. Predikatet vil i praksis være en AQL-spørring som gjøres mot openEHR-serveren.

vaqm p3

Det kan opprettes flere AQL-bindinger, hver av dem skilles fra hverandre ved hjelp av en ID og et navn. Videre vil hver AQL-binding ha et eller flere underelementer som stier, hvor-uttrykk og/eller sorteringsuttrykk som settes sammen til en komplett AQL-spørring i predikatet.

AQL-bindinger og dataelementer opprettes fra filstrukturen til venstre i skjermbildet. Du må utvide VAQM-konfigurasjonen ved å trykke på 16 til venstre for navnet for å opprette nye elementer.

For å opprette en ny AQL-binding eller et nytt dataelement, trykk på 16 til høyre for hhv. AQL-bindinger og Dataelementer.

Når du legger til en ny AQL-binding eller nytt dataelement, vil denne vises under Elementer i VAQM-konfigurasjonen.

Felt
Beskrivelse

OId

Unik ID for denne AQL-bindingen.

Navn

Unikt navn for denne AQL-bindingen.

Basis-Aql

Spørringen som utgjør grunnlaget for predikatet.

Standard arketype-id

Arketypen det spørres i. Format: openEHR-EHR-OBSERVATION.body_weight.v1

VAQM-konfigurasjon → Elementer → AQL-binding {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Eksempel: AQL-binding → Basis-Aql

1

Velger data fra a og a_a

2

Henviser til a (som er en composition)

3

Henviser til a_a (som er en arketype av typen observation i composition a)

Stier

Her oppretter du stiene til dataene du ønsker å hente ut. Du kan angi flere stier for å hente ut forskjellige data fra arketypen. Dette gjøres ved å trykke på Legg til (til høyre i skjermbildet).

vaqm p21
Felt
Beskrivelse

Id

Et navn på stien ned til dataene du ønsker å hente ut. Id-en benyttes for å referere til stien i hvor- og sorteringsuttrykkene, predikatet og dataelementer. På denne måten slipper du å skrive hele stien hver gang du trenger den. Id-en er unik innenfor AQL-bindingen den tilhører.

Referanseidentifikator

Referanse til composition eller arketype som inneholder dataene stien peker på

Verdi

Stien ned til dataene du ønsker å hente ut

Datatype

Datatypen til elementet stien peker på. I denne versjonen av VAQM har ikke feltet praktisk betydning, og kan derfor stå tomt.

AdminDescription

En mulighet for å gi mer utfyllende beskrivelse av formålet med de ulike stiene. Feltet er bare tilgjengelig i XML-visningen.

VAQM-konfigurasjon → Elementer → AQL-binding → Stier {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Eksempel: AQL-binding → Stier

Id

vekt

Referanseindikator

a_a

Sti

/data[at0002]/events[at0003]/data[at0001]/items[at0004]/value/magnitude

Datatype

DV_QUANTITY

Hvor-uttrykk

I hvor-uttrykket kan du filtrere hvilke data fra en sti du ønsker å hente ut.

vaqm p8
Felt
Beskrivelse

Id

Et navn på hvor-uttrykket (som du kan referere til i sorteringsuttrykket).

Sti

Referanse til en sti. For å referere til stien, skriv inn $, og VAQM vil foreslå tillatte verdier.

Operator

For å sammenligne verdien i sti-feltet med verdien i verdi-feltet.

Verdi

Verdien du skal sammenligne med.

AdminDescription

En mulighet for å gi mer utfyllende beskrivelse av formålet med hvor-uttrykket. Gjelder bare XML-visning.

VAQM-konfigurasjon → Elementer → AQL-binding → Hvor-uttrykk {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

I eksemplet under ser vi Basis-Aql-en utvidet med et hvor-uttrykk. I dette uttrykket refererer vi til en sti fra stier, og sammenligner denne verdien mot en verdi angitt i verdi-feltet (i dette tilfellet en vekt på 80).

AQL-binding → Hvor-uttrykk

Id

vektfilter

Sti

$vekt

Operator

>

Verdi

80

Dette gir følgende tillegg på Basis-AQL-en:

Sagt på en annen måte:

1

Hvor-uttrykk - som tar inn:

2

Referanseidentifikator som peker på arketypen eller composition som dataene befinner seg i

3

Stien til elementet fra stier, referert til som $vekt i hvor-uttrykket

4

operator fra hvor-uttrykket

5

verdi fra hvor-uttrykket

Sorterings-uttrykk

I denne delen av AQL-bindingen angir du hvordan resultatet av spørringen skal sorteres.

vaqm p18
Felt
Beskrivelse

Id

Et navn på sorterings-uttrykket (som gjør at du kan referere til det i predikatet)

Verdi

Her angir du hva du skal sortere etter. Skriv inn $ og VAQM vil foreslå tillatte verdier fra stier.

Stigende

Sett kryss her for stigende sortering (asc). Hvis du ikke krysser ut, vil synkende sortering gjelde (desc).

VAQM-konfigurasjon → Elementer → AQL-binding → Sorterings-uttrykk {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Eksempel: AQL-binding → Sorterings-uttrykk:

Id

vektsortering

Verdi

$vekt

Stigende

Dette vil gi følgende tillegg på AQL-spørringen:

Predikat

I predikatet setter du sammen hvor- og sorterings-uttrykkene, og resultatet blir den endelige AQL-spørringen for denne AQL-bindingen.

vaqm p24

Predikatet er definert som følger:

Felt
Beskrivelse

Id

Et unikt navn på predikatet (som gjør at du kan referere til det i dataelementet).

Hvor

Referanse til hvor eller filteruttrykket for predikatet. Skriv inn $ og VAQM vil foreslå tillatte verdier fra hvor-uttrykket.

Sorter etter

Angir hvordan utvalget skal sorteres, for eksempel ved å referere en sortering som gir nyeste data først. Skriv inn $ og VAQM vil foreslå tillatte verdier fra sorterings-uttrykket.

AdminDescription

Gir en mulighet for å gi mer utfyllende beskrivelse av formålet med predikatet. AdminDescription er ikke en del av GUI-visningen, og må eventuelt angis i XML-visningen - hvis ønskelig.

VAQM-konfigurasjon → Elementer → AQL-binding → Predikat {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

AQL-binding → Predikat

Id

Predikat1

Hvor

$vektfilter

Sortering

vektsortering

Dette gir følgende (komplette) AQL-spørring:

1

De første tre linjene inneholder basis-AQL-en

2

WHERE (hvor-uttrykk)

3

ORDER BY (sorterings-uttrykk)

For lesere som har erfaring med AQL, virker det kanskje unødvendig å måtte fylle ut alle feltene i de forskjellige uttrykkene for å generere den relativt enkle AQL-spørringen som vi har vist i eksemplet over. Du ser i midlertid raskt fordelen med VAQM når du skal sette sammen et dataelement hvor du kombinerer resultatet fra flere AQL-bindinger - som hver kan inneholde flere stier og predikater.

Nøkkelverdier

Nøkkelverdier er en rekke med nøkler og verdier for bindingen. Disse kan benyttes av ulike moduler og vil være beskrevet nærmere i disse. Feltene har ingen praktisk betydning for oppretting av pasientlistekolonner.

Dataelementer

Dataelementets funksjon er å visualisere og formatere data som er hentet ut via AQL-bindinger.

Et dataelement kan i teorien benyttes til å presentere data i flere moduler i Arena.

Fra og med Arena 17.1 blir dataelementer benyttet for å lage kolonner til pasientlisten.

Felt
Beskrivelse

Id(GUID)

En unik generert GUID for dette dataelementet. Feltet er skjult i GUI-visningen av dataelementet.

Oid

Unik Id for dette dataelementet.

Navn

Navn på dataelementet. Dette vil gå igjen i andre moduler som benytter dataelementet, f.eks. i kolonneoverskriften i en pasientlistekolonne.

Admin-navn

Navn på dataelementet slik det fremkommer i adminmoduler i Arena, f.eks i kolonneoverskriften slik den vises under tilgjengelige kolonner i pasientlisteadmin.

Beskrivelse

Teksten som legges inn her vises som tooltip når en sluttbruker holder musepekeren over en kolonneoverskrift.

Kategorier

Angir hvilken kategori i en kolonnegruppe i pasientlisteadmin kolonnen hører inn under. Du kan angi at kolonnen kan tilhøre flere kategorier ved å angi flere verdier skilt med komma.

Visningsformat

Her defineres innholdet i en celle slik det blir presentert for sluttbrukeren av en pasientliste. Du kan benytte funksjoner for å gjøre kalkulasjoner i celler. NB! Se avsnittet om kalkulasjoner og funksjoner for nødvendige forholdsregler som må tas. Notasjon: $Predikat1.$vekt. Funksjoner og kalkulasjoner må omsluttes av { og }.

Sorteringsformat

Hvilken datatype resultatet skal sorteres på. Pasientlisten sorterer som standard alfabetisk. Notasjon: $Predikat1.$vekt. Her vil datatypen til angitt element bestemme sorteringen.

X-format

Brukes ikke

Y-format

Brukes ikke

Områdeformat

Brukes ikke.

Mulig å redigere

Kryss av her hvis en bruker skal kunne endre innholdet i en celle direkte fra pasientlisten. Merk: For at en celle skal gjøres redigerbar må du i tillegg definere hvilke dokumentmaler og -typer som skal benyttes. Les mer om det i kapitlet om nøkkelverdier.

Eksempel: Dataelement → Visningsformat

I visningsformatfeltet kan du kombinere tekst med predikater:

Hvis du vil gjøre kalkulasjoner i tillegg, må disse omsluttes av { og }:

Dette er viktig, fordi hvis stien vekt peker på /value og ikke /value/magnitude, så kan du i visningsformatet legge til /magnitude:

Hvis du da ikke har mellomrom mellom /magnitude og divisjonstegnet /, så vil uttrykket tolkes som en sti ned til et element - hvilket blir feil:

Format-uttrykk

For å gi en bruker av en pasientliste tilbakemelding om at innholdet i en celle bør sees nærmere på, eller det av andre grunner er formålstjenlig å formatere den spesfikke forekomsten av dataelementet, er det mulig å legge på betinget formatering av innholdet. Et enkelt eksempel som illustrerer dette, er hvis cellen viser BMI og du ønsker å fremheve cellene som viser BMI over 25 forskjellig fra de over 30, under 20, osv.

Felt
Beskrivelse

Når

Betingelsen som skal utløse formatering av instansen av dataelementet. NB! Se avsnittet om kalkulasjoner og funksjoner for nødvendige forholdsregler som må tas. I motsetning til visningsformatfeltet skal ikke kalkulasjoner i når-feltet omsluttes av { og }.

Varslingstype

Du kan velge forhåndsdefinerte varslingstyper som følger DIPS standard for varslinger, eller du kan velge CUSTOM. Velger du CUSTOM står du fritt til å benytte de påfølgende feltene for formatering:

Symboltype

Dette feltet fylles ut automatisk basert på innholdet i symbol-feltet.

Tekstfarge

Farge på teksten.

Symbol

Tar inn vektorgrafikk fra Modern UI. Symboldata hentes fra http://modernuiicons.com/

Bakgrunnsfarge

Bakgrunnsfargen på cellen.

Symbolfarge

Fargen på symbolet.

Beskrivelse

Tooltip som vises når du holder musepekeren over innholdet i en formatert celle.

Nøkkelverdier

Hvis du har bestemt at en celle skal være mulig å redigere, må du definere hvilke dokumentmaler og -typer som skal ligge til grunn for registrering av data.

Dette kan gjøres på forskjellige måter:

  1. Ikke legge inn nøkkelverdier. Da vil standard visning for arketypen benyttes.

  2. Legge inn to nøkkelverdier, DocumentTemplateId og DocumentTypeId som nøkler og

    1. ID-ene til nøklene som verdier

    2. eller referanser til SystemConfig som verdier

  3. Legge inn en nøkkel, DocumentCreateConceptId, og navnet på dokumentkonseptet som verdi.

Nøkkelverdier-feltet består av en nedtrekksliste med tre valg:

Nøkkel
Verdi

DocumentTemplateId

Dokumentmal-id. Hentes fra Dokumentadmin → Maloversikt. Eksempel: 255831 Eller Referanse til nøkkel fra SystemConfig. Eksempel: $ARENA-VAQM-SYSTEMCONFIG/vaqm.vitalsigns.weight.documentTemplateId

DocumentTypeId

Dokumenttype-id. Hentes fra Dokumentadmin > Maloversikt. Eksempel: 1492 Eller Referanse til nøkkel fra SystemConfig. Eksempel: $ARENA-VAQM-SYSTEMCONFIG/vaqm.vitalsigns.weight.documentTypeId

DocumentCreateConceptId

Navnet på dokumentkonseptet. Hentes fra Dokumentadmin > Dokumentkonsept. Eksempel: $ARENA-HEALTHRECORD-DOCUMENTCONCEPT/Vitaletegn_Vekt

Kalkulasjoner og funksjoner

Innholdet i dette kapitlet omhandler bruk av funksjoner og kalkulasjoner i følgende felter:

Visningsformat

Siden visningsformatfeltet kan inneholde fritekst i tillegg til kalkulasjoner og funksjoner, må kalkulasjoner og funksjoner innkapsles med start- og sluttklammer { og }

Når

I når-feltet kan du ikke skrive inn fritekst, derfor skal ikke funksjoner og kalkulasjoner innkapsles.

Det er mulig å benytte kalkulasjoner og funksjoner for å gjøre utregninger på dataelementet. Dette gjøres i visningsformat-feltet. Videre kan resultatet formateres etter gitte kriterier. Det gjøres i når-feltet under format-uttrykk-seksjonen av dataelementet. Se liste over tilgjengelige funksjoner for en komplett oversikt.

Dataelement → Visningsformat med kalkulasjoner

Stier brukt i visningsformatet:

vekt

/data[at0002]/events[at0003]/data[at0001]/items[at0004]/value/magnitude

hoyde

/data[at0001]/events[at0002]/data[at0003]/items[at0004]/value/magnitude

Eksemplet over vil kjøre fint hvis alle rader returnerer verdier for både vekt og høyde. Men hva skjer hvis et av resultatene bare inneholder høyde, og ikke vekt? Da vil regnestykket feile. Derfor må vi benytte funksjoner for å validere resultatet av spørringen:

Dataelement → Visningsformat med kalkulasjoner og funksjoner

Funksjonen ifnull() prøver først å kjøre kalkulasjonen som angis i første parameter. Hvis kalkulasjonen returnerer NULL, vil dataelementet vise teksten i andre parameter. Hvis kalkulasjonen ikke returnerer NULL vil resultatet av kalkulasjonen vises på dataelementet.

Eksemplet over vil kjøre fint hvis alle vekter og høyder oppgis i hhv. kilo og centimeter. Men hva skjer hvis en vektstørrelse oppgis i gram, eller høyden i meter? Da har du to løsninger. Den ene er å ta høyde for det i kalkulasjonen i visningsformatet, og sjekke på alle enheter før du kjører riktig kalkulasjon. Den andre muligheten er å bruke formatuttrykket til å formatere cellen hvis vekt og/eller høyde ikke er oppgitt i kilo eller centimeter, og på den måten visualisere for brukeren at dataene i cellen ikke er til å stole på:

Dataelement → Format-uttrykk → Når-uttrykk med funksjoner og kalkulasjoner

Her sjekker vi først om noen av verdiene er NULL. Hvis én eller begge verdiene er NULL, vil ikke formateringen slå til. Hvis derimot begge verdier ikke er NULL, vil if() returnere false og når-uttrykket kjøres ikke for verdier oppgitt i kilo eller centimeter.

I eksemplet ovenfor brukte vi formatuttrykket for å informere sluttbrukeren om at resultatet i cellen ikke er til å stole på. Et annet brukstilfelle er å bruke format-uttrykket for å informerere sluttbrukeren om at cellen inneholder viktig informasjon, eller at innholdet overstiger en gitt grenseverdi:

Dataelement → Format-uttrykk → Når-uttrykk med funksjoner og kalkulasjoner

Igjen ser vi at verdiene som skal gi grunnlag for formateringen sjekkes for NULL før betingelsen utløses. I dette tilfellet vil vekt-verdier som overstiger 100 formateres med valgte farger for tekst, bakgrunn, osv.

Lagre en VAQM-konfigurasjon

Du lagrer en VAQM-konfigurasjon ved å trykke på 16 (eller Lagre endringer hvis du har flere VAQM-konfigurasjoner åpne samtidig).

Dataelementene til en lagret VAQM-konfigurasjon vil ikke være kunne brukes av andre moduler som for eksempel pasientlisten. For å oppnå dette, må VAQM-konfigurasjonen godkjennes.

Det benyttes semantisk versjonering ved lagring. Se neste avsnitt for forklaring.

Godkjenne en VAQM-konfigurasjon

For å gjøre VAQM-konfigurasjonens dataelementer tilgjengelige i andre moduler i Arena, må den godkjennes.

Du godkjenner en VAQM-konfigurasjon ved å trykke på 16

Versjonering av VAQM-konfigurasjoner

VAQM følger semantisk versjonering. Første gang du lagrer en VAQM-konfigurasjon, vil den få versjonsnummer 0.1.0. Neste gang du lagrer, vil versjonsnummeret øke til 0.2.0 osv. Når du godkjenner en VAQM-konfigurasjon første gang, vil versjonsnummeret øke til 1.0.0. Se Semver (ekstern lenke) for mer informasjon.

Hendelse
Versjonsnummer

VAQM-konfigurasjon opprettes

0.0.1

VAQM-konfigurasjon lagres første gang

0.1.0

VAQM-konfigurasjon lagres andre gang

0.2.0

VAQM-konfigurasjon godkjennes første gang

1.0.0

VAQM-konfigurasjon lagres for nte gang

1.n.0

VAQM-konfigurasjon godkjennes andre gang

2.0.0

Eksempel på versjonshistorikk {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Eksportere en VAQM-konfigurasjon

En VAQM-konfigurasjon kan eksporteres til en fil. Dette gjøres ved å trykke på eksportikonet 16 over VAQM-konfigurasjonen. En fildialog åpnes, og du lagrer filen på egnet sted. Filen lagres med filendelse .vaqm.

Importere en VAQM-konfigurasjon

En VAQM-konfigurasjon opprettet i et annet system (f.eks. ved en annen institusjon, eller i en editor utenfor DIPS Arena) kan importeres til Arena ved å trykke på importikonet 16.

Når du trykker på importikonet, vil en fildialog åpnes. Her velger du fila som inneholder VAQM-konfigurasjonen du ønsker å importere. Du kan kun importere filer med filendelse .vaqm.

En importert VAQM-konfigurasjon vil legge seg i filstrukturen i sidepanelet. For å synliggjøre at det er en importert konfigurasjon, vil den vises med teksten [Importert] etter filnavnet. Det vil i tillegg vises en stjerne (*) for å synliggjøre at den importerte konfigurasjonen ikke er lagret enda.

For å lagre konfigurasjonen i Arena, trykk på lagreikonet.

Importere ny versjon av eksisterende VAQM-konfigurasjon

Når du importerer en ny versjon av en tidligere importert VAQM-konfigurasjon, vil den legge seg i listen sammen med tidligere versjoner. Det som er viktig å legge merke til, er at pasientlisten alltid vil forholde seg til siste versjon. Det vil si at en aktiv pasientliste (som inneholder en VAQM-konfigurert kolonne) automatisk vil benytte siste versjon av kolonnen etter import av ny versjon.

Redigere en VAQM-konfigurasjon

Velg ønsket VAQM-konfigurasjon fra filstrukturen i sidepanelet. Trykk på blyantikonet 16 for å åpne VAQM-konfigurasjonen for redigering.

Du lagrer og godkjenner ved å bruke hhv. diskett- og hakeikonene (16 og 16).

Ta kopi av en VAQM-konfigurasjon

Velg ønsket VAQM-konfigurasjon i sidepanelet. Trykk på 16 for å lage en kopi av konfigurasjonen.

Slette en VAQM-konfigurasjon

I filstrukturen markerer du versjonen av VAQM-versjonen du ønsker å slette. Trykk deretter på minustegnet 16. VAQM-konfigurasjonen blir ikke slettet permanent, men den fjernes fra lista over godkjente konfigurasjoner.

For å synliggjøre at en VAQM-konfigurasjon er slettet, vil navnet gjennomstrekes før den forsvinner fra lista.

Gjenopprette slettede versjoner

For å vise slettede versjoner, huk av for Inkluder slettede, og trykk på oppdateringsikonet 16. Ekspander deretter beholderen for VAQM-konfigurasjonen i filstrukturen; slettede versjoner vises med strek gjennom filnavnet. Marker versjonen du ønsker å gjenopprette.

Avhengig av om slettet versjon er importert eller lokalt opprettet, gjelder følgende regler:

Importert

Trykk på rediger og deretter på lagre for å gjenopprette den. Den slettede versjonen vil gjenopprettes med samme versjonsnummer.

Lokalt opprettet

Trykk på rediger og deretter på lagre eller godkjenn for å gjenopprette den. Den slettede versjonen vil gjenopprettes med nytt versjonsnummer, og avhengig av om du har valgt å lagre eller godkjenne, vil versjonsnummeret følge reglene for semantisk versjonering.

VAQM: SystemConfig

Bakgrunn

SystemConfig ble introdusert sent i utvklingen av Arena 16.1. Løsningen kom frem fordi det var behov for å definere parameterverdier som er spesifikke for et system. Med system menes her en installasjon av DIPS Arena. F.eks. kan det være produksjon, produksjonslikt eller kursmiljø. Gjennnom systemkonfigurerte variabler kan øvrige konfigurasjoner holdes stabile, mens de miljøspesifikke endringene forvaltes i SystemConfig.

Funksjonalitet

SystemConfig er en enkel liste med nøkler og verdier. Administrator kan opprette nye nøkler med tilhørende verdier. Det finnes også funksjonalitet for å importere og eksportere komplette lister med nøkkelpar.

For å vise SystemConfig må bruker velge en VAQM konfigurasjon. Da kommer SystemConfig opp som egen arkfane.

VAQM-konfigurasjoner er strengt versjonerte. For SystemConfig er det ingen versjonering i denne versjonen. Det betyr at systemet kun forvalter en levende liste med nøkler. Når det gjøres endringer på disse så endres verdiene for alle moduler som benytter konfigurasjonen.

Legge til nøkkel

Administrator kan velge å legge til nytt nøkkelpar. Det er påkrevet å oppgi både nøkkel og verdi for den nye variabelen. Brukergrensesnittet tillater kun å legge til en ny unik nøkkel. Det betyr at det ikke er mulig å skrive inn en nøkkel som allerede eksisterer.

Slette nøkkel

Ved å trykke på minus knappen kan administrator slette en eksisterende nøkkel.

Eksport/Import

Fra administrasjonsgrensesnittet kan bruker eksportere og importere sett med nøkkelpar. Se Filformat for VAQM System konfigurasjon for eksempel på en konfigurasjonsfil med nøkkelpar og tilhørende verdier.

For å eksportere/importere må du:

  1. Åpne en VAQM-konfigurasjon

  2. Velge arkfanen SystemConfig

  3. Trykke på ikonene for import 16 eller eksport 16

Ved eksport trekker systemet ut alle nøkler med tilhørende verdier. Dersom administrator kun ønsker å ha med enkelte verdier disse fjernes fra den eksporterte fila.

Ved import skrives alle verdier fra den importerte fila inn i systemet.

Filformat for VAQM System konfigurasjon

Operational templates

Operational templates (OPT) er arketypenes rammeverk. Flere arketyper kan være samlet i en template. Her kan du angi egenskaper som å angi felt som obligatoriske, eller skjule ikke-obligatoriske felt. Ferdig templat må eksporteres fra Template Designer som en operational template. Denne OPT-en importeres til Arena enten via grensesnittet i arketypeadmin, eller via packagemanager og systemadmin.

Import av OPT

Import av OPT gjøres fra Arketypeadmin under arkfanen Operational Templates. Trykk på Import OPT for å lete frem filen. Merk at det bare lar seg gjøre å importere filer med endelsen .opt.

AQL-konfigurasjon

AQL-konfigurasjon er under utfasing. Benytt VAQM i stedet. Du kan fremdeles legge inn AQL-konfigurasjoner fra et annet miljø under avansert konfigurasjon. Vær nøye med å lime inn hele innholdet i XML-filen.

Funksjoner

Det er 101 tilgjengelige funksjoner for bruk i VAQM.

Logiske funksjoner

Funksjon
Beskrivelse

AND(logisk, [logisk2], …​)

Returnerer TRUE hvis alle argumenter er sanne.

OR (logisk1, logisk2, …​)

Returnerer TRUE hvis ett av argumentene er sann.

NOT (logisk_uttrykk)

Reverserer logikken i argumentet.

IF (logisk_test, verdi_hvis_sann, [verdi_hvis_usann])

Angir en logisk test som skal utføres.

TRUE()

Returnerer den logiske verdien TRUE.

FALSE()

Returnerer den logiske verdien FALSE.

IFNULL(verdi, verdi_hvis_null)

Returnerer angitt verdi hvis første parameter returnerer NULL. I motsatt tilfeller returneres (resultatet av) første parameter.

Tabell: Logiske funksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Matematikk- og trigonometrifunksjoner

Funksjon
Beskrivelse

ABS(tall)

Returnerer absoluttverdien til et tall

ACOS(tall)

Returnerer arcus cosinus til et tall

ASIN(tall)

Returnerer arcus sinus til et tall

ATAN(tall)

Returnerer arcus tangens til et tall

ATAN2(tall_x, tall_y)

Returnerer arcus tangens fra x- og y-koordinater

CEILING(tall,antall_sifre)

Runder av et tall oppover, bort fra null

COS (tall)

Returnerer cosinus til en gitt vinkel.

COSH (tall)

Returnerer den hyperbolske cosinus til et tall

EXP(tall)

Returnerer e opphøyd i en angitt potens

FLOOR(tall, antall_sifre)

Runder et tall ned, mot null.

INT (tall)

Runder av et tall nedover til nærmeste heltall.

LN(tall)

Returnerer den naturlige logaritmen til et tall

LOG(tall,[grunntall])

Returnerer logaritmen for et tall til et angitt grunntall

LOG10(tall)

Returnerer logaritmen med grunntall 10 for et tall

PI ()

Returnerer tallet 3,14159265358979, den matematiske konstanten pi, nøyaktig 15 sifre.

POWER (tall, potens)

Returnerer resultatet av et tall opphøyd i en potens.

RAND()

Returnerer et tilfeldig tall mellom 0 og 1

RANDBETWEEN (nederst, øverst)

Returnerer et tilfeldig heltall mellom tallene du angir. En ny tilfeldig heltall returneres hver gang funksjonen kjøres.

ROUND(tall, [antall])

Runder et tall til et angitt

SIGN(tall)

Finner tegnet til et tall. Returnerer 1 hvis tallet er positivt, 0 hvis tallet er 0, og -1 hvis tallet er negativt.

SIN (tall)

Returnerer sinus til en gitt vinkel.

SINH (tall)

Returnerer hyperbolsk sinus til et tall.

SQRT (antall)

Returnerer en positiv kvadratrot.

SUM (tall1, [tall2], …​)

SUM-funksjonen legger alle numrene du angir som argumenter.

TAN (tall)

Returnerer tangens til en gitt vinkel.

TANH (antall)

Returnerer hyperbolsk tangens til et tall.

TRUNC (tall, antall)

Avkorter et tall til et heltall ved å fjerne brøkdelen av nummeret.

Tabell: Matematikk- og trigonometrifunksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Tekstfunksjoner

Funksjon
Beskrivelse

CHAR(tall)

Returnerer tegnet som svarer til kodenummeret

CODE (tekst)

Returnerer en numerisk kode for det første tegnet i en tekststreng. Den returnerte koden tilsvarer tegnsettet som brukes av datamaskinen.

CONCATENATE (tekst1, [tekst2], …​)

CONCATENATE-funksjon setter sammen opptil 255 tekststrenger i en tekststreng. De sammenkoblede elementene kan være tekst, tall, cellereferanser, eller en kombinasjon av disse elementene. For eksempel, hvis regnearket inneholder en persons fornavn i celle A1 og personens etternavn i celle B1, kan du kombinere de to verdiene i en annen celle ved hjelp av følgende formel: = CONCATENATE (A1, \ "\, B1)

FIND(finn,innen_tekst, [startposisjon])

FIND finner en tekststreng inni en annen tekststreng og returnerer nummeret som svarer til startposisjonen for den første tekststrengen, regnet fra det første tegnet i den andre tekststrengen.

LEFT (tekst, antall_tegn)

LEFT returnerer det første tegnet eller tegnene i en tekststreng, basert på antall tegn du angir.

LEN (tekst)

LEN returnerer antall tegn i en tekststreng.

LOWER(tekst)

Konverterer store bokstaver til små.

MID(tekst, startposisjon, antall_tegn)

Returnerer et angitt antall tegn fra en tekststreng, og begynner fra posisjonen du angir

PROPER(tekst)

Forbokstav i en tekststreng og alle andre bokstaver i teksten som følger noe annet enn et brev karakter. Konverterer alle andre bokstaver til små bokstaver.

REPLACE(gammel_tekst, startposisjon, antall_tegn, ny_tekst)

Erstatter deler av en tekst, basert på antall tegn du angir, med en ny tekst.

REPT(tekst, antall_ganger)

Gjentar en tekst et gitt antall ganger.

RIGHT(tekst, antall_tegn)

Returnerer siste tegn i en tekst, basert på antall tegn du angir

SEARCH(søketekst, tekst, [startposisjon])

Finner en tekstverdi inne i en annen (skiller ikke mellom store og små bokstaver)

SUBSTITUTE (tekst, gammel_tekst, ny_tekst, instance_num)

Erstatter gammel_tekst med ny_tekst i en tekststreng. Bruk SUBSTITUTE når du vil erstatte bestemt tekst i en tekststreng; bruke REPLACE når du ønsker å erstatte tekst som oppstår på et bestemt sted i en tekststreng.

T (verdi)

Returnerer teksten referert til av verdi.

TEXT (verdi, [format_text])

TEXT-funksjonen konverterer en numerisk verdi til tekst og lar deg angi visningsformateringen ved hjelp av spesielle formatstrenger.

TRIM (tekst)

Fjerner alle mellomrom fra tekst med unntak av enkelt mellomrom mellom ord. Bruk TRIM på tekst som du har mottatt fra et annet program som kan ha uregelmessig mellomrom.

UPPER (tekst)

Konverterer tekst til store bokstaver.

VALUE (tekst)

Konverterer en tekststreng som representerer et tall til et tall.

CHOOSE(indeks, verdi1, [verdi2], …​)

Bruker indeks for å returnere en verdi fra listen med argumenter. Eksempel: CHOOSE(2, "a", "b", "c") returnerer "b"

Tabell: Tekstfunksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Statistikkfunksjoner

Funksjon
Beskrivelse

AVERAGE(tall1, [tall2], …​)

Returnerer gjennomsnittet for argumentene

AVERAGEA(verdi1,verdi2,…​)

Returnerer gjennomsnittet for argumentene, inkludert tall, tekst og logiske verdier

COUNT (verdi1, [verdi2], …​)

Teller hvor mange tall som er i argumentlisten

COUNTA (verdi1, [verdi2], …​)

COUNTA-funksjonen teller antall verdier som ikke er tomme i et område.

COUNTBLANK (verdi1, [verdi2], …​)

Teller tomme verdier i et angitt område av verdier.

COUNTIF (verdi1, [verdi2], …​, "> 2")

COUNTIF-funksjonen teller antall verdier innenfor et område som tilfredsstiller et enkelt kriterium som du angir.

MAX(tall1, tall2, …​)

Returnerer maksimumsverdien i en argumentliste

MAXA(verdi1, verdi2, …​)

Returnerer maksimumsverdien i en argumentliste, inkludert tall, tekst og logiske verdier

MIN(tall1, tall2, …​)

Returnerer minimumsverdien i en argumentliste

MINA(verdi1, verdi2, …​)

Returnerer den minste verdien i en argumentliste, inkludert tall, tekst og logiske verdier

STDEV (tall1, tall2, …​)

Anslår standardavvik basert på et utvalg. Standardavviket er et mål på hvor vidt verdier er dispergert fra gjennomsnittsverdien (middelverdien).

STDEVA (verdi1, verdi2, …​)

Anslår standardavvik basert på et utvalg. Standardavviket er et mål på hvor vidt verdier er dispergert fra gjennomsnittsverdien (middelverdien).

STDEVP (tall1, tall2, …​)

Beregner standardavvik basert på hele populasjonen gitt som argumenter. Standardavviket er et mål på hvor vidt verdier er dispergert fra gjennomsnittsverdien (middelverdien).

STDEVPA (verdi1, verdi2, …​)

Beregner standardavvik basert på hele populasjonen gitt som argumenter, inkludert tekst og logiske verdier. Standardavviket er et mål på hvor vidt verdier er dispergert fra gjennomsnittsverdien (middelverdien).

VAR (tall1, tall2, …​)

Estimater varians basert på et utvalg.

VARA (verdi1, verdi2, …​)

Estimater varians basert på et utvalg.

VARP (tall1, tall2, …​)

Beregner varians basert på hele populasjonen.

VARPA (verdi1, verdi2, …​)

Beregner varians basert på hele populasjonen.

Tabell: Statistikkfunksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Dato- og tidsfunksjoner

Funksjon
Beskrivelse

NOW()

Returnerer datetime som representerer gjeldende dato og klokkeslett.

TODAY()

Returnerer datetime som representerer dagens dato.

NOWTICKS ()

Returnerer antall ticks som representerer dagens datetime.

TODAYTICKS ()

Returnerer antall ticks som representerer dagens dato.

DATEVALUE ()

DATEVALUE-funksjonen konverterer en ISO 8601-dato eller -datetime fra string til ticks

DAYTICKS(dager)

DAYTICKS-funksjonen konverterer dager til ticks

HOURTICKS(antall_timer)

Konverterer timer til ticks

MINUTETICKS(antall_minutter)

Konverterer minutter til ticks

DATETIME (ticks)

Datetime-funksjonen konverterer ticks til datetime.

ISO8601DATETIME (ticks)

ISO8601DATETIME-funksjonen konverterer ticks til en ISO8601 datetime- streng.

ISO8601DATE (ticks)

ISO8601DATE funksjonen konverterer ticks til en ISO8601 datostreng.

ISO8601TIME (ticks)

ISO8601TIME-funksjonen konverterer ticks til en ISO8601 tidstreng.

WEEKNUM (ticks)

Returnerer uke i året som omfatter datoen i den angitte datetime verdi representert av ticks.

DURATIONTICKS(varighet)

DURATIONTICKS-funksjonen konverterer en iso8601-varighet (string) til ticks

DAYS(sluttdato, startdato)

Returnerer antall dager mellom to datoer

HOURS(slutt_dato, start_dato)

Returnerer antall timer mellom to datoer.

WEEKS (sluttdato, startdato)

Returnerer antall uker mellom to datoer.

MONTH(ticks)

Returnerer måneden av en dato representert som ticks. Måneden blir returnert som et heltall, fra 1 (januar) til 12 (desember).

YEAR (ticks)

Returnerer året av en dato representert av ticks. Året blir returnert som et heltall i området 0001-9999.

FORMATDATETIME(ticks, iso8601 datostring, [språk])

Gir valgfritt datoformat. Eks: formatdatetime(nowticks(), "D", "nb-no") gir "torsdag 6. oktober 2016". formatdatetime(nowticks(), "D", "en-us") gir "Thursday, October 6, 2016"

Informasjonsfunksjoner

Funksjon
Beskrivelse

ISBLANK (verdi)

Sjekker om en verdi har innhold. Benyttes for tekst. Må ikke forveksles med ISNULL().

ISNUMBER (verdi)

Sjekker om verdien er et tall.

ISNULL (verdi)

Sjekker om verdien er NULL, dvs. ingenting. Må ikke forveksles med ISBLANK().

NULL

Returnerer NULL.

Tabell: Informasjonsfunksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

OpenEhr-funksjoner

Funksjon
Beskrivelse

DURATION_TO_SECONDS(iso8601_duration_text)

Returnerer den numeriske verdien av en varighet i sekunder.

DURATION_TO_MINUTES(iso8601_duration_text)

Returnerer den numeriske verdien av en varighet i minutter.

DURATION_TO_HOURS(iso8601_duration_text)

Returnerer den numeriske verdien av en varighet i timer.

DURATION_TO_DAYS(iso8601_duration_text)

Returnerer den numeriske verdien av en varighet i dager.

Tabell: OpenEhr-funksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Templatevariabelfunksjoner

Funksjon
Beskrivelse

TEMPLATEVARIABLE("templatevariabelnavn")

templatevariabelnavn viser en templatevariabel (f.eks Pas.Fornavn).

Tabell: Templatevariabelfunksjoner {.tableblock .frame-ends .grid-none .stripes-odd .stretch}

Sist oppdatert