====== Doseringsenheder og Doseringsforslag ====== Dette afsnit beskriver datasættet for "doseringsenheder og doseringsforslag", således som det er til rådighed på stamdatamodulet på NSP'en. På NSP'en er der 2 meget forskellige versioner af doseringsforslag til rådighed * Den oprindelige version [[https://www.nspop.dk/display/web/Doseringsforslag+og+-enheder|Doseringsforslag V1]] er beskrevet yderligere i dette dokument. Version 1 har en del tekniske uhensigtsmæssigheder og vil blive lukket ned 1. juli 2019. * Den nye version er dokumenteret på [[https://www.nspop.dk/display/web/Doseringsforslag+og+-enheder+v.2|Doseringsforslag V2]]. Denne version er designet til at være datagrundlag til dosis-til-tekst JS komponenten, som er beskrevet på [[fmk:generel:doseringsoversaettelse|Doseringsoversættelse og -forslag]]. ===== Introduktion til doseringsforslag V1 (Deprecated) ===== Doseringsenheder og doseringsforslag består af to relaterede datasæt: I datasættet ”doseringsenheder” kan der knyttes en enhed til et lægemiddel. Enheden findes i ental og flertal, og definerer doseringsenheden for lægemidlet. Doseringsenheden er relateret til lægemidlets form og administrationsvej, men er ikke altid det samme. Eksempelvis kan lægemidlets form være ”filmovertrukne tabletter”, administrationsvej ”oral” og doseringsenheden ”tabletter”. I datasættet ”doseringsforslag” kan der knyttes et antal forslag til doseringer til et lægemiddel. Doseringsforslaget kan anvendes til at et system præsenterer den sundhedsfaglige for en række forslag til doseringer af det pågældende lægemiddel, det er dog vigtigt at bemærke, at sundhedspersonen har ansvaret for at patienten medicineres med en korrekt dosering, og at doseringsforslaget netop kun er et forslag. Doserinsforslag erstatter doseringskode og -tekst i taksten (”Medicinpriser”), og anvendes ved dosering via Det Fælles Medicinkort (FMK). For mere information omkring FMK og doseringer i FMK henvises til afsnittet [[fmk:generel:doseringsenheder_og_doseringsforslag|Doseringsenheder og Doseringsforslag]] omkring FMK generelt. Fast definerede doseringsenheder er en nødvendighed for doseringsforslag, derfor udarbejdes og udstilles disse to sæt data samlet. ===== Målgruppe ===== Doseringsenheder og doseringsforslag vil være særligt anvendelige for systemer hvori en patients medicinering oprettes eller ændres. Dvs. først og fremmest systemer til praksislæger, speciallæger, tandlæger m.v. og EPJ systemer. ===== Udbyder af data og dataleverandør ===== Udbyder af data, dataansvarlig og dataleverandør er Sundhedsdatastyrelsen (SDS). Doseringsenheder og doseringsforslag er ikke på nogen måde følsomme, og kan derfor udstilles til alle interesserede. ===== Særlige forhold omkring data ===== Der er ingen særlige forhold omkring data. Doseringsenheder og doseringsforslag er ikke på nogen måde følsomme, og kan derfor udstilles til alle interesserede. ===== Udtræksmuligheder (kopi, abonnement, enkelt opslag) ===== Data udstilles som en komplet version der kan hentes som kopi. Bemærk, at indholdet i datasættet er versioneret med et RelaseNumber. En ny version udstilles med et nyt ReleaseNumber. ===== Opdatering af data ===== Opdatering af data forventes at ske med varierende regularitet, specielt i en indkøringsfase. ===== Versionsstyring ===== Datasættet uploades som en komplet version, hvor ReleaseNumber (se herunder) angiver hvilken version doseringsforslag og doseringenheder tilhører. Bemært, at dette medfører at et kopiregisterudtræk kan indeholde flere versioner, hvor kun seneste version skal anvendes. I ”dosageversion” underdatasættet findes der information omkring takstversion m.v. som doseringsforslag er oprettet på baggrund af. Se beskrivelse heraf herunder. ===== Feltbeskrivelser ===== I det følgende beskrives de underdatasæt der indgår i doseringsenheder og doseringsforslag. Figuren herunder beskriver relationerne mellem underdatasættene. Bemærk at navne for underdata herunder er vist med CamelCase for at øge læsbarheden, i udtrækket er navne på underdatasæt med småt. {{ :fmk:stamdata:model.png?nolink&400 | Model }} ==== Version ==== "Version" indeholder versioneringsinformation. Bemærk at rækkefølgen ikke nødvendigvis stemmer overens med hvad stamdatamodulet afleverer. ^ Felt ^ Beskrivelse ^ Type ^ Længde/format ^ Særlige forhold ^ | releaseNumber | Unikt release­nummer | Heltal | 15 cifre | Obligatorisk | | releaseDate | Dato filen er released | Dato | yyyy-MM-dd | Obligatorisk | | lmsDate | Dato for Lægemiddel­styrelsens takst (”Medicinpriser”) fra, som datasættet er udarbejdet på baggrund af. | Dato | yyyy-MM-dd | Obligatorisk | | daDate | Ikke anvendt, udfyldt med 2010-01-01 | Dato | yyyy-MM-dd | Obligatorisk | | validFrom | Datasættet gældende fra og med, svarende til ”ikrafttrædelsesdato” | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | validTo | Datasættet gældende til dato og tid | 2999-12-31T 00:00:00.000+01:00 såfremt gyldig indtil videre | Dato og tid med tidszone yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | === Eksempel === Herunder vises et eksempel på response. Omgivende elemeter fra atom-feed er udeladt. 2000-01-01 2013-05-27 2013-06-03 7 2013-06-03T00:00:00.000+02:00 2999-12-31T00:00:00.000+01:00 ==== DosageUnit ==== "DosageUnit" indeholder anvendte doseringsenheder. ^ Felt ^ Beskrivelse ^ Type ^ Længde/format ^ Særlige forhold ^ | releaseNumber | Reference til ReleaseNumber i Version | Heltal | 15 cifre | Obligatorisk | | code | Unik kode for doseringsenheden. __Bemærk at koden er kun unik i denne version af datasættet.__ | Heltal | 4 cifre | Obligatorisk | | textSingular | Doseringenhedens tekst i ental | Streng | 100 tegn | Obligatorisk | | textPlural | Doseringenhedens tekst i flertal | Streng | 100 tegn| Obligatorisk | | validFrom | Som validFrom i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | validTo| Som validTo i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | === Eksempel === Herunder vises et eksempel på response. Omgivende elemeter fra atom-feed er udeladt. 7 1033 pust pust 2013-06-03T00:00:00.000+02:00 2999-12-31T00:00:00.000+01:00 ==== DosageStructure ==== "DosageStrucuture" indeholder XML for strukturerede doseringer, i den form de anvendes i FMK. ^ Felt ^ Beskrivelse ^ Type ^ Længde/format ^ Særlige forhold ^ | releaseNumber | Reference til ReleaseNumber i Version | Heltal | 15 cifre | Obligatorisk | | code | Unik kode for den strukturede dosering. __Koden er dog kun unik i denne version af datasættet.__ | Heltal | 11 cifre | Obligatorisk | | type | Typen af dosering, enten "M+M+A+N", "PN", "N daglig", "Fritekst" eller "Kompleks" | Streng | 100 tegn | Obligatorisk | | simpleString | For simple typer (dvs. en stor del af dosinger der ikke er af type "Kompleks") indeholder feltet doseringen på simpel form. | Streng | 100 tegn | Optionelt | | supplementaryText | For simple typer en eventuel supplerende tekst. | Streng | 200 tegn | Optionelt | | xml | FMKs doseringer i XML. Se herunder. | Streng | 10000 tegn | Obligatorisk | | shortTranslation | Såfremt det er muligt at lave en kort doseringstekst på baggrund af xml og lægemidlets doseringsenhed vil dette felt indeholde denne. | Streng | 70 tegn | Optionelt | | longTranslation | En lang doseringstekst baggrund af XML og lægemidlets doseringsenhed. | Streng | 10000 tegn | Obligatorisk | | validFrom | Som validFrom i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | validTo| Som validTo i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | Feltet XML vil indeholde en eller flere XML-dokumenter for FMKs doseringer, aktuelt i 1.2.6, 1.4.0 og 1.4.2 format. Eksemplet herunder viser XML for en dosering ”1 tablet morgen” i de tre namespaces. DosageProposals elementet indeholder et eller flere Dosage-elementer. Dosage-elementet indeholder først en FMK-version og herefter en dosering som den vil se ud for denne FMK-version, med passende skema- og namespace-erklæringer m.v. DosageProposals-elementet er defineret i et separat namespace, der ellers ikke er anvendt, for at undgå sammenfald af namespaces. Bemærk at det vil være nødvendigt at tilpasse StartDate og EndDate. 1.2.6 1 2010-01-01 2110-01-01 tabletter 1 1 1.4.0 1 2010-01-01 2110-01-01 tablet tabletter 1 morning 1 1.4.2 tablet tabletter 1 2010-01-01 2110-01-01 1 morning 1 ==== Drug ==== "Drug" indeholder information om lægemidlers drugid og doseringsenhed. ^ Felt ^ Beskrivelse ^ Type ^ Længde/format ^ Særlige forhold ^ | releaseNumber | Reference til ReleaseNumber i Version | Heltal | 15 cifre | Obligatorisk | | drugId | Lægemidlets drugid | Heltal | 11 cifre | Obligatorisk | | drugName | Lægemidlets navn | Streng | 50 tegn | Obligatorisk | | dosageUnitCode | Reference til code i DosageUnits | Heltal | 4 cifre | Obligatorisk | | validFrom | Som validFrom i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | validTo| Som validTo i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | === Eksempel=== Herunder vises et eksempel på et enkelt Drug-element fra responset. Omgivende elemeter fra atom-feed er udeladt. 7 28104152007 Fentanyl "Sandoz" 1028 2013-06-03T00:00:00.000+02:00 2999-12-31T00:00:00.000+01:00 ==== DrugDosageStructureRelation ==== "DrugDosageStructureRelation" er en referencetabel, der knytter doseringsstrukturer i DosageStructures til lægemidler. ^ Felt ^ Beskrivelse ^ Type ^ Længde/format ^ Særlige forhold ^ | releaseNumber | Reference til ReleaseNumber i Version | Heltal | 15 cifre | Obligatorisk | | drugId | Reference til DrugId i Drugs | Heltal | 11 cifre | Obligatorisk | | dosageStructureCode | Reference til code i DosageStructures | Heltal | 11 cifre | Obligatorisk | | validFrom | Som validFrom i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | validTo| Som validTo i "Version" | Dato og tid med tidszone | yyyy-MM-ddTHH:mm:ss+Z | Obligatorisk | | id | Teknisk nøgle (drugid+releaseNumber) | Heltal | 30 cifre | Obligatorisk | ===== Yderligere information ===== For mere information omkring FMK og doseringer, se [[fmk:generel:doseringsenheder_og_doseringsforslag|Doseringsenheder og Doseringsforslag]]