HL7 to FHIR Server Sample Profile Overview
This profile represents a system that can create / update / delete patients' data on a FHIR server depending on the type of the HL7 file received as an input:
- ADT 01 - create,
- ADT 03 - update data (or add data),
- ADT 08 - delete data (or modify).
Profile Location
Edifecs Library / FHIR / FHIR Interactions / HL7 to FHIR Server Sample
Requirements
- Edifecs EAM 9.2.1 or later,
- Edifecs XEngine 9.2 or later,
- Edifecs XEServer 9.2.1 or later,
- Edifecs XEngine Server Module For FHIR 9.2.1 or later
Prerequisites
- On the EAM System tab, expand XEConnect, go to Authorization (OAuth 2.0), and then double-click Sample FHIR Configuration.
- On the EAM Outline tab, expand Clients.
- Select FHIR Module System Client and click Edit.
-
Copy Client ID and Client Secret to a temporary location (for example, to Notepad).
Tip You cannot copy the value of Client Secret from the EAM interface. If you do not know the current Client Secret, click Re-generate & Copy. This generates a new client secret and puts the value on the clipboard. When you generate a new client secret, remember to update the new client secret for XESModule For FHIR Web Portal (Security Tab) and restart the profile FHIR Authorization.
- Open the HL7 to FHIR Server Sample profile configuration.
- On the EAM Outline tab, click HL7 to FHIR Server Sample, and go the profile's Environment tab.
- Update the profile environment properties OAuthClientId and OAuthClientSecret with the values that you have previously copied (see Step 4).
- Save the profile configuration (CTRL+S).
- On the EAM System tab, expand XEServer, and then open Admin Console.
- Start the profile HL7 to FHIR Server Sample.
- Ensure that the following profiles are started:
- FHIR Authorization,
- FHIR Secure Proxy,
- FHIR Server (HAPI)
Profile Execution
Test 1: ADT 01-03
- Copy the file ${XESProfileConfig}/testdata/ Case ADT03 - Donna Lupold/ 04_ADT_A01_Donna_Lupold.dat to the directory ${XESWorkspace}/data-in.
- Open the Patients page in the XESModule For FHIR web portal (https://localhost:10443/fhir-experience/application#/patients/).
- Select the patient entry Donna Lupold. The patient record has 1 Encounter, 3 Observations, and 3 Allergies items.
- Copy the file ${XESProfileConfig}/testdata/ Case ADT03 - Donna Lupold/ 09_ADT_A03_Donna_Lupold.dat to the directory ${XESWorkspace}/data-in.
- Open the Donna Lupold patient page in the XESModule For FHIR web portal. The patient record has 1 Encounter, 6 Observations, 3 Procedures, and 5 Allergies items.
Test 2: ADT 01-08
- Copy the file ${XESProfileConfig}/testdata/Case ADT08 - Alicia Texas/A01_ATexas.dat to the directory ${XESWorkspace}/data-in.
- Open the Patients page in the XESModule For FHIR web portal (https://localhost:10443/fhir-experience/application#/patients/).
- Select the patient entry Alicia Texas. The patient record has 1 Encounter, 3 Observations, 1 Procedure, and 3 Allergies items.
-
Open the patient's Allergies . The following items are available:
- Allergy Mosquito
- Allergy 372687004 (AllergenCode/Amoxicillin 125 Mg Tab)
- Allergy 395890008 (AllergenCode/Sulfalene)
- Copy the file ${XESProfileConfig}/testdata/Case ADT08 - Alicia Texas/A08_ATexas.dat to the directory ${XESWorkspace}/data-in.
- Open the Alicia Texas patient page in the XESModule For FHIR web portal. The patient record has 1 Encounter, 3 Observations, 1 Procedure, and 2 Allergies items. The patient record now contains the following Allergies (the Allergy item Sulfalene has been removed):
- Allergy Mosquito
- Allergy 372687004 (AllergenCode/Amoxicillin 125 Mg Tab)
- Note the patient's address - 4150 Sydney.
- Copy the file ${XESProfileConfig}/testdata/Case ADT08 - Alicia Texas/A08_ATexas_02.dat to the directory ${XESWorkspace}/data-in.
- Open the Alicia Texas patient page in the XESModule For FHIR web portal. Notice that the patient's address has changed to 4151 Marymoore.