Teknisk anslutning Pascal med uthoppslösning

Teknisk anslutning Pascal med uthoppslösning

För att integrera Uthopp från ert journalsystem till Pascal ska ni använda den uppdaterade instruktionen "Uthopp till patient i Pascal med POST och krypterat personnummer".

Nedan mall är ersatt, och integrationen behöver anpassas enligt nya riktlinjer.

Publicerad 2026-06-30

 

Tidigare

Här beskrivs tekniskt anrop till Pascal för att åstadkomma s.k. uthopp från annan applikation (typiskt journalsystem/läkemedelsmodul) till Pascals webbapplikation.

Systemlösning uthopp till Pascal

Översikt systemlösning

Nedan bild visar översiktligt s.k. uthopp från en applikation (X) till Pascal webbapplikation. Uthopp innebär en mycket lös integration mellan applikationerna.


Uthopp görs genom att anropa en specifik URL (https-protokoll) mot Pascal webbapplikation. Uthoppet kan t ex triggas genom att användaren väljer en knapp i Applikation X användargränssnitt.
Det går att ta med sig aktuell patients personnummer i uthoppsanropet. Om detta görs låses Pascal-sessionen till denna patient och det går inte att byta patient inom Pascal-applikationen. Byte av patient kan göras genom att anropa Pascal med nytt patientval från Applikation X.
Om ingen patient anges kommer användaren till sida i Pascal där patient måste väljas.

Säkerhetslösning för åtkomst till Pascal

Samma tekniska säkerhetslösning används vid uthopp mot Pascal som när användare loggar in i Pascal direkt. Det innebär att Pascal kommer att avkräva en giltig SAML-biljett utställd från en Autentiseringstjänst (IdP), endera den Pascal använder sig av eller en SP, service provider. I de fall Pascals Autentiseringstjänst (IdP) används ställs SAML-biljetten ut och skickas till Pascal efter att användaren har loggat in i Autentiseringstjänsten med s.k. stark autentisering.
Applikationen (X) som gör uthoppet behöver dock inte hantera detta; autentisering och utväxling av SAML-biljett hanteras i samverkan mellan webbläsare, Pascal och Autentiseringstjänst.
Se vidare Checklista Pascal för de omkringliggande krav som finns för säkerhetslösningen, t ex att användaren behöver finnas i Nationell Katalog HSA med vissa attribut.

Tekniskt anrop

Olika sätt att anropa/uthoppa

Patientval via uthopp

För uthopp till Pascal med personnummer krävs det att man först genererar en URL med krypterat personnummer. För teknisk implementation läs mer här.

Uthopp till olåst Pascal

För uthopp till Pascal utan personnummer (olåst) finns det ett antal olika sätt: med

[URL]/start

eller

[URL]/start/ bevakaderecept/0, [URL]/start/bevakaderecept/1, [URL]/start/bevakaderecept/2 resp (olåst Pascal)

eller

 

[URL]/start/bevakadehandelser (olåst Pascal)

eller

[URL]/start/bestallningar (olåst Pascal)

Exempel 1:

https://utbsiths.eordinationpascal.se/start

Innebär att man "låser upp" Pascal sessions-låsning till viss patient. Resultatet är att låsningen låses upp och Pascals startsida visas (efter eventuella autentiseringsdialoger).

Exempel 2:
https://utbsiths.eordinationpascal.se/start/bevakaderecept/0 Innebär uthoppsadressering till Pascals bevakningslista (för användaren) och vyn utgående recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan för utgående recept eller information om att inga bevakningar finns.

Bild 2: Utgående recept

 

Exempel 3:
https://utbsiths.eordinationpascal.se/start/bevakaderecept/1 Innebär uthoppsadressering till Pascals bevakningslista (för användaren) och vyn utgångna recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan för utgångna recept eller information om att inga bevakningar finns.

Bild 3: Utgångna recept

 

Exempel 4:
https://utbsiths.eordinationpascal.se/start/bevakaderecept/2 Innebär uthoppsadressering till Pascals bevakningslista (för användaren) och vyn slutexpedierade recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan för slutexpedierade recept eller information om att inga bevakningar finns.

Bild 4: Slutexpedierade recept

 

Exempel 5:
https://utbsiths.eordinationpascal.se/start/bevakadehandelser Innebär uthoppsadressering till Pascals bevakningslista (för användaren) och vyn bevakade händelser. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan för bevakade händelser eller information om att inga bevakningar finns.

Bild 5: Bevakade händelser

 

Exempel 6:
https://utbsiths.eordinationpascal.se/start/bestallningar Innebär uthoppsadressering till Pascals beställningar (lagda av användaren "Mina beställningar"). Efter eventuella autentiseringsdialoger får användaren upp vyn Beställningar och fliken Mina beställningar är aktiverad.

 

Bild 6: Mina beställningar

URL till Pascal

[URL] motsvarar https-länk till den Pascal-miljö som ska användas, t ex motsvarande testmiljö eller produktion.
För produktions-URLer, se dokumentet Checklista Pascal.
För test av tekniken kan användas testsite för Pascal med kortinloggning https://utbsiths.eordinationpascal.se

(Innehåller aktuell release motsvarande som i produktionsmiljön. Testmiljön hålls tillgänglig under kontorstid)
https://demosiths.eordinationpascal.se (Innehåller nästkommande release. Testmiljön existerar endast i anslutning till en kommande release.)

 

Kakhantering

Vid uthopp hanterar Pascal tre kakor:

  • pascal.currentPatient.[HSA-ID]

    • Sätter vilken patient du just nu arbetar med i Pascal.

  • pascal.currentPatient.version.[HSA-ID]

    • Sätter vilken version av patientens förskrivningslista du har laddat.

  • pascal.lockedPatient.[HSA-ID]

    • Lagrar vilken patient Pascal är låst till.

    • Sätts endast vid uthopp med personnummer.

    • Uppdateras vid uthopp till ny patient.

    • Rensas automatiskt när Pascal öppnas i olåst läge.

Syfte

Kakorna används för att upptäcka om Pascal är öppnat i flera flikar och om informationen skiljer sig mellan flikarna (patient, låsning eller version). Om något avviker måste Pascal ladda om för att undvika fel.

pascal.lockedPatient.[HSA-ID] gör det möjligt för Pascal att veta att användaren ska vara kvar i låst läge, även om flera flikar öppnas.


Användning av extern webbläsare

Det är viktigt att uthopp till Pascal öppnas i en extern webbläsare, separat från vårdinformationssystemet, för att systemet ska fungera som förväntat.
Uthoppslösningen är inte avsedd att vara en integrerad eller inbäddad lösning.

Sammanfattning

URL

Beskrivning

https://utbsiths.eordinationpascal.se/start

Låser upp en eventuell tidigare låst Pascal-session kopplad till viss patient och visar Pascals startsida
Rekommenderas att inte använda för uthoppande system

https://utbsiths.eordinationpascal.se/start/bevakaderecept/0

Uthoppsadressering till Pascals bevakningslista (för användaren) och vyn utgående recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan vyn för utgående recept eller information om att inga utgående recept finns i bevakningslistan. Ingen låsning till viss patient.

https://utbsiths.eordinationpascal.se/start

Uthoppsadressering till Pascals bevakningslista (för användaren) och vyn utgångna recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan vyn för utgående recept eller information om att inga utgångna recept finns i bevakningslistan. Ingen låsning till viss patient.

https://utbsiths.eordinationpascal.se/start/bevakaderecept/2

Uthoppsadressering till Pascals bevakningslista (för användaren) och vyn slutexpedierade recept. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan vyn för slutexpedierade recept eller information om att inga slutexpedierade recept finns i bevakningslistan. Ingen låsning till viss patient.

https://utbsiths.eordinationpascal.se/start/bevakadehandelser

Uthoppsadressering till Pascals bevakningslista (för användaren) och vyn bevakade händelser. Efter eventuella autentiseringsdialoger får användaren upp bevakningslistan med vyn för bevakade händelser eller information om att inga bevakningar finns bevakningslistan. Ingen låsning till viss patient.

https://utbsiths.eordinationpascal.se/start/bestallningar /bestallningar

Uthoppsadressering till Pascals beställningar (lagda av användaren "Mina beställningar"). Efter eventuella autentiseringsdialoger får användaren upp vyn Beställningar och fliken Mina beställningar är aktiverad. Ingen låsning till viss patient.

 

Implementationstekniska rekommendationer

Oadresserat uthopp (uthopp utan personnummer) innebär ett problem att som journalsystem visa rätt läkemedelslista som aktualiseras i och med att Pascal har möjlighet att visa bevakningslistan. Problematiken är inte ny utan har funnits sedan tidigare i och med att man kan hoppa ut till Pascals startsida. Ett exempel:
1 Start av exempel med uthopp till bevakningslista-funktionen
2 Journalssystemanvändare vill titta i "sin" bevakningslista hos Pascal (endera inloggad eller inte)
3 Journalssystemanvändare väljer att hoppa till "olåst Pascal", dvs utan personnummer i anropet och någon av bevakningsfunktionerna (utgående recept, utgångna recept eller bevakade händelser) (om inte användaren är inloggad blir användaren vidarebefordrad till inloggning först, se Översikt systemlösning)
4 I detta exempel så visas det 5 patienter i bevakningslistan (P1-P5) för att lättare åskådliggöra
5 Användaren tar som exempel utifrån det han ser i bevakningslistan beslut om att ändra i 2 av dessa patienters läkemedelslista, patient 1 och patient 2, P1 och P2
6 Användaren väljer P1 i bevakningslistan och kommer in på P1s läkemedelslista och gör de ändringar som användaren önskar
7 Användaren stänger P1 i Pascal (inte i journalen) och kommer tillbaka till bevakningslistan
8 Användaren väljer nu P2 i bevakningslistan och kommer in på P2s läkemedelslista och gör de ändringar som användaren önskar
9 Användaren stänger P2 i Pascal och kommer tillbaka till bevakningslistan
10 Användaren stänger Pascal, alternativt loggar ut ur Pascal (webbfönstret) och därefter stänger Pascalfönstret och återvänder till sitt journalsystem Exemplet ovan belyser problemet med att om ett journalsystem (och dess användare) går in i Pascal/gör ett uthopp till bevakningslistan och gör ändringar så kommer inte journalsystemet kunna återge korrekt status på patienten och dess förskrivningar i sitt journalsystem eftersom man inte vet vad användaren har gjort och på vilka patienter.
För att det ska bli rätt i journalsystemet bör alla uthoppsintegrerade journalsystemen ändra princip och alltid hämta aktuella och icke-aktuella ordinationer samt hämta vårdtagarstatus för den dospatient som ska öppnas dvs innan öppning/presentation av uthoppsknapp.
Som det är nu så uppdaterar journalsystem (de vi känner till) med uthopp, dospatientens status och ordinationer efter att användaren är klar i Pascal. I och med den ändrade rekommendationen för alla direktadresserade (med personnummer) uthopp till Pascal kommer journalsystemen kunna visa rätt dospatientstatus varje gång patienten öppnas i journalsystemet vilket är mer patientsäkert.
Se bild 2; Uthoppsadressering till dospatients läkemedelslista med inaktiverat kryss för att stänga patient

Rekommendation

  1. Hämta alltid aktuella och icke-aktuella ordinationer samt vårdtagarstatus för den dospatient som ska öppnas i journalsystemet innan öppning/presentation av uthoppsknapp med direktadresserat uthopp (med personnummer). Genom detta så säkerställer journalsystemet att den har senaste status för dospatienten och kan ta rätt beslut om förändringar. Om man har en synkning av patientens läkemedelslista vid stängning av direktadresserat uthopp (med personnummer) så kan man ha kvar den (för att t ex logga vad användaren gjort i sitt eget journalsystem).

  2. Tillåt inte uthopp till olåst Pascal om möjligt.