Innehållsförteckning |
---|
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, landstingsspecifika 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
Tjänsten ska vara i form av en well-formed wsdl-fil. Den ska läggas i den katalog som antingenLägg till jar-fil med virtualisering i <MULE_HOME>/apps/vp-services-[version]/lib katalogen
Använd kommandot touch <MULE_HOME>/apps/vp-services-[version]/vp-config.xml för att ladda om applikationen och starta den virtuella tjänsten
Säkerställ driftsättningen av den virtuella tjänsten genom att:
titta i loggen <MULE_HOME>/logs/mule-app-vp.log. Omladdningen har gått bra när man ser informationen nedan i loggen:
Kodblock ********************************************************************** * Application: vp-services-2.2.4 * * OS encoding: UTF-8, Mule encoding: UTF-8 * * Agents Running: * * JMX Agent * * Clustering Agent * **********************************************************************
b. Hämta upp den installerade virtuella tjänstens wsdl genom SOAPUI. Det räcker med att testa en eller två tjänster:
Gå till File=> New soapUI Project och fyll i Project Name och Initial WSDL/WADL.
...
Project Name är valfritt.
...
Initial WSDL/WADL är adress till tjänstens wsdl. Den får man fram genom att packa upp tjänstens jar-fil och titta efter adress för inbound-endpoint i filen tp2-service-mule-descriptor.xml.
ex. address="https://${TP_HOST}:${TP_PORT}/${TP_BASE_URI}/AterkallaSamtyckeVardsystem/1/rivtabp20".
...
Ersätt samtliga parametrar i adressen och lägg till ?wsdl på slutet, till exempel: https://123.456.00.00:20000/vp/AterkallaSamtyckeVardsystem/1/rivtabp20?wsdl
...
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:
https://esb.njtp.se/vp/mittjanstekontrakt/1
https://esb.njtp.se/vp /vad/som/2
osv.
WSDL tjänst
Info |
---|
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:
Kopiera in WSDL med automatisk koppling till URL.
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