 | RIV Tekniska Anvisningar TjänsteplattformVersion 1.8. |
1 ARK_0034 |
2022- |
02- |
23 |
| Innehållsförteckning |
|---|
Versionshistorik | |||
Version | Revision Datum | Författare | Kommentar |
PA1 | Mattias Nordvall | Första utkast | |
PA2 | Mattias Nordvall | Uppdaterat efter intern remiss | |
PA3 | Lars Erik Röjerås | Justeringar efter genomläsning | |
1.0 | Mattias Nordvall | Dokumentets underrubrik är nu ”Tekniska krav” istället för ”Regler för interoperabilitet”. Lagt till kapitel med definition av termer. Tagit bort texter om reverse proxy (betraktas som implementationsdetalj). Lagt till felkoder för virtualiseringsplattform. Tagit bort regel om loggning av förändringar av TAK-information (inte ett tekniskt krav). Tagit bort skrivning om godkännande av tjänstekontrakt i 3.1.1 (inte ett tekniskt krav). Ändrat regel om uppbyggnad av URL:er till att enbart beskriva slutet på adresserna (det enda som är reglerat i RIV TA). Förtydligat att anropsbehörighet i TAK avser närmast anropande tjänstekonsument. Kapitlet om TAK använde begreppet ”logisk adress” om två olika saker. Lagt till översiktligt kapitel om Tjänsteväxel. Korrigerat ordval och stavfel. Uppdaterade illustrationer. | |
1.0.1 | Mattias Nordvall | Korrigerat vissa formuleringar och illustrationer. Nytt stycke om förhållandet mellan nationella och regionala tjänsteplattformar. | |
1.1 | Mattias Nordvall | Kapitlet om anpassningsplattform och tjänsteväxel omskrivet och felaktigheter korrigerade. Regel ”Exponering av URL:er” i kapitel 4 korrigerad för att överensstämma med underliggande regelverk. Exempel från den senaste versionen av RIV-TA Basic Profile, t.ex. SOAP Headers, är ändrade till mer generella begrepp | |
1.2 | Mattias Nordvall | Lagt till regler i kapitel 4 från RIV TA Basic Profile 2.0. Dessa regler behöver följas av tjänsteplattformar. Lagt till Regel #6 under kapitlet Aggregeringsplattform. | |
1.3 | Mattias Nordvall | Uppdaterat Regel #6 under kapitlet Aggregeringsplattform. | |
1.4 | 2017-12-07 | Björn Hedman | Lagt till information om adressering baserat på TAK och organisationsdata "HSA klättring" Under rubrik 4.2.6 har görs hänvisning till Basic Profile istället för att beskriva och exemplifiera i detta dokument Rättat numrering av regler under kapitel 5.1 (Virtualiseringsplattform) felet uppstod mellan version 1.0 och 1.1 (några regler utgick i 1.1) Tagit bort hänvisning till fallstudie för "Regional tjänsteplattform, Landstinget Dalarna" eftersom länken var bruten. |
1.5 | 2018-08-27 | Lars Erik Röjerås | Reglerna 2 och 4 har utökats med beskrivning av HSA-baserat vägval och anropsbehörighet samt användning av "*". |
1.6 | 2021-03-12 | Anders Malmros | Tagit bort Mule-referens i 1.4 Fallstudier. Uppdateringar och tillägg under kapitel 5 Virtualiseringsplattform:
|
Regel #12, Skydd mot rundgång, tillagd.
| |||
1.7 | 2021-06-28 | Anders Malmros | Rättat fel i regel #12. Felkod VP014 skall användas vid rundgång, inte VP013 |
1.8 | 2022-01-25 | Anders Malmros | Lagt till ny felkod VP015 i regel #8, Felkoder |
1.8.1 | 2022-02-23 | Anders Malmros | Rättat felaktiga referenser till RIVTA Basic Profile Valfria tillägg 2.1 i kapitel 4.2.3 och 4.2.4 |
1. Inledning
Hälso- och sjukvårdssektorn i Sverige har på uppdrag av Sveriges Kommuner och Landsting och under ledning av CeHis, nuvarande Inera, gemensamt tagit fram en nationell teknisk arkitektur i syfte att stödja samarbete över organisationsgränserna.
...
Det finns en referensimplementation SKL TP (http://skltp.se/).
1.5 Referenser
Ref | Dokument | Beskrivning |
[R1] | T-boken | Referensarkitektur för vård och omsorg |
[R2] | RIV Tekniska Anvisningar – Översikt | |
[R3] | RIV Tekniska Anvisningar – Basic Profile | RIV-TA:s tillägg till WS-I Basic Profile |
[R4] | RIV Tekniska Anvisningar – Basic Profile – Valfria Tillägg 2.1 | |
[R5] | RIV Tekniska Anvisningar – Tjänsteschema | Beskrivning av schema-filer för tjänstekontrakt. |
[R6] | Tjänstekontrakts-beskrivning Engagemangsindex | Beskrivning av tjänstekontrakt i domänen itintegration:engegementindex. |
[R7] | WS-I Basic Profile 1.1 | En specifikation på protokollanvändning i syfte att kunna implementera interoperabla webbtjänster. |
[R8] | Tjänstekontrakts-beskrivning Tjänsteadressering | Beskrivning av tjänstekontrakt i domänen infrastructure:itintegration:registry. http://rivta.se/domains/infrastructure_itintegration_registry.html |
[R9] | Användarhandledning adressering med HSA information | Beskrivning av hur organisationsdata (från HSA) kan användas för logisk adressering |
2. Terminologi
Följande termer förekommer i dokumentet.
Term | Definition |
Tjänstekonsument | En tjänstekonsument är en tjänstekomponent (informationssystem) där agerandet leder till ett automatiskt informationsutbyte med andra tjänstekomponenter (exempelvis tjänsteproducenter). En tjänstekonsument kan t ex vara en eTjänst, ett verksamhetssystem, en partneringång eller en tjänsteplattform. Tjänstekonsumenten agerar som initiativtagare i ett informationsutbyte. |
Tjänsteproducent | En tjänsteproducent är en tjänstekomponent som har ett tekniskt gränssnitt som möjliggör för tjänstekonsumenter att genom meddelanden förändra eller begära information. |
Tjänstekomponent | Avgränsad mängd programvara som kan utvecklas, integreras, testas, driftsättas och förvaltas fristående. |
Tjänstekontrakt | Specifikation som beskriver ett nationellt standardiserat gränssnitt som förekommer mellan tjänstekomponenter i en tjänsteorienterad arkitektur. |
Tjänstedomän | En enligt VIFO-kartan övergripande, verksamhetsbaserad indelningsgrund för nationellt standardiserade tjänsteinteraktioner. |
Tjänsteinteraktion | Informationsutbyte mellan tjänstekomponenter baserat på tjänstekontrakt. |
3. Allmänt
3.1 Regelverk
Följande regelverk ställer krav på tjänsteplattformar:
...
Källa: RIVTA Basic Profile 2.1 Valfria tillägg [R4R3] Regel #2#23
Detta regleras inte i RIVTA Basic Profile 2.0.
...
Källa: RIVTA Basic Profile 2.1 Valfria tillägg [R4R3] Regel #4#23
Detta regleras inte i RIVTA Basic Profile 2.0.
...
Virtualiseringsplattformen skall returnera felmeddelanden enligt respektive RIV TA-profil som HTTP 500 med SOAP Fault, med felkoder och felsträng enligt tabellen nedan. SOAP Fault-elementet detail används för att inkludera ytterligare felinformation så som spårningsinformation eller ytterligare detaljer kring det inträffade felet.
Fault code * | Fault string * |
|---|---|
soap:Client | VP001 [namn tjänsteplattform] Rivta-version saknas i anrop eller stöds ej av tjänsteplattformen. |
soap:Client | VP002 [namn tjänsteplattform] Fel i klientcertifikat. Saknas, är av felaktig typ, eller är felaktigt utformad. |
soap:Client | VP003 [namn tjänsteplattform] Logisk adressat (ReceiverId) saknas i RivHeadern i inkommande meddelande. |
soap:Client | VP004 [namn tjänsteplattform] Det finns inget vägval i tjänsteadresseringskatalogen som matchar anropets logiska adressat (ReceiverId) och tjänstekontrakt. Kontrollera uppgifterna i anropet och vid behov, beställ konfigurering i aktuell tjänsteplattform. |
soap:Client | VP005 [namn tjänsteplattform] Tjänsteproducenten stödjer inte anropets angivna rivta-version. Kontrollera uppgifterna. |
soap:Server | VP006 [namn tjänsteplattform] Internt fel i tjänsteplattformen. Det finns fler än en tjänsteproducent definierad i tjänsteadresseringskatalogen som matchar logisk adressat (ReceiverId), tjänstekontrakt och dagens datum. Tyder på felkonfiguration. Rapportera felet till tjänsteplattformsförvaltningen. |
soap:Client | VP007 [namn tjänsteplattform] Tjänstekonsumenten saknar behörighet att anropa den logiska adressaten via detta tjänstekontrakt. Kontrollera uppgifterna och vid behov, tillse att det beställs konfiguration i aktuell tjänsteplattform. |
soap:Server | VP008 [namn tjänsteplattform] Internt fel i tjänsteplattformen. Ingen kontakt med tjänsteadresseringskatalogen. Informera tjänsteplattformsförvaltningen. |
soap:Server | VP009 [namn tjänsteplattform] Fel vid kontakt med tjänsteproducenten. |
soap:Server | VP010 [namn tjänsteplattform] Internt fel i tjänsteplattformen. URL saknas för tjänsteproducenten i tjänsteplattformens tjänsteadresseringskatalog. |
soap:Client | VP011 [namn tjänsteplattform] Anrop har gjorts utanför TLS vilket ej är tillåtet. Tjänstekonsumenten ska alltid använda TLS för säker kommunikation. |
soap:Server | VP012 [namn tjänsteplattform] Internt fel i tjänsteplattformen. Nödvändiga resurser saknas för att VP skall fungera. |
soap:Client | VP013 [namn tjänsteplattform] Enligt tjänsteplattformens konfiguration saknar tjänstekonsumenten rätt att använda headern x-rivta-original-serviceconsumer-hsaid. Kontakta tjänsteplattformsförvaltningen. |
soap:Server | VP014 [namn tjänsteplattform] Anropsförmedlingen för den logiska adressaten har givit upphov till rundgång mellan tjänsteplattformar. Rapportera felet till tjänsteplattformsförvaltningen. |
soap:Client | VP015 [namn tjänsteplattform] Anrop ej korrekt utformat och kan därför inte behandlas. |
* Terminologi från SOAP 1.1
...
En tjänsteplattform skall analysera headern ”x-rivta-routing-history” för alla inkommande meddelanden.
Om dess egen identitet finns registrerad så innebär det att samma meddelande når plattformen en andra gång, och rundgång har identifierats.
Vid rundgång skall meddelandet inte skickas vidare. Istället ska felmeddelandet VP013 VP014 returneras.
Regel #13: Vidarebefordran av RIV-headrar
...
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].
7. Aggregeringsplattform
Aggregeringsplattformen har till uppgift att ge en tjänstekonsument ett svar som sammanställts genom att kontakta flera tjänsteproducenter, baserat på information i Engagemangsindex (se kap 8). Detta är en frivillig komponent i en tjänsteplattform.
...
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.
...
Följande illustration och tabell visar skillnader och likheter mellan tjänsteväxel och anpassningstjänster.
| Tjänsteväxel | Anpassningstjänst |
Kan översätta meddelandeinnehåll | Vanligtvis inte | Ja |
Kan översätta adressering | Ja | Ja |
Kan översätta protokoll | Ja | Ja |
Kan översätta säkerhets-mekanismer | Ja | Ja |
Knuten till specifika tjänstedomäner | Nej | Ja |
Knuten till specifika IT-system | Nej | Ja |
Placeras vanligtvis | Nationellt | Regionalt |
Kommunikation | Med system utanför hälso- och sjukvårdsområdet | Med system inom hälso- och sjukvårdsområdet |
Exempel | RIV-SHS-växel | Anpassning av SLL:s hälsovalstjänst till tjänstekontraktet GetListings. |