Indledning

Nærværende dokument udgør udviklervejledningen for EAS (EHMI AdresseringsService). EAS fungerer som opslagsservice, som baseret på forskellige parametre kan fremsøge modtagere på EHMI-netværket.
Komponenten er udviklet som en Java-applikation baseret på HAPI FHIR Plain Server og understøttes på JBoss Application Server version 8 (Wildfly). Komponenten integrerer til PersonInformation, SikredeInformation, SORES og EER.

Opsætning af udviklingsmiljø

Projektet bygges ved at udføre en af disse:

mvn clean package

eller via nspbuilder:

docker run --rm -it -v "$PWD":/workspace -w /workspace -e revision="snapshot" registry.nspop.dk/tools/nspbuilder:4.0.3 mvn -B -Drevision=snapshot clean install

Derefter kan EAS-servicen startes ved at skifte til compose/development og køre:

docker-compose up --build

Test

Når EAS-servicen er startet lokalt, kan servicens operationer (jf. OperationDefinitions i EAS implementation guiden) tilgås på følgende URL'er:

http://localhost:8081/eas/fhir/Organization/$getListOfGpByPostalCode

http://localhost:8081/eas/fhir/Organization/$getReceivingOrganizationByGPId

http://localhost:8081/eas/fhir/Organization/$getReceivingOrganizationByPatientId

http://localhost:8081/eas/fhir/Organization/$getReceivingOrganizationBySORId

Eksemplerne fra implementation guiden kan benyttes som input, fx således (NB: uden Authorization header):

curl -X POST 'http://localhost:8081/eas/fhir/Organization/$getReceivingOrganizationBySORId' \
  -H 'Content-Type: application/fhir+json' \
  -H 'Accept: application/fhir+json' \
  -d '{
    "resourceType" : "Parameters",
    "id" : "EX-GetReceivingOrganizationBySORId-Request",
    "parameter" : [
      { "name" : "sorId", "valueString" : "12345678" },
      { "name" : "messageType", "valueString" : "XDIS92" }
    ]
  }'

Release

TODO

Tilføjelse af Operation Definitions

EAS implementation guiden indeholder "operation definitions" svarende til FHIR-operationerne i EAS-servicen. Når der tilføjes nye services i EAS, vil der optræde automatisk genererede operation definitions i /fhir/metadata-endpointet. Der findes ikke funktionalitet (annotations) til at berige de auto-genererede operation definitions med alle elementer, der normalt er ønskelige i implementation guiden. Derfor bør der ske følgende berigelser før tilføjelse til IG'en:

• Description: En passende tekstuel beskrivelse af operationen.
• URL: Skal alignes med IG'ens officielle URL
• Eksempel: Tilføjes i fsh-format under hver operation definition (evt. flere hvis der er tale om komplicerede requests)
• Purpose: Beriges med henvisning til eksempel (Description-feltet var også kandidat til dette, men HTML-tagging videreføres uhensigtsmæssigt på IG'ens "Artifacts"-oversigt)

Implementation guiden, som skal ajourføres med nye OperationDefinitions, findes her: https://github.com/medcomdk/dk-ehmi-eas. Opdateringer udføres ved at lave et fork, og lave pull requests derfra, hvorefter man skriver til ehmi@medcom.dk og beder om godkendelse.