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:
mvn clean package
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)