Licensansökan - Webbapplikation för systemleverantörerBilaga till handboken för apoteksaktörer
1. Inledning
1.1 Syfte och avgränsningar
Dokumentet är en instruktion för leverantörer av expedieringssystem som ska använda KLAS-webbapplikation i sina system. Dokumentet förutsätter en grundläggande förståelse av STP-plattformen.
1.2 Begrepp
Begrepp |
Förklaring |
STP |
E-hälsomyndigheten tjänsteplattform. |
Användare |
Den farmaceut som använder KLAS-webbapplikation. |
LIC |
Licensansökan. |
1.3 Referenser
Dokument |
Beskrivning |
Funktionsspecifikation-GT (gällande version) |
Beskriver de tjänster som ingår i STP-komponenten GT |
2. Användning i expeditionssystem
2.1 Övergripande
KLAS-webbapplikation är en webbapplikation som är tillgänglig via en webbläsare. För att öppna KLAS-webbapplikationen måste man länka från expedieringssystemet till en webbläsare som öppnar KLAS-webbapplikationen. För att slippa en manuell inloggning av användaren i KLAS-webbapplikation ska expedieringssystemet anropa en tjänst i STP som returnerar ett sessions-id som expedieringssystemet sedan använder när det öppnar KLAS-webbapplikationen. KLAS-webbapplikation validerar sessions-id, och om det är korrekt loggas användaren in i KLAS-webbapplikationen.
Anropande system ska säkerställa att endast farmaceuter ges åtkomst till KLAS.
2.2 Steg för steg
- Expedieringsssystemet anropar tjänsten GT.SkapaSessionIdService för att få ett sessions-id som används för inloggning i KLAS-webbapplikation (svarsparametern sessionId). Sessions-id är aktuellt i endast tio sekunder, så inloggning i KLAS-webbapplikationen måste ske inom den tidsperioden.
- Expedieringssystemet startar webbläsaren med en URL som adresserar KLAS-webbapplikationen samt det sessions-id som returnerades från tjänsten GT. SkapaSessionIdService. URL:en som används är fördefinierad. Sessions-id läggs till sist i URL:en.
- KLAS-webbapplikationen loggar in farmaceuten och visar en initial söksida för licensärenden.
- Farmaceuten är inloggad i KLAS-webbapplikationen och kan nu arbeta vidare där. Farmaceutens legitimationskod visas i övre högra hörnet.
2.3 Tjänster
Här presenteras ett urval av de berörda tjänsternas parametrar. För en komplett beskrivning av tjänsternas parametrar hänvisas till respektive funktionsspecifikation.
2.3.1 GT.SkapaSessionIdService
Returnerar ett sessions-id som ska anges i URL-en när KLAS-webbapplikationen ska öppnas i webbläsaren.
SkapaSessionId - request
klientinformation |
Klientinformation |
|
Information om klienten som anropar tjänsten. |
attributLista |
Attribut[] |
|
Attribut att spara. |
Attribut- request
För att komma in i KLAS webbklient behöver man i SkapaSessionsId skicka med nyckel-värde-par i attributlistan, se nedan.
Legitimationskod
Nyckel |
String |
1..64 |
Ange "legitimationskod" som nyckel. |
Varde |
String |
1..256 |
Farmaceutens legitimationskod. |
Förnamn
Nyckel |
String |
1..64 |
Ange "fornamn" som nyckel. |
Varde |
String |
1..256 |
Farmaceutens förnamn. |
Efternamn
Nyckel |
String |
1..64 |
Ange "efternamn" som nyckel. |
Varde |
String |
1..256 |
Farmaceutens efternamn. |
Klientinformation - request
System |
String |
13..13 |
GLN-kod för anropande system. |
Anvandare |
String |
1..20 |
Unikt användarid i anropande system. |
Session |
String |
1..62 |
Sessionens id i anropande system. |
SkapaSessionId - reply
sessionId |
String |
32..32 |
Temporärt sessions-id som används för inloggning i KLAS-webbapplikationen. Detta id läggs sist i den URL som anger KLAS-webbapplikationens adress. |
2.4 URL
Adressen till KLAS-webbapplikation ser ut enligt nedan (icke fungerande exempel). Den faktiska adressen beror på vilken miljö hos E-hälsomyndigheten som expeditionssystemet kommunicerar med.
https://10.100.100.100/licensansokan/ansokan
För att bli inloggad måste sessions-id anges efter URL:en enligt följande:
https://10.100.100.100/licensansokan/ansokan?sid=ff80808128b537850128ca66d1c123b6
Sessions-id måste döljas i webbläsarens adressfält.
2.5 Systemkrav
2.5.1 Webbläsare
KLAS stödjer följande webbläsare och vi strävar efter att löpande testa och verifiera senare versioner av dem.
- Google Chrome
- Mozilla Firefox
- Microsoft Internet Explorer
- Microsoft Edge
2.5.2 Operativsystem
Inget speciellt krav.
Versionshistorik
1.0 |
2014-02-17 |
Version 1.0 fastställd |
2.0 |
2014-05-07 |
Referens uppdaterad. |
3.0 |
2014-10-01 |
1.2, Förtydligat användare.
1.3, Uppdaterat referens.
2.2, Förtydligat farmaceut.
2.4, Gulmarkering av sekretess.
2.5, Förtydligande av systemkrav. |
| 4.0 |
2017-11-10 |
Ändrat LIC-webbapplikation till KLAS-webbapplikation i bilagan
1.2 Lagt till KLAS med förklaring i tabell
2.4 Ändrat från http: till korrekta https: |
| 7.0 |
2020-01-10 |
2.4 Tagit bort gulmarkerade avsnitt |
