Beskrivning
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.
2.0.2
Release datum: 2014-09-01
Ladda ner zip för deploy i Mule.
- 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.
- Error rendering macro 'jira' : null
- Error rendering macro 'jira' : null
- Error rendering macro 'jira' : null
Loggning av monitorering i separat logfil, konfigureras i log4j.xml
<!-- 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.
# PingForConfiguration properties PINGFORCONFIGURATION_INBOUND_ENDPOINT=http://localhost:11001/anp/itintegration/monitoring/PingForConfiguration/1/rivtabp21 APPLICATION_NAME=Hval24Adapter
Uppdaterade properties
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:
- Spara undan filer för att kunna rulla tillbaka vid problem
- Gör uppgraderingen/installationen
- Vid ...
- lyckad uppgradering, ta bort back-up filer
- 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.
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}
############################### # 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
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 backend.