Virtuell tjänst

...

Info
VP är för tjänsteanrop kontraktsagnostik, dvs. det spelar ingen roll vilken subpath till anlutningspunkten som används för ett specifikt tjänstekontrakt.

VP erbjuder en anslutningspunkt/virtuell tjänst för alla tjänstekontrakt som standardiserats genom RIVmetoden.
I praktiken finns det ofta många tjänsteproducenter (regionala, landstings-specifika eller gemensamma för ett antal vårdgivare)
för ett standardiserat tjänstekontrakt. Virtuella tjänster döljer detta förhållande för tjänstekonsumenter.

Driftsätta virtualiseringar i Virtualiseringsplattformen

Nya tjänster/tjänstekontrakt kan läggas till användas utan förändringar i VP:s kod under förutsättning att den som skapar tjänsten följer den av Inera publicerade standarden för wsdl:er.
Det enda som krävs då är att kontraktet är TAK:at. Men för att VP skall kunna publicera Wsdl:en för ett specifikt kontrakt behöver dessa ligga i en katalog under vp.
Detta förenklar för parter som vill ansluta till tjänsten. Per default ska kontrakten ligga i mappen wsdl under config i installationen.
Det går att använda en annan mapp genom att konfigurera värdet wsdlfiles.directory i application-custom.properties.

För RTJP eller annan installation som funderar på att byta från Mule till nya VP

Befintliga kontrakt bör fungera som vanligt, men som nämnts behöver WSDL:erna för respektive kontrakt finnas tillgängliga.
Skulle det visa sig att det inte går att komma WSDL:n för något ett befintligt kontrakt trots att det ligger i avsedd katalog beror detta på att
namnrymden för WSDL:n inte följer mönstret som VP förväntar sig och/eller att anrops adressen dom VP härleder från denna inte blir den förväntade.
Det finns då en möjlighet att konfigurera en Json-fil (wsdl.json.file i application-custom.properties för kontrakt med avvikande struktur. Den är till för att äldre tjänstekontrakt ska fungera.

...

Ett annat fel som kan uppså är att VP returnerar WSDL:n men att det inte går att hämta en tillhörande XSD.
Detta beror förmodligen på att schema filen inte finns och eller att sökvägen (som skall vara relativ i förhållande till WSDL:n) är fel., det enda som krävs är att det finns vägval och behörigheter för detta tjänstekontrakt uppsatt i plattformens TjänsteAdresseringsKatalog(TAK).
Anslutningspunkten kan anropas med valfri subpath. Exempelvis om anslutningpunkten är https://esb.njtp.se/vp kan man anropa valfri subpath oavsett vilket kontrakt man använder:

• https://esb.njtp.se/vp/mittjanstekontrakt/1

• https://esb.njtp.se/vp /vad/som/2

• osv.

WSDL tjänst

VP erbjuder en tjänst för att hämta WSDL:er för tjänstekontrakt med hjälp av parametern ?wsdl.

Vid dessa anrops bestämmer subpathen vilken wsdl som visas. Exempel:

• https://esb.ntjp.se/vp/clinicalprocess/healthcond/certificate/CreateDraftCertificate/2/rivtabp21?wsdl

• https://esb.ntjp.se/vp/infrastructure/eservicesupply/forminteraction/CancelForm/2/rivtabp21?wsdl

En lista på tillgängliga WSDL url:er kan fås genom anrop till https://hostname/vp?wsdl

WSDL Installation

För att att lägga upp en ny WSDL och koppla den till en subpath/url finns två möjligheter:

1. Kopiera in WSDL med automatisk koppling till URL.

2. Kopiera in WSDL med manuell konfigurering av URL.

Kopiera in WSDL med automatisk koppling till URL

Om WSDLen följer RIV TAs regel #4 för target namespace räcker det att man kopierar WSDL strukturen till den mapp som är utpekad i VPs konfigureringsfil property wsdlfiles.directory, se SKLTP VP - Konfiguration .

VP läser in target namespace i WSDLen och kopplar den till URL enligt http://hostname/vp/{tjänsteDomän}/{tjänsteInteraktion}/m/{profilKortnamn}.

Exempel:

application.properties innehåller wsdlfiles.directory=/opt/vp/wsdl/.

Wsdl struktur för GetActivities kopieras in under /opt/vp/wsdl/:

...

VP läser in target namespace från GetActivitiesIneraction_1.0_RIVTABP21.wsdl och kopplar den till URL http://hostname/vp/clinicalprocess/activity/actions/GetActivities/1/rivtabp21?wsdl

Kopiera in WSDL med manuell konfigurering av URL.

Om man önskar annan URL kopplad till wsdl:en än den som skapas automatiskt kan man konfigurera detta i en json fil som pekas ut av propertien wsdl.json.file, se SKLTP VP - Konfiguration.

Detta kan vara användbart ifall target namespace i wsdl filen inte följer RIV TAs regel #4 för target namespace.

Exempel:

...

GetActivities wsdl:en kan nu hämtas via pathen http://hostname/vp/another/GetActivities/url?wsdl