...
Virtualiseringsplattformen har tillkommit för att uppfylla T-bokens arkitekturella princip om lös koppling mellan tjänstekonsumenter och -producenter.
5.1 Regler
Regel #1: Datakommunikation
Virtualiseringsplattformen skall följa alla kommunikationsregler i aktuella RIV TA-profiler.
Regel #2: Åtkomstkontroll
Virtualiseringsplattformen skall ha möjlighet att vid inkommande anrop kontrollera åtkomstbehörigheten för kombinationen av följande:
...
Åtkomstbesluten skall baseras på information som lagras i tjänsteadresseringskatalogen. Om åtkomst inte tillåts skall den inkommande förfrågan inte vidarebefordras. Istället skall ett felmeddelande returneras, enligt aktuell RIV TA-profil.
Källa: [R2] Kapitel 8.5
Regel #4: Vägval för anrop
För att kunna vidarebefordra inkommande meddelanden till rätt tjänsteproducent, behöver virtualiseringsplattformen kunna slå upp den tekniska adress som meddelandet ska vidarebefordras till. Denna information tas fram ur den information som är registrerad i tjänsteadresseringskatalogen utifrån följande kriterier:
- meddelandets logiska mottagaradress
- anropat tjänstekontrakt, inkl. tjänstedomän och kontraktets huvudversion
- anropad RIVTA-profilversion
Regel #5: Vidarebefordran av anrop
Virtualiseringsplattformen skall, såvida autentisering, åtkomstkontroll, vägval och övrig validering lyckats, skicka tjänstekonsumentens meddelande vidare till tjänsteproducenten. Svarsmeddelandet från tjänsteproducenten, oavsett om det är ett ordinarie svar eller ett felmeddelande, skall därefter returneras till tjänstekonsumenten.
Regel #6: Översättning mellan RIV-TA versioner
Virtualiseringsplattformen skall kunna översätta inkommande anrop från en version av RIV-TA till en annan. Skillnader mellan RIV TA-versioner kan t.ex. gälla utformning av SOAP-meddelanden eller säkerhetsmekanismer och kan utläsas i dokumentationen för respektive version.
Regel #8: Felkoder
Virtualiseringsplattformen skall returnera felmeddelanden enligt respektive RIV TA-profil, med följande felkoder och i följande felsituationer:
...
Den primära konsumenten av informationen i tjänsteadresseringskatalogen är Virtualiseringsplattformen (VP). Kommunikationen mellan VP och TAK regleras inte av några nationella tjänstekontrakt.
6.1 Regler
Regel #1: Lagring av vägvalsinformation
Tjänsteadresseringskatalogen skall lagra vägvalsinformation. Denna information består av följande delar:
- Tjänstekontrakt inklusive tjänstedomän, i formatet URN, plus kontraktets major-version. Exempel: urn:riv:clinicalprocess:activityprescription:prescribe:ChangePrescription:1
- Logisk adress till en organisationsenhet eller ett IT-system
- Version av RIV-TA i kortformat, t.ex. ”rivtabp21”
- Associerad teknisk adress, i form av en http URL.
Regel #2: Exponering av vägvalsinformation
Tjänsteadresseringskatalogen skall exponera sin registrerade vägvalsinformation till virtualiseringsplattformen över valfritt gränssnitt.
Regel #3: Lagring av anropsbehörigheter
Tjänsteadresseringskatalogen skall kunna lagra anropsbehörigheter. Dessa anropsbehörigheter består av följande delar:
- Tjänstekontrakt inklusive tjänstedomän, i formatet URN, plus kontraktets major-version. Exempel: urn:riv:clinicalprocess:activityprescription:prescribe:ChangePrescription:1
- logisk adress
- tjänstekonsumentens identitet
Regel #4: Exponering av anropsbehörigheter
Tjänsteadresseringskatalogen skall exponera sina registrerade anropsbehörigheter till virtualiseringsplattformen över valfritt gränssnitt.
Regel #5: Tjänstekontrakt
Tjänsteadresseringskatalogen skall implementera den nationella tjänstedomänen infrastructure:itintegration:registry. Kontrakten i denna domän används av vissa avancerade tjänstekonsumenter och -producenter och kan komma att utökas med ytterligare funktionalitet. Se [R8].
...
Enligt mönstret i T-boken använder sig aggregeringsplattformen av tjänsten engagemangsindex för att få information om vilka tjänsteproducenter som innehåller information som behövs i aggregeringen. Detta leder till att aggregeringsplattformen även behöver en lokal instans av tjänsten engagemangsindex.
8.2 Regler
Regel #1: Datakommunikation
Aggregeringsplattformen skall följa alla kommunikationsregler i RIV TA.
Regel #2: Generera tjänst med utgångspunkt från WSDL-filer
Godkända tjänstekontrakt levereras i formaten WSDL och XSD, enligt RIV-TA Basic Profile. Utifrån dessa artefakter skall en aggregerande tjänst kunna skapas och installeras i aggregeringsplattformen.
Källa: [R3] Regel #18
Regel #3: Utgående anrop till tjänsteproducenter
Aggregeringsplattformen skall vidarebefordra den inkommande förfrågan till de tjänsteproducenter som enligt tjänsten engagemangsindex innehåller information för att kunna sammanställa ett komplett svar.
I de utgående frågemeddelandena ändras den logiska mottagaradressen till respektive tjänsteproducents logiska adress. Den ursprungliga tjänstekonsumentens identitet vidarebefordras med hjälp av http header x-rivta-original-serviceconsumer-hsaid, se kapitel 4.
Regel #4: Sammanställning av information
Aggregeringsplattformen skall sammanställa de svar som tas emot från enskilda tjänsteproducenter och skapa ett aggregerat svar. Detta svar skall sedan returneras till den ursprungliga tjänstekonsumenten.
Eventuella felmeddelanden från tjänsteproducenter skall inte infogas i det sammanställda svaret.
Regel #5: ProcessingStatus i svar till konsument
En aggregerande tjänst skall infoga en header, enligt aktuell RIV TA-profil, i sitt svar till en tjänstekonsument. Headern har namnet ProcessingStatus och innehåller en lista över de tjänsteproducenter som bidragit till svaret, samt uppgift om huruvida respektive delsvar kommer direkt från källsystemets primärdatabas eller från en cache.
...
För mer information, se [R4]: Basic Profile med status för anrop till aggregerande tjänster 2.1: Regel #2.
Regel #6: Filtrering av ej åtkomliga och ej kompatibla källsystem
Engagemangsindex tillhandahåller information om vilka källsystem som innehåller information av ett specifikt slag om en specifik person. Information från alla dessa källsystem är dock ibland inte möjliga att aggregera av följande skäl:
...
Om en tjänsteplattform har en aggregeringsplattform skall även tjänsten engagemangsindex implementeras. Här beskrivs de regler som tjänsten behöver uppfylla.
8.1 Regler
Regel #1: Datakommunikation
Engagemangsindex skall stödja alla kommunikationsregler i de RIV TA-profiler som tjänstedomänen itintegration:engagementindex tillämpar.
Regel #2: Tjänstedomän
Tjänsten ska implementera tjänstedomänen itintegration:engagementindex. Det innefattar bland annat:
...