Installation Steps

To install and run XES Module for FHIR on Windows, complete the following steps:

To Do this
Prerequisites

Install the following required Edifecs solutions:

  1. XEngine 9.1
  2. XEServer 9.1
  3. Edifecs Application Manager 9.1 Hotfix 2

Note If you upgrade or reinstall Edifecs Application Manager, make sure you have stopped the EAM client and a Windows service running the EAM server.

Download
  1. To get the download instructions, contact the support at www.edifecs.com/contact-us/.
  2. Copy XESFHIRModule_(build number)_(archive date).msi to your workstation.
Install
  1. Double-click XESFHIRModule_(build number)_(archive date).msi. The Edifecs XES Module for FHIR 9.1 Setup Wizard loads. Click Next.
  2. Review and accept the license agreement, and then click Next.
  3. Click Change to specify the folder where XES Module for FHIR is installed, or click Next to accept the default location.
  4. Select the JDK to be used by the application. You can select from installed JDK versions, or enter a path to a JDK folder with binaries. Click Next.

Note The required JDK version is 11.0.2 or later.

  1. Specify the HTTP port at which Edifecs portal for FHIR can be accessed.
  2. Review or change installation settings, and then click Install.
  3. When the installation is complete, click Finish.

Note The FHIR Server is installed automatically with the XES Module for FHIR installation.

Start the FHIR Server and the profile
  1. Go to the Windows Task Manager and start the EdifecsXESModuleForFHIR service to run the FHIR Server and the Edifecs_XEServer_FHIR_Bridge service to run the XEServer profile.
  2. To start and stop the FHIR Server, you can also use the ${XESFHIRRoot}/bin/start.bat and ${XESFHIRRoot}/bin/stop.bat files.

  3. Make sure the status for these services in Task Manager has changed to Running. This may take some time.
Ensure that the Web portal is working
  1. Run the ${XESFHIRRoot}/bin/start-and-browse.bat file.
  2. On the Edifecs XES Module for FHIR Web portal page, click Create account, fill in the fields for registration, and then sign in to the portal.
  3. On the Patients page, view the empty list of patients.
Verify installation

To verify that all the major components are properly installed, you can perform the following sample scenario to convert HL7 test data to the FHIR format:

  1. Go to ${XESFHIRRoot}\config\test-data\HL7 and copy the ADT-A01.dat file to the inbound location of the HL7 route: ${XESFHIRRoot}/workspace/Runtime/HL7/HL7toFHIR/InboundHL7.
  2. You can go to Edifecs Application Manager to verify that the HL7 Channel route picked the file and no exceptions or errors occurred while processing.
  3. After the file is processed, go to the Patients page of the Web portal and refresh the page to see the list of patients.
  4. Click a patient in the list to view his/her encounters, diagnostic reports, and other available resources.
Connect to other databases For the information on how to establish connections to databases (for example, MS SQL database), see the FHIR Database Configuration help topic.
Get access to VisualizerPackages

Install SpecBuilder 9.1 including Visualizer Server 9.1. For more information on how to install SpecBuilder, see SpecBuilder Help Center.