Virtuell tjänst

En virtuell tjänst erbjuder en anslutningspunkt per 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

1. Lägg till jar-fil med virtualisering i <MULE_HOME>/apps/vp-services-[version]/lib katalogen
2. 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
3. Säkerställ driftsättningen av den virtuella tjänsten genom att: 

   1. titta i loggen <MULE_HOME>/logs/mule-app-vp.log.  Omladdningen har gått bra när man ser informationen nedan i loggen:

      Kodblock
      **********************************************************************

...

1. 1. * Application: vp-services-2.2.

...

1. 1. 4 * * OS encoding: UTF-8, Mule encoding: UTF-

...

* Agents Running:                                                 *

*   JMX Agent                                                        *

*   Clustering Agent                                               *

1. 1. 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
  • Lyckas upphämtningen av wsdl-en kommer ett SoapUI projekt skapas med ett request till tjänsten.

Verktyg för att generera virtuella tjänster

Verktyg för att hjälpa till i arbetet med att skapa körbara virtuella tjänster.

Script för att generera körbara virtuella tjänster för VP 1.3.x och VP 2.0.  

Förutsättningar

Java är installerat och JAVA_HOME är satt i miljön.

Kräver groovy 1.8 eller nyare, se här för installationsinstruktioner.

Kräver Maven 3.0 eller nyare.

Rätt version av Maven behövs för att kunna köra scriptet.

You need to install Maven service archetype of correct version in order to run the script

1. cd /skltpservices/tools/generators/archetypes/tags/1.1/ServiceArchetype
2. mvn install

Scriptet baseras på RIV TA Konfigurationsstyrning 1.0

Skapa tjänstevirtualiseringar

1. Ladda ner RIV TA zip med servicekontrakt och zippa upp det, RIV TA

2. Checka ut filerna som behövs för att köra.

   Man behöver bara checka ut tool-katalogen: svn checkout http://skltpservices.googlecode.com/svn/tools/generators/scripts/trunk/se/skltpservices/tools 

3. Uppdatera artifactId och version i pomtemplate.xml beroende på vilken domän/subdomän som används och vilken version tjänstekontraktet har, se exempel nedan

...

<groupId>se.skl.skltpservices</groupId>

<artifactId>itintegration-engagementindex</artifactId>

<version>1-RC4</version>

    4.  Uppdatera version i /VirtualiseringGenerator.groovy så att det matchar versionen på tjänstekontraktet

    5.  Kör script med schemas som input

   6. Mappar för varje interaktion har nu skapats. Varje mapp innehåller en definition av en virtuell tjänst

   7. Kör maven install för att skapa körbara jar-filer

Problem med att köra script

Script hänger på mvn archetype:generate

Kör mvn archetype:generate kommandot manuellt för att ladda ner olika beroenden som behövs av scriptet. Prova att köra scriptet igen när beroendena finns nedladdade. 

Använda 1.1

...

• • .

...

• Endast Mule3 flow för virtualisering, mule2 service borttagen
• Lägger till en http och https ändpunkt
• Lägger till möjligheten att styra via keep-alive via feature
• Ändpunkternas adress innehåller nu även domän och subdomän

...

mvn archetype:generate

-DinteractiveMode=false

-DarchetypeArtifactId=service-archetype

-DarchetypeGroupId=se.skl.tp.archetype

-DarchetypeVersion=1.2

-Duser.dir=.

-DgroupId=se.skl.skltpservices.crm.scheduling

-DartifactId=GetSubjectOfCareSchedule

-Dversion=1.1

-DVirtualiseringArtifactId=crm-scheduling-GetSubjectOfCareSchedule-virtualisering

-DhttpsEndpointAdress=https://${TP_HOST}:{TP_PORT}/${TP_BASE_URI}/crm/scheduling/GetSubjectOfCareSchedule/1/rivtabp21

-DhttpEndpointAdress=http://${TP_HOST}:${TP_PORT_HTTP}/${TP_BASE_URI}/crm/scheduling/GetSubjectOfCareSchedule/1/rivtabp21

-DflowName=crm-scheduling-GetSubjectOfCareScheduleInteraction-virtualisering-flow

-DfeatureKeepalive=${feature.keepalive.urn.riv.crm.scheduling.GetSubjectOfCareScheduleResponder.1:${feature.keepalive}}

-DserviceMethod=GetSubjectOfCareSchedule

-DserviceWsdlFileDir=classpath:/schemas/interactions/GetSubjectOfCareScheduleInteraction/GetSubjectOfCareScheduleInteraction_1.1_RIVTABP21.wsdl

...