Page History

...

Svareksponeringsservice XDS-adaptere
Driftsvejledning

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

Et eksempel på indhold i sxametadataconfiguration.xml:

<metadata>

...

  <classCode class="codedValue">

...

    <code>001</code>

...

    <codeSystem>2.16.840.1.113883.3.4208.100.9</codeSystem>

...

    <description>Klinisk rapport</description>

...

  </classCode>

...

  <confidentialityCode class="codedValue">

...

    <code>N</code>

...

    <codeSystem>2.16.840.1.113883.5.25</codeSystem>

...

    <description>Normal</description>

...

  </confidentialityCode>

...

  <formatCode class="codedValue">

...

    <code>urn:ad:dk:medcom:labreports:svareksponeringsservice</code>

...

    <codeSystem>1.2.208.184.100.10</codeSystem>

...

    <description>Laboratoriesvar (samling af svar)</description>

...

  </formatCode>

...

  <languageCode>da-DK</languageCode>

...

  <mimeType>text/xml</mimeType>

...

  <practiceSettingCode class="codedValue">

...

    <code></code>

...

    <codeSystem></codeSystem>

...

    <description></description>

...

  </practiceSettingCode>

...

  <typeCode class="codedValue">

...

    <code>11502-2</code>

...

    <codeSystem>2.16.840.1.113883.6.1</codeSystem>

...

    <description>LABORATORY REPORT.TOTAL</description>

...

  </typeCode>

...

  <homeCommunityId>1.2.3.5.6</homeCommunityId>

...

  <repositoryUniqueId>1.2.3.4.55.66</repositoryUniqueId>

...

  <uniqueIdRoot>1.2.3.4.55.66</uniqueIdRoot>

...

  <healthcareFacilityTypeCode class="codedValue">

...

    <code></code>

...

    <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

    <description></description>

...

  </healthcareFacilityTypeCode>

...

  <authorInstitution
    class="dk.nsi.documentsharing.core.metadata.model.OrganisationImpl">

...

    <name>Region Test</name>

...

    <id class="valueWithAssigningAuthority">

...

      <value>291000016008</value>

...

      <assigningAuthority>1.2.208.176.1.1</assigningAuthority>

...

    </id>

...

  </authorInstitution>

...

</metadata>

Anchor
_Toc462261544 _Toc462261544

Konfiguration af filter på dokument-metadata-forespørgsel

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

I konfiguration specificeres 0, 1 eller flere kode-sæt i hhv. classCodes, typeCodes, eventCodes, confidentialityCodes, formatCodes og practiceSettingCodes?

<filter>

...

  <classCodes>
  </classCodes>

...

  <typeCodes>
  </typeCodes>

...

  <eventCodes>
  </eventCodes>

...

  <confidentialityCodes>
  </confidentialityCodes>

...

  <formatCodes>
  </formatCodes>

...

  <practiceSettingCodes>
  </practiceSettingCodes>

...

</filter>

Hver kode-sæt, består af:<codedValue>
<code>kode-værdi</code>
<codeSystem>kode-system</codeSystem>
<description>menneskelæselig beskrivelse af kode-værdi</description>

    <codedValue>
      <code>kode-værdi</code>
      <codeSystem>kode-system</codeSystem>
      <description>menneskelæselig beskrivelse af kode-værdi</description>
    </codedValue>

Filterets classCodes, typeCodes, eventCodes, confidentialityCodes, formatCodes og practiceSettingCodes modsvarer lignende navne i søge-parametre, der kan være anført ved kald af Svareksponeringsservice XDS Registry Adapter opslag. Er et kodesæt anført i søge-parametre for fx eventCodes, da bevirker filteret et tomt svar, når:

...

Tilsvarende logik er gældende de øvrige koder i filteret.
Følgende er et eksempel på konfiguration af filteret:

<filter>

...

  <classCodes/>

...

  <typeCodes>
    <codedValue>
      <code>11502-2</code>

...

      <codeSystem>2.16.840.1.113883.6.1</codeSystem>

...

      <description>LABORATORY REPORT.TOTAL</description>

...

    </codedValue>

...

  </typeCodes>

...

  <eventCodes/>

...

  <confidentialityCodes>
    <codedValue>
      <code>N</code>

...

      <codeSystem>2.16.840.1.113883.5.25</codeSystem>

...

      <description>Normal</description>

...

    </codedValue>

...

  </confidentialityCodes>

...

  <formatCodes>
    <codedValue>
      <code>urn:ad:dk:medcom:labreports:svareksponeringsservice</code>

...

      <codeSystem>1.2.208.184.100.10</codeSystem>

...

      <description>Laboratoriesvar (samling af svar)</description>

...

    </codedValue>

...

  </formatCodes>

...

  <practiceSettingCodes>
     <codedValue>
      <code>408454008</code>
      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk mikrobiologi</description>

...

    </codedValue>

...

    <codedValue>
      <code>394596001</code>

...

      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk biokemi</description>

...

    </codedValue>

...

    <codedValue>
      <code>394915009</code>

...

      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>patologi anatomi og cytologi</description>

...

    </codedValue>

...

	  
  </practiceSettingCodes>

...

</filter>

Anchor
_Toc462261545 _Toc462261545

Konfiguration af mapning til specialer

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

I konfiguration specificeres specialer således:

<filter>

...

  <practiceSettingCodes>
    <mappedCodedValue>
      <code>408454008</code>

...

      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk mikrobiologi</description>
      <mappedValue>Mikrobiologi</mappedValue>
    </mappedCodedValue>
    <mappedCodedValue>
      <code>394596001</code>
      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk biokemi</description>
      <mappedValue>KliniskBiokemi</mappedValue>
    </mappedCodedValue>
    <mappedCodedValue>
      <code>394915009</code>
      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>patologisk anatomi og cytologi</description>
      <mappedValue>Patologi</mappedValue>
    </mappedCodedValue>
  </practiceSettingCodes>
</filter>

Det er vigtigt, at den tilsvarende fil for documentprovider er konfigureret fuldstændigt identisk.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

I konfigurationen er det muligt at aktivere performanceloggeren, der udvalgte steder i adapteren, vil skrive tidsvarighed af kald igennem systemet. Performanceloggeren aktiveres ved at ændre level værdien fra "OFF" til "DEBUG". Eftersom konfigurationen kun indlæses ved opstart af servicen, er det nødvendigt at genstarte servicen efter endt redigering af log4j-sxa-documentmetadataprovider-ws.xml filen.
Eksempel på konfiguration af performanceloggeren, hvor level værdien er sat til "OFF":

<logger name="performancelogger" additivity="false">

...

  <level value="OFF" />

...

  <appender-ref ref="PerformanceFile" />

...

</logger>

Som standard skriver performanceloggeren til sxa-documentmetadataprovider-ws-performance.log i WildFly' log-folder.
Se yderligere opsætning i installationsvejledningen.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/ 

Per default udpeges konfigurationsfilen beskrevet i næste afsnit.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main/

Anchor
_Toc327544080 _Toc327544080

Anchor
_Toc462261550 _Toc462261550

Konfiguration af Svareksponeringsservice XDS Repository Adapter

...

Opsætningen for kalderen af Svareksponeringsservice konfigureres i SXADocumentProvider.properties.
Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

Et eksempel på sådan konfiguration er:

sxa.labservice.request.timeout.seconds = 120

...

sxa.labservice.request.username = username

...

sxa.labservice.request.password = password

...

sxa.labservice.endpoint = 
http://localhost:9090/sxa-labreportservicestub/SvarEksponering

...

sxa.document.unique.root.id = 1.2.3.4.55.66

...

sxa.labservice.request.samtykkekode = _ 
sxa.labservice.request.samtykketekst = _ 
sxa.labservice.request.slutbruger.identifikation = _ 
sxa.labservice.request.slutbruger.organisation = _ 
sxa.labservice.request.slutbruger.cpr = _ 
sxa.labservice.request.slutbruger.fornavn = _ 
sxa.labservice.request.slutbruger.efternavn = _ 
sxa.labservice.request.slutbruger.stilling = _ 
sxa.labservice.request.slutbruger.email = _ 
sxa.labservice.request.slutbruger.rolle = _ 
sxa.labservice.request.slutbruger.autorisationskode = _

Properties beskrives ifølge tabel.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

Et eksempel på sådan konfiguration er:

<ProviderConfiguration>

...

  <homeCommunityId>1.2.3.5.6</homeCommunityId>

...

  <repositoryUniqueId>1.2.3.4.55.66</repositoryUniqueId>

...

  <uniqueIdRoot>1.2.3.4.55.66</uniqueIdRoot>

...

</ProviderConfiguration>

Bemærk, at de konkrete værdier skal være afstemt med homeCommunityId og repositoryUniqueId i de dokumentmetadata, der er konfigureret som beskrevet i afsnit 4.1.1. Er der ikke overensstemmelse, vil kald til Svareksponeringsservice XDS Repository give anledning til svar, der påpeger uoverenstemmelsen.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

I konfiguration specificeres specialer således:

<filter>

...

  <practiceSettingCodes>
    <mappedCodedValue>
      <code>408454008</code>

...

      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk mikrobiologi</description>
      <mappedValue>Mikrobiologi</mappedValue>
    </mappedCodedValue>
    <mappedCodedValue>
      <code>394596001</code>
      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>klinisk biokemi</description>
      <mappedValue>KliniskBiokemi</mappedValue>
    </mappedCodedValue>
    <mappedCodedValue>
      <code>394915009</code>
      <codeSystem>2.16.840.1.113883.6.96</codeSystem>

...

      <description>patologisk anatomi og cytologi</description>
      <mappedValue>Patologi</mappedValue>
    </mappedCodedValue>
  </practiceSettingCodes>
</filter>

Det er vigtigt, at den tilsvarende fil for documentmetadataprovider er konfigureret fuldstændigt identisk.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

I konfigurationen er det muligt at aktivere performanceloggeren, der udvalgte steder i adapteren, vil skrive tidsvarighed af kald igennem systemet. Performanceloggeren aktiveres ved at ændre level værdien fra "OFF" til "DEBUG". Eftersom konfigurationen kun indlæses ved opstart af servicen, er det nødvendigt at genstarte servicen efter endt redigering af log4j-sxa-documentprovider-ws.xml filen.
Eksempel på konfiguration af performanceloggeren, hvor level værdien er sat til "OFF":

<logger name="performancelogger" additivity="false">

...

  <level value="OFF" />

...

  <appender-ref ref="PerformanceFile" />

...

</logger>

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/ 

Per default udpeges konfigurationsfilen beskrevet i næste afsnit.

...

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main/

Anchor
_Toc462261558 _Toc462261558

HTTP Statuscheck på komponenter i Svareksponeringsservice XDS-adaptere

...

Anchor
_Toc327544084 _Toc327544084

Anchor
_Toc414948990 _Toc414948990

Anchor
_Ref448237841 _Ref448237841

Anchor
_Toc462261559 _Toc462261559

ServiceCheck.properties

...

Grundlæggende konfiguration af service-check sker ved tilretning af properties i ServiceCheck.properties filen. 
Eksempel på ServiceCheck.properties

...

 Code Block
jmx.url = service:jmx:rmi://localhost/jndi/rmi://localhost:1090/jmxconnector
jmx.username = nisse
jmx.password = ngyffe
service.config.path = service-check.xml
log4j.path = servicecheck.log4j.properties
...
Konfiguration af log4j sker ved tilretning af properties i filen servicecheck.log4j.properties:
...
 Code Block
log4j.logger.service-check=INFO, sclog
...

log4j.appender.sclog=org.apache.log4j.RollingFileAppender
log4j.appender.sclog.File=$
...
{jboss.server.log.dir
...
}/service-check.log
log4j.appender.sclog.layout=org.apache.log4j.PatternLayout
log4j.appender.sclog.layout.ConversionPattern=%d 
...
[%t
...
] %-5p %c - %m%n

 Anchor
_Toc434410445
_Toc434410445
 Anchor
_Ref327260436
_Ref327260436
 Anchor
_Toc327544085
_Toc327544085
 Anchor
_Toc414948991
_Toc414948991
 Anchor
_Toc462261560
_Toc462261560
JMX-Console sikkerhedsopsætning
...
Følgende script afvikles for at tilføje en ny JMX bruger på wildfly:
 Code Block
wildfly\bin\add-user.sh

Under opsætning af brugeren vælges typen 'Management User' og muligheden for kommunikation på tværs af applikationsservere kræves ikke rettigheder til.
Når brugeren er oprettet med navn og kodeord ændres ServicesCheck.properties, så properties stemmer overens med det indtastede i add-user.sh scriptet.
Se afsnit 4.3.1 for et eksempel på konfiguration af jmx.username og jmx.password.
...
Check i WildFly at servicen er registreret og aktiv
 Code Block
<service name="sxa-documentmetadataprovider">
...

    <assertions resultCode="200
...
">
        <mBeanCheck>
            <ObjectName>jboss.as:deployment=sxa-documentmetadataprovider.war,subsystem=undertow,servlet=MetadataProviderWS</ObjectName>
...

        </mBeanCheck>
...

    </assertions>
...

    <assertions resultCode="404">
...

        <mBeanCheck>
            <ObjectName>jboss.as:deployment=sxa-documentmetadataprovider.war,subsystem=undertow,servlet=
...
MetadataProviderWS</ObjectName>
            <isRegistered>false</isRegistered>
        </mBeanCheck>
    </assertions>
</service>
<service name="sxa-documentprovider">
...

    <assertions resultCode="200">
...

        <mBeanCheck>
            <ObjectName>jboss.as:deployment=sxa-documentprovider.war,subsystem=undertow,servlet=DocumentProviderWS</ObjectName>
...

        </mBeanCheck>
...

    </
...
assertions>
    <assertions resultCode="404">
...

        <mBeanCheck>
            <ObjectName>jboss.as:deployment=sxa-documentprovider.war,subsystem=undertow,servlet=DocumentProviderWS</ObjectName>
...

            <isRegistered>false</isRegistered>
...

        </mBeanCheck>
...

    </assertions>
...

</service>

 Anchor
_Toc327544086
_Toc327544086
 Anchor
_Toc414948992
_Toc414948992
...
Efter konfiguration og deploy af ServiceCheck servicen, kan Svareksponeringsservice XDS Adaptere servicecheck testes med følgende kommandoer:
 Code Block
curl –i localhost:9090/service-check/service?servicename=sxa-documentmetadataprovider
...
 
curl –i localhost:9090/service-check/service?servicename=sxa-documentprovider 

Servicen returnerer følgende http koder:
...
Efter konfiguration og deploy af Svareksponeringsservice XDS-adaptere kan versionsnummeret for fx Svareksponeringsservice XDS Registry Adapter hentes med:
 Code Block
curl localhost:9090/sxa-documentmetadataprovider/version 

hvilket giver output i stil med:
 Code Block
Version: 1.0.0 

Tilsvarende hentes versionsnummeret for Svareksponeringsservice XDS Repository Adapter blot ved at anvende det andet endpoint i tabellen.
...
Logfilnavn
Komponenter der skriver til denne
sxa-documentmetadataprovider-ws.log
Svareksponeringsservice XDS Registry Adapter
nsputil-sla-sxa-documentmetadataprovider.log
Svareksponeringsservice XDS Registry Adapter
sxa-documentmetadataprovider-ws-performance.log
Svareksponeringsservice XDS Registry Adapter
sxa-documentprovider-ws.log
Svareksponeringsservice XDS Repository Adapter
nsputil-sla-sxa-documentprovider.log
Svareksponeringsservice XDS Repository Adapter
sxa-documentprovider-ws-performance.log
Svareksponeringsservice XDS Repository Adapter
service-check.log
service-check

For alle webservices er der en tilhørende SLA-log, der sørger for at logge udvalgte elementer fra requests til webservicen.
Performance logs forekommer kun ved aktivering af performanceloggeren i komponenternes log4j konfiguration.
...