SKLTP VP - Virtuell tjänst och WSDL

Owned by Hans Bragman (Unlicensed)
Last updated: dec. 23, 2019 by Göran Erkstam (Unlicensed)
2 min read

Virtuell tjänst

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. Nya tjänster/tjänstekontrakt kan användas utan förändringar i VP:s kod, 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:

WSDL tjänst

Tjänsten för att hämta/visa WSDLer är inte kontraktsagnostik utan bestäms utifrån den subpath till anslutningspunkten som används.

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