Revisionshistorik | ||||
Version | Datum | Författare | Kommentar |
|
1.0 | 2019-08-30 | Jiri Uosukainen | Första version |
|
1. Inledning
1.1 Syfte
Dokumentet syftar till att beskriva hur anslutning sker till tjänsten Elektronisk remiss och hur en anslutning till den Nationella tjänsteplattformen (NTjP) skall beställas.
1.2 Målgrupp
Målgrupper för dokumentet är personal hos anslutande parter som ansvarar för beställning av anslutning till tjänsterna för Elektronisk remiss på den Nationella tjänsteplattformen. Läsare förutsätts ha viss kännedom om tjänsterna för Elektronisk remiss och det anslutande systemet i synnerhet.
2. Tjänster för Elektronisk remiss
Tjänsterna för elektronisk remiss definieras av tjänstekontrakt inom tjänstedomänen clinicalprocess:activity:request.
Tjänstedomänen innehåller följande tre tjänstekontrakt:
ProcessRequest (PR)
Används för utbyte av remissProcessRequestConfirmation (PRC)
Används för remissbekräftelse, kompletteringsbegäran och besked om vidareskickad remissProcessRequestOutcome (PRC)
Används för utbyte av remissvar
3. Anslutande system och tjänster
Med anslutande system avses ett system för hantering av remisser som skall anslutas till tjänsterna för Elektronisk remiss framöver kallat Tjänsterna. Typiskt är detta ett journalsystem. Figur 1 visar schematiskt ett anslutande system och de tjänstekontrakt som kan anslutas för hantering av elektroniska remisser samt de vårdenheter som använder systemet för att skicka eller ta emot remisser.
Figur 1 Anslutande system
Ett anslutande system tillåts ansluta i olika systemroller; remittentsystem, remissmottagande system eller i båda rollerna. Beroende på i vilken roll det anslutande systemet agerar behöver systemet anslutas till tjänsterna i olika roller; tjänstekonsument (konsument) eller tjänsteproducent (producent). Figur 1 visar på vilket sätt ett remittentsystem resp. remissmottagande system skall anslutas till tjänsterna.
4. Beställning av anslutningar
Anslutning beskrivs här ur NTjP:s perspektiv. Beskrivningen utgår ifrån en komplett anslutning vilket innebär en anslutning till samtliga tre tjänster inom Elektronisk remiss både som konsument och producent av tjänsterna.
Informationen i beställningen gentemot NTjP är beroende av om kommunikationen sker direkt mot NTjP eller via en regional tjänsteplattform eller annan integrationsplattform som används av anslutande part.
Figur 2 Anslutningstopologi
Anslutning beställs genom Beställningsstödet. Beställningsstödet är en webapplikation som kräver inloggning och nås på adressen https://bestallningsstod.tjansteplattform.se
En beskrivning om hur beställningsstödet skall användas för beställning av anslutning till Elektronisk finns också tillgänglig. Se [REF-PPT]
4.1 Direkt anslutning
Direkt anslutning avses i fall då det anslutande systemet kommunicerar direkt med tjänsterna på NTjP. Vid en direkt anslutning agerar det anslutande systemet konsument resp. producent gentemot den Nationella tjänsteplattformen.
Figur 3 Direkt anslutning mot NTjP
4.1.1 Beställningar för anslutning av tjänstekonsument
Informationen i beställningarna framgår av Tabell 1. Värden är hämtade ur Figur 3.
Tjänstekontrakt | Systemidentitet | Anropsbehörighet |
ProcessRequest (PR) | HSA-X | SE (öppen) |
ProcessRequestConfirmation (PRC) | HSA-X | SE (öppen) |
ProcessRequestOutcome (PRO) | HSA-X | SE (öppen) |
Tabell 1 Beställningsinformation tjänstekonsument – Direkt anslutning
Förklaring till värden i tabellen:
Tjänstekontrakt
Anger det tjänstekontrakt som beställningen avserSystemidentitet
Anger identitet på anslutande system (eller funktion). Detta är ett HSA-ID som hämtas från funktionscertifikat för det anslutande systemet (eller funktionen).Anropsbehörighet
Anropsbehörigheten skall anges till ”SE”. Detta medför att det anslutande systemet ges behörighet att kommunicera meddelanden till samtliga andra anslutna system.
4.1.2 Beställningar för anslutning av tjänsteproducent
Informationen i beställningarna framgår av Tabell 2. Värden är hämtade ur Figur 3.
Tjänstekontrakt | Systemidentitet | Logiska adresser | URL |
ProcessRequest (PR) | HSA-X | HSA-ORG-1 HSA-ORG-2 HSA-ORG-3 | URL-PR |
ProcessRequestConfirmation (PRC) | HSA-X | Som PR | URL-PRC |
ProcessRequestOutcome (PRO) | HSA-X | Som PR | URL-PRO |
Tabell 2 Beställningsinformation tjänsteproducent – Direkt anslutning
Förklaring till värden i tabellen:
Tjänstekontrakt
Anger det tjänstekontrakt som beställningen avser.Systemidentitet
Anger identitet på det anslutande systemet (eller funktion). Detta är ett HSA-ID som hämtas från funktionscertifikat för det anslutande systemet (eller funktionen).Logiska adresser
Anger de logiska adresser i form av HSA-ID för vårdenheter som kan adresseras i det anslutande systemet.
Detta är en lista på de vårdenheter som tar emot meddelanden i det anslutande systemet. Dessa behöver uppdateras vid förändringar. Typiskt vid införande av Elektronisk remiss på ytterligare vårdenheterURL
Anger URL till respektive tjänst i det anslutande systemet.
4.2 Anslutning via integrationsplattform
Här avses anslutning då anslutande system kommunicera med NTjP via en regional tjänsteplattform eller annan integrationsplattform. Detta visas i Figur 4.
Figur 4 Anslutning via integrationsplattform
4.2.1 Beställningar för anslutning av tjänstekonsument
I detta fall är det den regionala integrationsplattformen som agerar konsument gentemot NTjP. Informationen i beställningarna framgår av Tabell 3. Värden är hämtade ur Figur 4.
Tjänstekontrakt | Systemidentitet | Anropsbehörighet |
ProcessRequest (PR) | HSA-RTP-X | SE (öppen) |
ProcessRequestConfirmation (PRC) | HSA-RTP-X | SE (öppen) |
ProcessRequestOutcome (PRO) | HSA-RTP-X | SE (öppen) |
Tabell 3 Beställningsinformation tjänstekonsument – Anslutning via integrationsplattform
Förklaring till värden i tabellen:
Tjänstekontrakt
Anger det tjänstekontrakt som beställningen avserSystemidentitet
Anger identitet på integrationsplattform. Detta är ett HSA-ID som hämtas från funktionscertifikat.Anropsbehörighet
Anropsbehörigheten skall anges till ”SE”. Detta medför att det anslutande systemet ges behörighet att kommunicera meddelanden till samtliga andra anslutna system.
4.2.2 Beställningar för anslutning av tjänsteproducent
Informationen i beställningarna framgår av Tabell 4. Värden är hämtade ur Figur 4
Tjänstekontrakt | Systemidentitet | Logiska adresser | URL |
ProcessRequest (PR) | HSA-RTP-X | HSA-ORG-1 HSA-ORG-2 HSA-ORG-3 | URL-PR-RTP |
ProcessRequestConfirmation (PRC) | HSA-RTP-X | Som PR | URL-PRC-RTP |
ProcessRequestOutcome (PRO) | HSA-RTP-X | Som PR | URL-PRO-RTP |
Tabell 4 Beställningsinformation tjänsteproducent – Anslutning via integrationsplattform
Förklaring till värden i tabellen:
Tjänstekontrakt
Anger det tjänstekontrakt som beställningen avser.Systemidentitet
Anger identitet på integrationsplattform. Detta är ett HSA-ID som hämtas från funktionscertifikat.Logiska adresser
Anger de logiska adresser i form av HSA-ID för vårdenheter som kan adresseras via tjänsterna integrationsplattformen.
Detta är en lista på de vårdenheter som tar emot meddelanden i det anslutande systemet. Dessa behöver uppdateras vid förändringar. Typiskt vid införande av Elektronisk remiss på ytterligare vårdenheterURL
Anger URL till respektive tjänst på integrationsplattformen.
4.3 Information om NTjP
Aktuell systeminformation om NTjP och information om de installerade tjänsterna för Elektronisk remiss på den Nationella tjänsteplattformen finns tillgänglig via [REF-WIKI-NTjP].
Se https://skl-tp.atlassian.net/wiki/spaces/NTJP/pages/6815748/FAQ+Teknik
Här finns information om URL:er för tjänsterna inom Elektronisk remiss på NTjP och annan viktig information som är nödvändig för att etablera kommunikation med NTjP.