Versions Compared

Version Old Version 2 New Version Current
Changes made by

Former user

Stockholms Läns Landsting

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Hval24Adapter är en adaptertjänst som används av tjänstedomänen Nationell Listning för att stödja de XML-format som finns definierade för tjänstedomänen. Adaptern sköter kommunikation med en tjänst som svarar med teckensträngar. Adaptern i anpassningsplattformen tar inkommande anrop från tjänsteplattformen och transformerar anropet till en textsträng innan det skickas vidare till bakomliggande tjänst. Svaret går sedan från anropad tjänst tillbaka till adaptern i anpassningsplattformen där det transformeras till XML innan det skickas tillbaka till tjänsteplattformen.

Release notes

2.0.3

Release datum: 2015-03-16

Ladda ner zip för deploy i Mule.

Jira Legacy
serverJIRA (skl-tp.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId750a6180-d7a0-3a07-9e26-06918e482381
keySERVICE-158

2.0.2

Release datum: 2014-09-01

Ladda ner zip för deploy i Mule.

Jira Legacy
serverJIRA (skl-tp.atlassian.net)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId750a6180-d7a0-3a07-9e26-06918e482381
keySERVICE-34

  • Notera att logfilen har ett uppdaterat filnamn, det betyder tex om man har ett script el.dyl som förväntar sig ett visst filnamn behöver detta uppdateras.

 

2.0.1

Release datum: 2014-08-29

Ladda ner zip för deploy i Mule.

  • Jira Legacy
    serverJIRA (skl-tp.atlassian.net)
    columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
    serverId750a6180-d7a0-3a07-9e26-06918e482381
    keyMIG-45
  • Jira Legacy
    serverJIRA (skl-tp.atlassian.net)
    columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
    serverId750a6180-d7a0-3a07-9e26-06918e482381
    keySERVICE-27
  • Jira Legacy
    serverJIRA (skl-tp.atlassian.net)
    columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
    serverId750a6180-d7a0-3a07-9e26-06918e482381
    keyMIG-141

    • Loggning av monitorering i separat logfil, konfigureras i log4j.xml

      Code Block
      <!-- Monitoring logs to separate log file, additivity makes sure not logged twice -->
	<logger name="se.skltp.adapterservices.monitoring" additivity="false">
		<level value="INFO" />
		<appender-ref ref="ROLLINGFILE_MONITORING"/>
	</logger>

Förändrad konfiguration

Nya properties för att konfigurera PingForConfiguration, defaultvärden nedan.

Code Block
# PingForConfiguration properties
PINGFORCONFIGURATION_INBOUND_ENDPOINT=http://localhost:11001/anp/itintegration/monitoring/PingForConfiguration/1/rivtabp21
APPLICATION_NAME=Hval24Adapter

Uppdaterade properties

Code Block
Från:
# Hval adapter endpoint properties
inbound.endpoint.hval24.getlisting=http://localhost:11001/tb/carelisting/hval24/GetListing/1/rivtabp20
outbound.endpoint.hval24.getlisting=${inbound.https.endpoint.hval24.getlisting.teststub}
# Teststub properties
inbound.https.endpoint.hval24.getlisting.teststub=https://localhost:12443/tb/hval24/testproducer/GetListing/1/rivtabp20
inbound.http.endpoint.hval24.getlisting.teststub=http://localhost:12080/tb/hval24/testproducer/GetListing/1/rivtabp20
 
Till:
# Hval adapter endpoint properties
inbound.endpoint.hval24.getlisting=http://localhost:11001/anp/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
outbound.endpoint.hval24.getlisting=${inbound.https.endpoint.hval24.getlisting.teststub}

# Teststub properties
inbound.https.endpoint.hval24.getlisting.teststub=https://localhost:14001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
inbound.http.endpoint.hval24.getlisting.teststub=http://localhost:15001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20

 

2.0.0 

  • MIG-10 - NTjP migrering Basefarm, Hval AnP till Mule3
  • SKLTP-440 - AnP: HVAL adapter beroende av http header receiverId från VP

RC3 finns att ladda ner från Maven.

Installationsanvisning

Innehåller releasen konfigurationsuppdateringar så ska dessa utföras innan själva tjänsten installeras.

Vid uppdatering av befintliga tjänster:

  1. Spara undan filer för att kunna rulla tillbaka vid problem
  2. Gör uppgraderingen/installationen
  3. Vid ...
    1. lyckad uppgradering, ta bort back-up filer
    2. misslyckad uppgradering, återställ med hjälp av back-up filer

Konfigurera

Säkerställ att generella konfigurationer av adaptertjänsten finns i filen <MULE_HOME>/conf/Hval24Adapter-config-override.properties enligt instruktion. 

Konfigurera tjänstespecifika parametrar

Ta hjälp av NTjP Support för information om korrekta parametervärden för säkerhetsinställningar samt inbound och outbound endpoints.

Code Block
languagetext
titleHval24Adapter-config-override.properties
 
TB_HTTPS_CLIENT_TIMEOUT=30000
HVAL24_DISPATCH_MAX_THREADS_ACTIVE=50
HVAL24_DISPATCH_MAX_THREADS_IDLE=25
HVAL24_DISPATCH_MAX_THREADS_TTL=10000
HVAL24_RECEIVE_MAX_THREADS_ACTIVE=50
HVAL24_RECEIVE_MAX_THREADS_IDLE=25
HVAL24_RECEIVE_MAX_THREADS_TTL=10000
 
# Security settings
HVAL24_TLS_STORE_LOCATION=path/to/certs
HVAL24_TLS_REQ_CLIENTAUTH=true
HVAL24_TLS_STORE_TRUSTSTORE_TYPE=jks
HVAL24_TLS_STORE_TRUSTSTORE_FILE=truststore.jks
HVAL24_TLS_STORE_TRUSTSTORE_PASSWORD=password
HVAL24_TLS_STORE_PRODUCER_TYPE=jks
HVAL24_TLS_STORE_PRODUCER_FILE=producer-localhost.jks
HVAL24_TLS_STORE_PRODUCER_PASSWORD=password
HVAL24_TLS_STORE_PRODUCER_KEY_PASSWORD=password
 
# Standard properties for an external ActiveMQ broker, see soitoolkit-mule-jms-connector-activemq-external.xml.
SOITOOLKIT_MULE_AMQ_BROKER_URL=failover:(tcp://localhost:61616)
SOITOOLKIT_MULE_AMQ_MAX_REDELIVERIES=3
SOITOOLKIT_MULE_AMQ_REDELIVERY_DELAY=10000
SOITOOLKIT_MULE_AMQ_NO_OF_CONSUMERS=2
 
# Default queue names for info end error log-events
SOITOOLKIT_LOG_INFO_QUEUE=SOITOOLKIT.LOG.INFO
SOITOOLKIT_LOG_ERROR_QUEUE=SOITOOLKIT.LOG.ERROR
 
# Default timeout for synchronous services
SERVICE_TIMEOUT_MS=8000
TB_HTTPS_CLIENT_TIMEOUT=30000
 
# All endpoints
inbound.endpoint.hval24.getlisting=http://localhost:11001/anp/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
outbound.endpoint.hval24.getlisting=https://host:port/endpointservice/path
 
# PingForConfiguration properties
PINGFORCONFIGURATION_INBOUND_ENDPOINT=http://localhost:11001/anp/itintegration/monitoring/PingForConfiguration/1/rivtabp21
 

Konfigurera vid test

Teststubbar/SoapUI tester konfigureras genom att lägga till följande konfiguration i samma fil som ovan, <MULE_HOME>/conf/Hval24Adapter-config-override.properties, och peka om outbound endpoints ovan enligt

outbound.endpoint.hval24.getlisting=${inbound.https.endpoint.hval24.getlisting.teststub}

Code Block
languagetext
titleHval24Adapter-config-override.properties
###############################
#        Use for test        #
##############################

inbound.https.endpoint.hval24.getlisting.teststub=https://localhost:14001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
inbound.http.endpoint.hval24.getlisting.teststub=http://localhost:15001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
 

Installera

Installera tjänsten

Installera adaptertjänsten genom att följa den generella installationsinstruktionen för tjänster i Mule.

Installera teststubbar

Installera teststubbar för adaptertjänsten genom att följa den generella installationsinstruktionen för tjänster i Mule.

Teststubbar finns att ladda ner från http://repo1.maven.org/maven2/se/skltp/adapterservices/crm/carelisting/Hval24AdapterIC-teststub/

Viktigt att säkerställa att teststubbar inte kolliderar med redan befintliga tjänster. För att uppdatera den default port som är satt för Hval24Adapterns teststubbar uppdatera följande property i Hval24Adapter-config-override.properties

Code Block
inbound.https.endpoint.hval24.getlisting.teststub=https://localhost:14001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20
inbound.http.endpoint.hval24.getlisting.teststub=http://localhost:15001/anp/teststub/hval24adapter/crm/carelisting/GetListing/1/rivtabp20

 

Verifiera

Verifiera att tjänsten går att nå

Utför konfiguration och installation för test, se ovan, och använd medföljande SoapUI projekt för att verifiera tjänsten.

SoapUI projektet finns paketerat i releasepaketet här. Efter import av projektet i SoapUI så behöver SSL konfigureras med korrekta key stores etc. Använd fördefinierat request anrop i SoapUI för att anropa tjänsten. Anropet transformeras och ett response visas i SoapUI där teststubben simulerar backendHVAL24Adapter förvaltas av Hälso och Sjukvårdsförvaltningen inom SLL. Objektägare IT är Sofie Österman.