• All Files

Windows 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.2
  2. XEServer 9.2
  3. Edifecs Application Manager 9.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_(release number).(build number)_(archive date).exe to your workstation.
Install
  1. Double-click XESFHIRModule_(release number).(build number)_(archive date).exe. The Edifecs XES Module for FHIR 9.2 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 must be 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 HTTPS port at which Edifecs portal for FHIR can be accessed, and then click Next.
  2. Follow the links to the Edifecs Portal for FHIR and to the FHIR server and save the links, and then click Install.

Note The default installation involves the following links to the Edifecs Portal for FHIR: https://<YourComputerName>:10443/fhir-experience and to the FHIR server: https://<YourComputerName>:10443/hapi-fhir-jpaserver/R4.

  1. 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 on the Services tab, 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 start.bat and stop.bat files located at ${XESModuleForFHIRRoot}/bin.

  2. Make sure the status for these services in Task Manager has changed to Running. This may take some time.
Verify the web portal
  1. Run the start-and-browse.bat file located at ${XESModuleForFHIRRoot}/bin.
  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 or enter your credentials if you already have the account.
  3. On the Patients page, view the empty list of patients. When you upload the patient data to the HAPI FHIR server, the Patients page of the XES Module for FHIR portal displays a list of your 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. Click Browse for HL7/CCD to navigate to the location of the sample ADT-A01.dat file.
  2. Click Upload to upload the patient data to the HAPI FHIR server. The patient import is performed through the XEServer FHIR_Bridge profile.

    -Or-

    Go to ${XESModuleForFHIRRoot}\config\test-data\HL7 and copy the ADT-A01.dat file to the inbound location of the HL7 route: ${XESModuleForFHIRRoot}\workspace\Runtime\HL7\HL7toFHIR\InboundHL7

  1. 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.
  2. After the file is processed, go to the Patients page of the web portal and refresh the page to see the list of patients.
  3. Click a patient in the list to view his/her encounters, diagnostic reports, and other available resources.
Connect to databases For the information on how to establish connections to databases (for example, MS SQL database), see the FHIR Database Configuration help topic.
Renew SSL certificates For more information on how to migrate SSL certificates to protect users of your organization by encrypting all the network data transfers, see the SSL Certificate Deployment help topic.
Get access to VisualizerPackages

To visualize data, configure data visualizations on the FHIR web portal. To do this, install SpecBuilder 9.2 including Visualizer Server 9.2. For more information on how to install SpecBuilder, see SpecBuilder Help Center. For more information on the configuration of data visualization, see Data Dashboards.

To verify that the FHIR server is working, you can upload a sample FHIR resource bundle to the FHIR server and get a response that the sample FHIR resource bundle has been processed.

Prerequisites

  • A sample FHIR resource bundle, for example, SampleBundle.xml.
  • cURL that is a tool used to transfer data from or to a server using one of the supported protocols (FTP, FTPS, HTTP, HTTPS, LDAP, TFTP, and so on). By default, the cURL tool is available with the Windows 10 operating system.

To upload a sample FHIR resource bundle onto the FHIR server through cURL:

  1. In the directory where the sample FHIR resource bundle (SampleBundle.xml) is located, run the command-line interpreter, and then run the following command to upload the sample FHIR resource bundle onto the FHIR server and to create a request response (response.xml):

    2. curl -X POST "https://localhost:10443/hapi-fhir-jpaserver/R4" -H "Content-Type:application/xml" --data @SampleBundle.xml --insecure > response.xml

    Ensure that the HTTPS port (10443) at which the FHIR server can be accessed is the same as during the installation.

Note By default, the HTTPS port is 10443.

  1. Click Enter.

You can view the created request response that was created – the file response.xml in the directory where the sample FHIR resource bundle is located. The response should contain <status value="200 OK" />.

ClosedThe sample FHIR resource bundle

<Bundle xmlns="http://hl7.org/fhir">

<entry>

<resource>

<Practitioner xmlns="http://hl7.org/fhir">

<id value="1"></id>

<identifier>

<value value="1"/>

</identifier>

<identifier>

<type>

<coding>

<code value="NPI"/>

</coding>

</type>

<value value="1952327215"/>

</identifier>

<name>

<family value="BAL"/>

<given value="ASWINE"/>

</name>

</Practitioner>

</resource>

<request>

<method value="POST"></method>

<url value="Practitioner/1"></url>

<ifNoneExist value="identifier=1"></ifNoneExist>

</request>

</entry>

<entry>

<resource>

<Schedule xmlns="http://hl7.org/fhir">

<id value="2"/> <identifier>

<value value="102"/> </identifier>

<identifier>

<value value="2"/>

</identifier>

<active value="true"/>

<actor>

<reference value="Practitioner/1"/>

</actor>

</Schedule>

</resource>

<request>

<method value="POST"></method>

<url value="Schedule/2"></url>

<ifNoneExist value="identifier=2"></ifNoneExist>

</request>

</entry>

 

<entry>

<resource>

<Patient xmlns="http://hl7.org/fhir">

<id value="3"/>

<extension url="Link">

<valueString value="http://services-uswest.skytap.com:29182/pd/#plmr?idXk3Ml5M"/>

</extension>

<identifier>

<value value="Edifecs_0000000"/>

</identifier>

<identifier>

<value value="3"/>

</identifier>

<name>

<use value="official"/>

<family value="West"/>

<given value="Anna"/>

</name>

<gender value="female"/>

<birthDate value="1967-04-29"/>

<address>

<line value="2777 Terra Street"/>

<city value="Seattle"/>

<state value="WA"/>

<postalCode value="98109"/>

</address>

</Patient>

</resource>

<request>

<method value="POST"></method>

<url value="Patient/3"></url>

<ifNoneExist value="identifier=3"></ifNoneExist>

</request>

</entry>

 

(...)

</Bundle>

ClosedThe sample response

<Bundle xmlns="http://hl7.org/fhir">

<id value="d584904d-fd0d-4d9c-bc12-d63afde58189"/>

<type value="transaction-response"/>

<link>

<relation value="self"/>

<url value="https://localhost:10443/hapi-fhir-jpaserver/R4"/>

</link>

<entry>

<response>

<status value="200 OK"/>

<location value="Practitioner/52/_history/1"/>

<etag value="1"/>

</response>

</entry>

<entry>

<response>

<status value="200 OK"/>

<location value="Schedule/53/_history/1"/>

<etag value="1"/>

</response>

</entry>

<entry>

<response>

<status value="200 OK"/>

<location value="Patient/54/_history/1"/>

<etag value="1"/>

</response>

</entry>

<entry>

<response>

<status value="200 OK"/>

<location value="Slot/55/_history/1"/>

<etag value="1"/>

</response>

</entry>

(...)

</Bundle>

Copyright © 2021 Edifecs | www.edifecs.com

Privacy PolicyTerms of UseAbout Us