Anpassa journalsystem för NPÖ konsumentanslutning (TGP)
Denna information vänder sig till systemleverantörer som ska utveckla en TGP-lösning för att vårdgivare ska kunna ansluta till NPÖ som konsument.
- 1 TGP-alternativ
- 1.1 Användning av Ineras TGP
- 1.1.1 Tester
- 1.1.2 Anslutning
- 1.2 Online-TGP
- 1.2.1 Tester
- 1.2.2 Anslutning
- 1.1 Användning av Ineras TGP
- 2 Bra information inför utvecklingen
TGP-alternativ
NPÖ har stöd för två olika typer av TGP-lösningar:
Att registrera information om vårdrelation i Ineras TGP, som finns i två instanser (TGP0 på Sjunet samt TGP1 på Internet), eller
Att använda en egen TGP-tjänst, så kallad online-TGP, som hanterar bedömning av om vårdrelation föreligger
Mer information finns på sidan Tillgänglig patient (TGP).
Användning av Ineras TGP
Vid användning av Ineras TGP (TGP0 eller TGP1) sker registrering av vårdrelation i samband med uthopp från journalsystemet till NPÖ. För detta kan programmet Condis användas, alternativt behöver motsvarande funktionalitet implementeras i journalsystemet.
För att få tillgång till Condis-programmet, kontakta Inera.
Condis-programmet har tre huvudsakliga funktioner, vilka behöver implementeras i journalsystemet om inte Condis ska användas. Dessa funktioner är:
Anrop mot Ineras TGP (TGP0 eller TGP1) för registrering av vårdrelation
Uthopp till NPÖ, eventuellt med vald patient
Kontexthantering: om en användare har gjort uthopp till NPÖ med en patient, och sedan vill växla till en annan patient, behöver föregående session stängas ner för att säkerställa att användaren inte har flera patienters information tillgänglig i NPÖ samtidigt. Då användaren byter till en annan patient behöver systemet avsluta den pågående sessionen och göra nytt uthopp till NPÖ med den nya patienten.
För att ett journalsystem ska kunna göra registreringar i Ineras TGP utan att Condis används behöver systemet först vitlistas. Detta hanteras av NPÖ-förvaltningen på Inera.
I anropet mot Ineras TGP kan uppgift om vårdgivare, alternativt vårdgivare och vårdenhet, skickas. Det är vårdgivaren som ansvarar för regelverket som gäller begränsning av patientval, det vill säga på vilken nivå (vårdgivare eller vårdenhet) som vårdrelationen ska registreras. Mer information finns i TGP funktionsbeskrivning, kapitlet “Regelverk för tillgängliga patienter”.
Kontakta Inera för att få tillgång till instruktioner för hur uthopp till NPÖ och anrop mot Ineras TGP ska konstrueras, mer information om vitlistning, samt adresser till Ineras TGP i test- och produktionsmiljö.
Tester
Test av uthopp till NPÖ kan göras i någon av Ineras testmiljöer (SIT eller QA).
För tester av anrop mot Ineras TGP rekommenderas Ineras SIT-miljö. I QA-miljön är TGP-funktionen inställd på att svara att alla testpersoner är tillgängliga för alla användare, vilket innebär att det inte är möjligt att verifiera i NPÖ att anropet mot TGP har gett korrekt resultat.
SITHS-testkort krävs för tester i SIT och/eller QA.
Se Anpassa journalsystem för NPÖ konsumentanslutning (TGP) | Tillgång till NPÖ i olika miljöer.
Anslutning
Inför en vårdgivares/vårdenhets anslutning i produktion behöver vårdgivaren ha:
Beställt krypteringsnycklar för PROD-miljön. Detta görs genom ett ärende till Inera.
Beställt tjänsten NPÖ konsument i Ineras kundportal.
Se checklista för anslutning som konsument för mer detaljerad information om vad som krävs för att ansluta till NPÖ som konsument.
OBS! Teknisk anslutning, så kallad TAKning, krävs inte för att kunna använda NPÖ med Ineras TGP. Det rekommenderas ändå att vårdgivaren beställer detta för de vårdenheter som ska använda NPÖ, då det bland annat underlättar eventuellt framtida felsökning. Beställning av teknisk anslutning görs i Beställningsstödet. Se Checklista: Beställa teknisk anslutning.
Online-TGP
För användning av online-TGP behöver systemleverantören bygga en tjänsteproducent (TGP-tjänst) som i realtid kan besvara TGP-frågorna från NPÖ. Tjänsteproducenten ska byggas i enighet med regelverken på RIV-TA. För TGP är det tjänstekontraktet AssertCareEngagement som ska implementeras.
Systemleverantören behöver även implementera ett regelverk för vad som utgör en vårdrelation. Det är vårdgivaren som ansvarar för regelverket som gäller begränsning av patientval. Mer information finns i TGP funktionsbeskrivning, kapitlet “Regelverk för tillgängliga patienter”.
Kommunikationen mellan NPÖ och tjänsteproducenten (TGP-tjänsten) går via Nationella tjänsteplattformen. För kommunikation mellan Nationella tjänsteplattformen och tjänsteproducenten krävs att man skaffar och installerar ett SITHS funktionscertifikat.
En egen TGP-tjänst kan kombineras med ett egenbyggt uthopp från journalsystemet till NPÖ där patientens personnummer kan skickas med. För att få tillgång till instruktioner för hur uthopp till NPÖ ska konstrueras, kontakta Inera.
Tester
Releasepaketet för tjänstekontraktet AssertCareEngagement innehåller en testsvit som kan användas för verifiering under utvecklingen. Denna testsvit kan köras utan koppling till någon av Ineras miljöer.
Test av uthopp till NPÖ kan göras i någon av Ineras testmiljöer (SIT eller QA).
För verifiering av TGP-funktionaliteten rekommenderas Ineras SIT-miljö. I QA-miljön är TGP-funktionen inställd på att alltid svara att alla testpersoner är tillgängliga för alla användare, vilket innebär att det inte är möjligt att verifiera i NPÖ att TGP:n ger ett korrekt svar. För att test av TGP-funktionaliteten i SIT ska vara möjlig behöver först en teknisk anslutning, så kallad TAKning, göras mot SIT-miljön hos Inera. Detta beställs via Beställningsstödet. Se Checklista: Beställa teknisk anslutning.
Vissa tester av TGP-funktionen kan göras med Testsidan, https://testsidan.npo.se/ (test nr 3), där det är möjligt att verifiera att kommunikationen mellan Nationella tjänsteplattformen och TGP-tjänsten funger och att TGP-tjänsten ger ett tekniskt korrekt svar tillbaka. För att detta ska vara möjligt behöver först en teknisk anslutning (TAKning) göras mot QA-miljön hos Inera. Detta beställs via Beställningsstödet. Se Checklista: Beställa teknisk anslutning.
SITHS-testkort krävs för tester i SIT och/eller QA.
Se Anpassa journalsystem för NPÖ konsumentanslutning (TGP) | Tillgång till NPÖ i olika miljöer.
Anslutning
Inför en vårdgivares/vårdenhets anslutning i produktion behöver:
vårdgiven ha beställt krypteringsnyckel för PROD-miljön, om uthopp ska göras till NPÖ. Krypteringsnyckel beställs genom ett ärende till Inera.
vårdgivaren ha beställt tjänsten NPÖ konsument i Ineras kundportal.
vårdgivaren, alternativt agent/systemleverantör, ha beställt teknisk anslutning för de vårdenheter som ska använda NPÖ, så att anrop från NPÖ kan skickas till rätt online-TGP. Denna beställning görs i Beställningsstödet. Se Checklista: Beställa teknisk anslutning.
Se checklista för anslutning som konsument för mer detaljerad information om vad som krävs för att ansluta till NPÖ som konsument.
Bra information inför utvecklingen
Systemroller
När en vårdgivare ska ansluta som NPÖ konsument (kunna ta del av andra vårdgivares information i NPÖ), behöver vårdgivaren ha en TGP-lösning. Vid anslutning av denna TGP-lösning fungerar tjänsten NPÖ (samt den interna stödkomponenten TGPX) som tjänstekonsument och TGP-funktionen agerar tjänsteproducent.
Tjänstekonsument
System som initierar ett specifikt informationsutbyte
Skickar begäran att hämta, ändra eller ta bort information i ett eller flera andra system
Tjänsteproducent
Uppvisar ett tekniskt gränssnitt som möjliggör för tjänstekonsumenter att genom begäran (frågemeddelanden) förändra eller begära information
Hanterar frågemeddelanden och producerar svarsmeddelanden enligt fastställt tjänstekontrakt
Mer information om begreppen tjänstekonsument/tjänsteproducent samt introduktion till principerna bakom dagens kommunikation över tjänsteplattformar: Interoperabilitet - med andra ord.
Om vårdgivaren använder Ineras TGP, kommer TGP0 eller TGP1 att agera tjänsteproducent. Om vårdgivaren ansluter en online-TGP, kommer denna online-TGP att agera tjänsteproducent.
Tillgång till NPÖ i olika miljöer
PROD: https://www.npo.se eller https://npo.sjunet.org
QA: http://qa.npo.se eller qa.npo.sjunet.org
SIT: http://sit.npo.se/ eller http://sit.npo.sjunet.org/
SITHS-testkort krävs i SIT och QA. Testkort är opersonliga och beställs från SITHS-ombud eller från Inera. Vårdmedarbetaruppdrag krävs för inloggning i NPÖ. Se detaljer på Checklista: Förberedelser/konfigurering i HSA.
Brandväggsöppningar: Checklista: Brandväggsöppningar för åtkomst till NPÖ i PROD
Stöddokumentation inför utveckling
Allmänt om tjänstekontrakt: Vad är tjänstekontrakt?