FMK Bruger dokumentation Administrativ GUI Trifork A/S Margrethepladsen 3 DK-8000 Århus C Denmark Phone: +45 8732 8787 Fax: +45 8732 8788 www.trifork.com
Versionering Version Dato Forfatter Ændring 0.0.1 2009-01-22 TBO Init 1.0 2009-02-05 ELS Redigeret afsnit 1.2 1.2.4 2009-09-15 2011-07-11 ELS ELS Nyt, Ugyldiggørelse af kort Revideret til FMK 1.2.4. Nyt login, whitelistning af systemer samt rolle-rettigheds-vedligeholdelse Side 2
Indhold Indhold...3 1 FMK, den administrative brugergrænseflade...4 1.1 Adm. GUI generelt...4 2 Søg...7 2.1 Søg medicinkort...7 2.2 Søg ordinationer...10 2.3 Søg effektueringer...12 3 Log...13 3.1 Søg auditlog...13 4 Adgang...14 4.1 Brugere...14 4.2 Lægens medhjælp...15 4.3 Roller og rettigheder...16 4.4 Systemer...18 5 Test...19 5.1 Send XML...19 5.2 Testdata...20 6 Luk alle faner...21 7 Log ud...22 Side 3
1 FMK, den administrative brugergrænseflade 1.1 Adm. GUI generelt Denne brugermanual indeholder en beskrivelse af den browserbaserede brugergrænseflade, der stilles til rådighed for Lægemiddelstyrelsen som data-ejer af Det Fælles medicinkort, kaldet FMK. I vejledningen anvendes følgende format: Menupunkter angives med fed, kursiv: fx Luk alle faner Menu, Underpunkter angives med kursiv: fx Medicinkort Knapper angives omgivet af <>: fx <Søg> Den administrative brugergrænseflade, herefter kaldet Adm. GUI giver adgang til at administrere systemer, roller og rettigheder, systemer samt brugere og fremsøge data i FMK. Det er således muligt at fremsøge: Medicinkort, Ordinationer, Effektueringer og Log (systemets auditlog). Det er ikke muligt at ændre eller slette data, dog med undtagelse af muligheden for at frigive et suspenderet medicinkort samt at ugyldiggøre/ophæve ugyldiggørelsen af et medicinkort. Endvidere giver Adm.GUI en mulighed for at administrere systemer i form af whitelistning, roller og tilhørende rettigheder, brugere, som skal have adgang til de administrative funktioner. Administratorer kan også administrere lægens medhjælp, forstået således at der oprettes en relation mellem en læge og dennes medhjælper, hvorved lægens medhjælp kan opnå adgang til FMK. Lægen kan imidlertid selv administrere denne opgave på www.medicin-it.dk. Brugerfladen tilgås via en webbrowser. Applikationen er beskyttet med Nemlogin og der skal derfor benyttes et medarbejdercertifikat for at opnå adgang. Kun medarbejdercertifikater udstedt til hhv. LMS og Triforks CVR-numre giver adgang. CPR-nummeret på medarbejderen skal endvidere findes i dertil indrettet personliste indeholdende godkendte medarbejdere. Når brugeren er logget ind vises menuen i venstre side. Ved at klikke på et punkt i menuen, foldes punktet ud og der vises et antal underpunkter, som det ses herunder for menupunktet Søg. Når man vælger et underpunkt, oprettes en ny fane til højre for menuen. Hvis der klikkes på et link inde i programmet, vil der ligeledes blive oprettet en ny fane. Side 4
Det er muligt at åbne vilkårligt mange faner. Der kan navigeres imellem fanerne ved at klikke på dem og de kan lukkes via krydset i fane titlen. Menupunktet Luk alle faner lukker alle åbne faner på en gang. Flere steder i programmet er det muligt at fremsøge data givet en række søgekriterier. Efter indtastning af et kriterium, viser programmet hvor mange rækker søgningen vil returnere. Tallet vises i boxen Resultater, som ses i skærmbilledet herunder. Tallet vises med rødt, når det overskrider den acceptable grænse og <Søg> er disablet. Hvis flere kriterier udfyldes, vil søgningen typisk returnere færre rækker. Når antallet af returnerede rækker er acceptabel (mindre end 200), vil resultatet vises med sort tekst som i eksemplet herunder. Resultatet af søgningen overføres ved at trykke på knappen <Søg>. Side 5
De overførte rækker vises nu nederst: Midt på siden vises en blok med kolonner. Her kan kolonner til- og fravælges efter behov. Udvælgelsen af kolonner sker efter visning af de fremfundne rækker. Billedet udvides og indskrænkes ud fra de kolonner, der ønskes vist. Side 6
2 Søg Menupunktet Søg rummer mulighed for søgning i patientrelaterede data. Når Søg vælges i menuen, dukker 3 underpunkter frem: Medicinkort, Ordinationer og Effektueringer 2.1 Søg medicinkort Fra Søg menuens underpunkt Medicinkort findes en patients medicinkort ved at indtaste personens CPRnummer. Det indtastede valideres løbende. Når 10 korrekte cifre er indtastet, bliver patientens navn vist. Nummeret for nyeste version af medicinkortet vises også i den midterste blok. Hver gang et medicinkort bliver ændret, arkiveres den tidligere version. Man kan fremsøge tidligere versioner af medicinkortet, enten via versionsnummer (ved at åbne drop down listen efter versionsnummeret) eller ved at indtaste en gyldighedsdato. Det ønskede medicinkort hentes frem ved at aktivere <Hent medicinkort>. Det fremsøgte medicinkort viser patientens navn og adresse, hvornår det sidst er ændret og af hvem, kortets status (eks. aktiv, suspenderet, pauseret, ingen medicinkort), Lægemiddel-ordinationer oprettet i FMK, Løse receptordinationer (recepter fra receptserveren der ikke er tilknyttet FMK ordinationer) og Versioner (listen af tidligere versioner). Fra siden er det muligt at navigere til tidligere versioner af medicinkortet og til ordinationer givet via FMK. Som udgangspunkt er Løse receptordinationer og Versioner ikke foldet ud, når medicinkortet vises. De respektive områder åbnes ved at klikke i højre side i den ønskede blok. Bemærk endvidere muligheden for at til- og fravælge kolonner. Side 7
Herunder ses visning af et medicinkort. Bemærk, at medicinkortet er åbnet på en særskilt fane, hvor den første fane stadig er der til fremsøgning af et andet medicinkort. Fra medicinkortets ordinationsliste, kan man vælge at få vist detaljer for en enkelt ordination. Billedet, som vises er det samme, som hvis ordinationen var fundet under Søg ordinationer. Detaljer for ordinationen vises på en ny fane. Det er således også muligt at have 2 forskellige ordinationers detaljer vist, blot på hver sin fane. Fra FMK version 1.2 kan et medicinkort ugyldiggøres. Det er udelukkende Lægemiddelstyrelsen, der kan ugyldiggøre / gyldiggøre et kort. Ugyldiggørelsen sker på baggrund af en henvendelse fra en kliniker eller borger, om at et kort ser forkert ud. Kortet markeres ugyldigt, indtil fejlen på kortet er rettet op. Herefter skal Lægemiddelstyrelsen atter gøre kortet gyldigt. Side 8
Visning af ordinationsdetaljer Side 9
2.2 Søg ordinationer Søg ordinationer aktiveres fra menupunktet Søg. Ordinationer kan fremsøges vha. CPR-nummer, ydernummer, SKS-kode eller en specifik læge, i form af dennes autorisationsnummer. Når søgekriterierne er angivet, vises antal resultater i højre side i resultatboxen. Mængden af rækker kan begrænses yderligere vha. kriterierne i blokken Yderligere filtrering, som vist i skærmbilledet herunder. De enkelte søge kriterier kan anvendes både sammen og enkeltvis. Når resultatboxen viser det ønskede antal rækker, hentes disse frem ved at aktivere <Søg>, hvorefter listen af ordinationer vises. Side 10
Når ordinationslisten vises, er det muligt at få yderligere information om den enkelte ordination. Detaljerne fås ved at klikke med musen på den ønskede række. Resultatet vises i en ny fane med basis oplysninger om den tilhørende patient og hvilken læge, der sidst har ændret data. For en ordination vises status for ordinationen, lægemidlet, doseringen og eventuelle effektueringer af lægemidlet. Man kan endvidere få vist receptordinationer og versioner, som er tilknyttet den viste ordination. Der kan findes mere information om effektueringerne ved at vælge dem med musen. For en fremsøgt effektuering vises et link til den tilhørende ordination, lægemidlet, dato for effektueringen samt type. Side 11
2.3 Søg effektueringer Søg effektueringer vælges i menuen under Søg. Fremsøgningen sker i dette billede Som beskrevet i afsnit 2.2 sker den umiddelbare søgning ved at indtaste det ønskede CPR-nummer for patienten eller ved at fremfinde en bestemt organisation vha. ydrenummer eller SKS-kode eller lægens autorisationsnummer. Ønsker man søgeresultatet reduceret, sker det i blokken Yderligere filtrering ved at angive et dato-interval. Når en specifik effektuering fra den viste liste vælges, ses følgende detaljer for effektueringen. Som det fremgår af de markerede links, er det muligt at komme til hhv. den tilhørende lægemiddel-ordination eller medicinkort. Side 12
3 Log 3.1 Søg auditlog For at tilgodese den lovgivning, som FMK er underlagt bliver alle opslag logget i databasen. Loggen indeholder bla. informationerne bruger, tid, den kaldte service, processeringstid og patientens CPR. På den måde er det altid synligt, hvem der har set data om en given patient. Fra den Administrative GUI kan der laves opslag i denne log (max 200 linier ad gangen). Det er muligt at fremsøge log linierne ud fra en række filtre - disse er: - patient CPR - bruger CPR - brugers autorisationsnummer - anvendt service metode - fra tidspunkt og til tidspunkt Filtrene kan anvendes hver for sig eller i en vilkårlig kombination.. I tidsfelterne genkendes flere formater. Tidspunktet middag i går kan eks. skrives ved -1 12:00 eller DD-MM-YYYY 12:00, hvor gårsdagens dato angives som DD-MM-YYYY. Som tidligere beskrevet, kan man til- og fravælge kolonner, der ønskes vist. For hver forespørgsel mod FMK logges hhv. request og respons. Ved at udpege en specifik forespørgsel kan man med andre ord se det request, det kaldende system har sendt. Ligeledes kan man se det response, som FMK har sendt. Visning af request / respons forudsætter at de 2 kolonner er tilvalgt under blokken Kolonner. Bemærk at request respons-tabellen løbende saneres, så den til enhver tid indeholder de seneste 2 ugers aktivitet. Side 13
4 Adgang 4.1 Brugere Administrative brugere hos hhv. LMS og Trifork Brugeradgangen styres vha. Nemlogin kombineret med en liste af CVR-numre og CPR-numre på godkendte medarbejdere, oprettet som brugere Nye brugere oprettes ved at indtaste CPR-nummer og derefter trykke på knappen <Tilføj>. Herefter dukker nummeret op i listen af brugere. Brugere kan slettes, ved at brugeren udpeges efterfulgt af et enkelt klik. Herefter vælges Slet. Side 14
4.2 Lægens medhjælp FMK giver adgang for lægens medhjælp (via soap). For at give denne brugertype adgang skal brugeren være tilknyttet en autoriseret læge. Denne tilknytning administreres via Adm. GUI en, hvor det er muligt at se, oprette og slette disse relationer. Lægen kan imidlertid også selv administrere sine medhjælpere ved at logge på www.medicin-it.dk hvor det er muligt at oprette og slette medhjælpere samt se log over medhjælperes adgang. Lægen skal logge sig ind med sin digitale signatur før han kan redigere medhjælpere / se log. Side 15
4.3 Roller og rettigheder FMK 1.2.4 indeholder en ny rettighedsmodel, som åbner FMK for en række nye roller. En rolle har et sæt tilknyttede rettigheder. Disse rettigheder anvendes til at styre hvem der har adgang til FMK via webservices og i FMK-online anvendes rolle-rettighedsmodellen til at vise / skjule knapper på brugergrænsefladen. Fx er <Opret lægemiddelordination> ikke synlig hvis man logger på FMK-online som sygeplejerske. FMK 1.2.4 tilbyder adgang for nedenstående roller. Dog er sundhedsplejerske-rollen udgået, da de ikke har en autorisation, der adskiller dem fra sygeplejersker. Side 16
Når en rolle er valgt, kan rettighederne for rollen justeres ved at sætte / fjerne flueben i billedet, gengivet herunder. Fx læge sygeplejerske Side 17
4.4 Systemer FMK 1.2.4 har introduceret en system autorisation, med hvilken man whitelister systemer, der ønsker adgang til FMK 1.2.4 og kommende versioner. Tidligere versioner kræver ikke whitelistning. For at blive autoriseret, skal systemet gennemgå en certificering. Certificeringen vil typisk indeholde en test, der sikrer korrekt databehandling ifbm. anvendte services. Klientsystemets versionsnummer kan tastes ind. Serviceaftageren er selv ansvarlig for at overholde certificeringskravene til enhver tid og søge om ny certificering, når nye dele af FMK tages i brug. Der henvises her til LMS certificeringsbreve, der omtaler dette. Side 18
5 Test Menupunktet Test findes kun i testmiljøer. Der gives ikke adgang til at sende XML eller administrere testdata, når man opererer i produktionsmiljøet. 5.1 Send XML Det er muligt at sende et XML-request mod systemet og få et XML-svar retur. Side 19
5.2 Testdata Den enkelte serviceaftager har fået tildelt en række testcertifikater og en række testpatienter. Når <Slet>knappen aktiveres, slettes kun data for de testpatienter, som den enkelte leverandør råder over. Med <Indlæs testdata> funktionen bliver testdata indlæst på ny. Side 20
6 Luk alle faner Menupunktet lukker alle åbne faner, men bevarer Adm.GUI en åbnet. Side 21
7 Log ud Menupunktet logger den aktuelle bruger ud af systemet. Side 22