Arketype - innhold og stilguide

Enkelt navn som omfatter arketypens omfang og intensjon.

Kun første bokstav i hele konseptnavnet skal være stor bokstav og resten av navnet skrives med små bokstaver. Unntak inkluderer substantiv hvor skrivemåten er definert (eks qSOFA) eller akronymer.

ACVPU skala

INSTRUCTION arketypens navn inkluderer ordet “ordinering” (en: ‘order’), “forespørsel” (en:'request') eller tilsvarende.

ACTION arketypenavnet inneholder bare konseptet eller arketypens spesifiserte hensikt.

INSTRUCTION: "Helsetjenesteforespørsel" & ACTION: "Prosedyre"

INSTRUCTION: "Legemiddelordinering" & ACTION: "Legemiddelhåndtering"

Definisjonen av “konseptnavnet'“. Intensjonen med beskrivelsen er å definere konseptet slik klinikere anvender det i klinisk praksis, ikke den faglige eller ordbokdefinisjonen av konseptet.

“Forespørsel om utførelse av en helsetjeneste, til annet helsepersonell eller andre organisasjoner.”

Start med “For å registrere”… eller tilsvarende.

• Start med “Brukes for å registrere”… eller tilsvarende. Dersom det er hensiktsmessig sørg for at det samsvarer med Formål.

• Hvis arketypen er laget for å brukes i en familie av arketyper, må du ta med hvilke arketyper som er ment å brukes i interne SLOTer eller hvor arketypen kan nøstes i andre arketyper.

“Ved å benytte flere instanser av arketypen CLUSTER.housing_record (Bolig) i SLOTet "Bolig" kan man registrere en historikk over tidligere og nåværende boliger. Dette gir fleksibilitet til å registrere at et individ bor på mer enn ett sted i samme tidsperiode, for eksempel primærbolig og feriehus etc.”

• Forklar hvordan et “SLOT” er ment brukt for å utvide konseptet ytterligere.

“En grunnleggende antagelse for denne arketypen er at den er en forespørsel for én enkelt helsetjeneste. Dersom man trenger en gjentagende tjeneste, kan dette spesifiseres ved å bruke arketypen CLUSTER.service_direction i SLOTet "Kompleks timing".

• Start med "Brukes ikke for å registrere"... eller tilsvarende.

Referanser i publiserte arketyper bør være i samsvar med Citing Medicine, 2. utgave - NLM Style Guide for Authors, Editors and Publishers.

https://www.ncbi.nlm.nih.gov/books/NBK7256/?amp=&depth=2.

National Library of Medicine gir en enkel måte å sikre korrekt formatering ved bruk av et referanseverktøy som automatisk kan konfigurere referansen for en rekke forskjellige publikasjoner. Hvis den nødvendige referansen ikke er funnet i PubMed-søket, vil koblingen ovenfor støtte manuell formatering, f.eks. referanser til deler i et nettsted.

https://www.ncbi.nlm.nih.gov/sites/myncbi/

Referanser til andre arketyper eller deler av arketyper innen CKM kan finnes på fanen “Del med kollega” for hver arketype.

https://arketyper.no/ckm/archetypes/1078.36.2337/sharewithcolleague

CKM avviklet.

For eksempel: "Avledet fra: Employment summary, utkast til arketype [Internett]. Australian Digital Health Agency (MEHTA), ADHD Clinical Knowledge Manager. Ikke lenger tilgjengelig."

Referere en FHIR-ressurs.

Samsvares med: "HL7 FHIR ressurs - <ressursnavn> <utgivelse> [Internett]. Health Level Seven International; [åpnet <dato>]. Tilgjengelig fra: <permanent versjon- eller utgivelsesspesifikk URL>."

For eksempel: "HL7 FHIR ressurs - AllergyIntolerance R1.2.0 STU3 utkast [Internett]. Health Level Seven International; [hentet 17 januar 2020]. Tilgjengelig fra: http://hl7.org/fhir/2016Jan/allergyintolerance.html."

Merk: FHIR-nettstedet bruker en enkelt hyperkobling for alltid å få tilgang til den nyeste versjonen av en FHIR-ressurs. For å opprette en referanse til en bestemt versjon av en FHIR-ressurs, se FHIR publication history, hvor du vil kunne finne en URL for utgivelsen, og en permanent URL for hver ressurs i utgivelsen.

Copyright

copyright = <"© openEHR Foundation">

Retningslinje for brukerformidling av eksternt opphavsrettslig beskyttet innhold.

Inkluder uttalelser som beskriver opphavsretten, link til formell opphavsrettserklæring og tillatelser til bruk av informasjonen. For eksempel:

openEHR-arketyper er fritt tilgjengelige under en åpen lisens, men det spesifikke innholdet i denne Clinical Frailty Scale-arketypen er opphavsrettslig beskyttet. All bruk av denne arketypen i implementasjoner må gjøres i henhold til vilkår gitt av innehaverne av opphavsretten.

Erklæring om opphavsrett: ©2009. Version 1.2_EN. All rights reserved. Geriatric Medicine Research, Dalhousie University, Halifax, Canada.

Informasjon om opphavsretten: https://www.dal.ca/sites/gmr/our-tools/clinical-frailty-scale.html.

["lisens"] = <Dette arbeidet er lisensiert under Creative Commons Attribution-ShareAlike 4.0 International License. Hvis du vil se en kopi av denne lisensen, kan du gå til http://creativecommons.org/licenses/by-sa/4.0/.>

Inntil verktøyet blir utviklet til å kunne utføre dette gjennom et standardgrensesnitt kan du, via Notepad eller tilsvarende, manuelt legge dette i "other_details = <" delen av arketypens ADL:

["ip_acknowledgements"] = <"Denne arketypen inneholder innhold fra SNOMED Clinical Terms® (SNOMED CT®) som er opphavsrettsbeskyttet materiale fra International Health Terminology Standards Development Organization (IHTSDO). Ved en implementering av denne arketypen som bruker SNOMED CT-innhold , må implementatoren ha den aktuelle SNOMED CT-tilknyttede lisensen. For mer informasjon ta kontakt http://www.snomed.org/snomed-ct/get-snomedct eller info@snomed.org.">

Vanligvis obligatorisk da resten av dataelementene i arketypen ikke gir mening dersom objektet for undersøkelsen ikke er definert.

Øret(ene) som teststimulusen utført på.

Høyre øre [Teststimulene ble bare utført på høyre øre.] Eller [Det høyre øret ble undersøkt.]

Venstre øre [Teststimulene ble bare utført på venstre øre.] Eller [Det venstre øret ble undersøkt.]

Binaural [Teststimulene ble utført på begge ører samtidig i et lydfelt.] Eller [Begge ørene ble undersøkt samtidig.]

Navnet og / eller koden for det konseptet arketypen handler om. For eksempel laboratorieanalyser, problem / diagnose eller legemidler.

Intensjonen med beskrivelsen er å formulere konseptet slik klinikere anvender det i klinisk praksis og ikke det faglige- eller ordbokdefinisjonen av begrepet.

Beskrivelse:

Navnet på <XYZ> <...>.

Kommentar: 

Koding med en terminologi er ønskelig, der det er mulig.

Koding med en terminologi valgfritt.

Følger mønsteret til arketyper for fysiske undersøkelser (CLUSTER.exam).

Fritekstbeskrivelse av de samlede funnene som ble observert under den fysiske undersøkelsen.

Fritekstbeskrivelse av de viktigste funnene.

Navnet på et dataelement som brukes for å beskrive en startdato for en aktivitet, eller alderen til et individ ved starttidspunktet.

Navnet på et dataelement som brukes for å beskrive stoppdato for aktivitet eller alderen til et individ ved evt. død

En SLOT til å sette inn CLUSTER.multimedia-arketypen.

Digital bilde, video eller diagram som representerer funnene.

Det siste dataelement i mange arketyper. Brukes til å beskrive data som kanskje ikke er strukturert ennå eller ikke passer inn i noe annet generelt beskrivende dataelement.

Kan ha flere forekomster ved behov.

Tekstlig tilleggsinformasjon om <sett inn en passende frase her, f.eks. analyseresultat og tolkning av dette> som ikke er registrert i andre felt.

Ytterligere fritekst <sett inn en passende frase her, f.eks. analyseresultat og tolkning av dette> som ikke er omfattet av andre felt.

Tekstlig tilleggsinformasjon om måling av kroppsvekt, som ikke er registrert i andre felt.

(Ytterligere) Forhold eller faktorer/omstendigheter som kan påvirke tolkningen av <sett inn passende frase> som ikke er registrert/omfattet i andre felter.

Standard uspesifisert tidspunkt- eller intervallhendelse som kan defineres mer eksplisitt i et templat eller i en applikasjon.

Standard uspesifisert tidspunkthendelse som kan defineres mer eksplisitt i et templat eller i en applikasjon.

Lagt til i Protokolldelen for hver COMPOSITION eller ENTRY arketype for å gi mulighet til lokale utvidelser eller potensiell justering ved bruk av andre modelleringsparadigmer.

Beskrivelse:

Ytterligere informasjon som trengs for å kunne registrere lokalt definert innhold eller for å tilpasse til andre referansemodeller eller formalismer.

Kommentar: 

For eksempel: lokale informasjonsbehov eller ytterligere metadata for å kunne tilpasse til tilsvarende konsepter i FHIR.

Det fullstendige navnet på skåringsverktøyet eller skalaen.

Hvis det i tillegg til det fullstendig navnet brukes et akronym (forkortelse) skal bokstavene som brukes i akronymet være skrevet i store bokstaver, samt at man har med akronymet i parentes.

Hvis det mest vanlige brukte navnet er et akronym skal dette brukes som konseptnavn.

Apgar skår - OBSERVATION.apgar
Braden-skala - OBSERVATION.braden_scale

Edmonton Symptom Assessment System - revidert versjon (ESAS-r) - OBSERVATION.esas_r

ACVPU skala - OBSERVATION.acvpu
NEWS2 Skår - OBSERVATION.news2
ECOG funksjonsstatus - OBSERVATION.ecog

 

Samme som konseptnavn, men uten ordet 'skala' eller 'skår' - med mindre det er nødvendig å skille denne fra andre arketyper med et lignende navn.

Se ekesmplene over. Et annet eksempel er OBSERVATION.grace_admission and OBSERVATION.grace_discharge.

En forklaring på konseptet som blir dokumentert/registrert.

Et skåringsverktøy som blir brukt til å forutsi risiko for slag hos pasienter med arterieflimmer.

Beskrivelse på hvorfor man bruker denne arketypen til dokumentering/registrering av data og ikke en beskrivelse av selve konseptet, skåren eller skalaen.

For å registrere resultatene for hver enkelt parameter og deres totale sum/skår for ATRIA-slagrisikoskår.

Skal brukes til å fortelle hvordan arketypen kan brukes i implementeringen og ikke hvordan vurderingen utføres.

Begynn første setning med standarduttrykket "Brukes til å registrere ..." med mindre det er en god grunn til ikke å gjøre det.

Ytterligere informasjon kan gi veiledning til den som modellerer eller implementerer om arketypen skal brukes i maler eller kliniske systemer.

Brukes for å registrere resultatene for hvert enkelt parameter og deres totale sum/skår for ATRIA-slagrisikoskår.

Den totale summen av de enkelte parameterene for HSkår / NEWS2 Skår.

Totalsummen av de enkelte parameterne for skåren.

Etter en diskussion (01 2020), vil fremtidige arketyper ikke ha feltet "konfunderende” faktorer" eksplisitt modellert, med mindre det er en spesifikk parameter i det publiserte konseptet. Bruk heller "Extension" SLOT for å registrere konfunderende faktorer for spesifikke tilfeller eller kliniske scenarier hvis det er nødvendig.

Etter en diskusjon (01 2020), vil ikke fremtidige arketyper ha feltet “Kommentar” eksplisitt modellert, med mindre det er en spesifikk parameter i det publiserte konseptet. Bruk heller "Tilleggsinformasjon" SLOT for å registrere konfunderende faktorer for spesifikke tilfeller eller kliniske scenarier hvis det er nødvendig.

Etter en diskusjon (01 2020), vil ikke fremtidige arketyper ha andre elementer/felt eksplisitt modellert, med mindre det er en spesifikk parameter i det publiserte konseptet. Bruk heller "Tilleggsinformasjon" SLOT for å registrere konfunderende faktorer for spesifikke tilfeller eller kliniske scenarier hvis det er nødvendig.

Standardhendelsen settes til 'Uspesifisert tidspunkthendelse' (0 .. *) med mindre det er klinisk hensiktsmessig å registrere intervallhendelser med flere registreringer gjort over en tidsperiode f.eks. gjennomsnitt eller maksverdi osv. Dette er uvanlig med skår eller skalaer (i motsetning til kliniske målinger som vekt eller pulsfrekvens).

Punktlister

Hvis det er påkrevd å bruke nøkkelpunkter/punktliste (bullet points) i teksten, brukes det en bindestrek ('-') etterfulgt av et mellomrom og selve teksten. Teksten skal ikke begynne med store bokstaver.

For eksempel:

Triggere for å lukke en episode og starte en ny, vil i stor grad gjenspeile lokale preferanser for innsamling av data, inkludert hvis personen:

- slutter i en signifikant periode (som sannsynligvis vil bli definert lokalt)

- endrer betydelig bruk eller mønsteret for bruken