Innehållsförteckning

1. Inledning

1.1        Syfte

...

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

...

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.

Image RemovedImage Added

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 i beställningsstödethär: Instruktioner och filmer.

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

...

Informationen i beställningarna framgår av Tabell 1. Värden är hämtade ur Figur 3.

Tabell 1 Beställningsinformation tjänstekonsument – Direkt anslutning

...

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser

• Systemidentitet
  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. För mer information om standardbehörighet se sidan Standardbehörighet i NTjP  

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.

Tabell 2 Beställningsinformation tjänsteproducent – Direkt anslutning

...

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) 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årdenheter

• URL
  Anger URL till respektive tjänst i det anslutande systemet.

...

Här avses anslutning då anslutande system kommunicera med NTjP via en regional tjänsteplattform eller annan integrationsplattform. Detta visas i Figur 4.

Image RemovedImage Added

Figur 4 Anslutning via integrationsplattform

...

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.

Tabell 3 Beställningsinformation tjänstekonsument – Anslutning via integrationsplattform

...

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) som beställningen avser

• Systemidentitet
  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. För mer information om standardbehörighet se sidan Standardbehörighet i NTjP  

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

Tabell 4 Beställningsinformation tjänsteproducent – Anslutning via integrationsplattform

...

• Tjänstekontrakt
  Anger det tjänstekontrakt (och version) 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årdenheter

• URL
  Anger URL till respektive tjänst på integrationsplattformen.

4.2.3        Standardvägval i regional tjänsteplattform

I regionala tjänsteplattformar rekommenderas standardvägval för adressering. Se mer information här:
Standardvägval i regionala tjänsteplattformar  

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 https://inera.atlassian.net/wiki/spaces/NTJPP/overview?homepageId=400557227

Se ävenTeknik Wiki, 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.

5. Hantering vid parallella huvudversioner

Varje tjänstekonsumerande och tjänsteproducerande system behöver ta hänsyn till att det kan finnas parallella huvudversioner av tjänstekontrakt. Hur detta fungerar finns beskrivet här:

• RIV Tekniska Anvisningar - Parallella huvudversioner av ett tjänstekontrakt

• Övergång till en ny huvudversion inom en tillämpning

...

Figur 5 Bild som visar att tjänstekonsumenter och tjänsteproducenter kan vara anslutna till olika huvudversioner av tjänstekontrakt (TKv1 och TKv2)

För kunder till tjänsten Elektronisk remiss innebär detta följande:

• Anslutande kund ska stödja även föregående huvudversion så länge det finns kunder som fortfarande enbart stödjer denna.

  • För helt nya kunder kan denna punkt diskuteras med tjänstens förvaltning, ifall alla tänkta mottagare (tjänsteproducenter) och sändare (tjänstekonsumenter) till ny kund redan har den senaste huvudversionen.

• Tjänstekonsument som är ansluten till ny huvudversion ska veta vilken huvudversion som aktuell tjänsteproducent använder. Detta så att remissen skapas och skickas enligt rätt version:

  • Tjänstekonsumenten skahålla en aktuell lista med logiska adresser för de tjänsteproducenter som är anslutna till ProcessRequest och vilka huvudversioner de stödjer.

  • Tjänstekonsument bör ansluta till tjänstekontrakt GetLogicalAddresseesByServiceContract v.2.0 (tjänstekontraktet publiceras efter sommaren 2024) som tjänstekonsument (se mer information nedan).

• Bekräftelsemeddelanden (ProcessRequestConfirmation) och remissvarsmeddelanden (ProcessRequestOutcome) ska skickas enligt samma huvudversion som mottaget remissmeddelande (ProcessRequest).

• Vid end-of-life för en huvudversion av ProcessRequest ska mottagande och sändande system kunna hantera bekräftelsemeddelanden (ProcessRequestConfirmation) och remissvar (ProcessRequestOutcome) för denna version X månader efteråt (ej bestämt exakt antal månader ännu) innan även dessa når end-of-life.

5.1 Hämta information om huvudversion

För att kunna veta vilken huvudversion en remissmottagare stödjer bör tjänstekontrakt GetLogicalAddresseesByServiceContract v.2.0 (tjänstekontraktet publiceras efter sommaren 2024)användas. Anropet innehåller tjänstekonsumentens HSA-ID och aktuellt tjänstekontrakt (ProcessRequest v.X). Ett anrop per huvudversion av tjänstekontraktet behöver göras.

Svaret består av en lista med logiska adresser (HSA-ID) för tjänsteproducenter av ProcessRequest som kunden har anropsbehörighet till. Eftersom tjänstekonsumenter av tjänstens tjänstekontrakt har standardbehörighet visas alla tjänsteproducenter av ProcessRequest v.X i listan.