XES Module for FHIR Portal

Web Portal

An XES Module for FHIR web portal allows you to view the results of data mapping and resources used for use cases without having to use REST API. The web portal contains the following pages:

Patients

The Patients page of the XES Module for FHIR portal displays a list of patients uploaded to the HAPI FHIR server. All data you receive from different sources on a specific patient (eligibility requests, claims, details on allergy intolerance, encounters, observations, medications, and so on) is stored as FHIR resources and linked to this patient for easy access. On the Patients page, you can select a patient and view the patient's personal data, medical history, diagnosis, eligibility requests and responses, claims if any, and all other information extracted from that patient’s transactions.

You can also log in to a Patient portal as a patient and view the patient data that is only relevant to you.

You can click a line of a corresponding patient to view the Patient Details page for the selected patient, and sort the resources by date. To view the patient's data in the FHIR format, click FHIR ID. The Patient Details page also displays the time line - a diagram that displays the selected events chronologically for a specific patient. From the tables with eligibility requests, claims, details on allergy intolerance, encounters, observations, medications, and so on, you can remove each line with a record as well as multiple records of the same kind at once. You can also disable each table with encounters, observations, and so on by using corresponding check boxes next to a patient details on the left.

You can generate a CCD file and download the file to your computer. Click Generate CCD to create CCD data using the FHIR resources through the FHIR to CCD XEServer route in preconfigured XEServer profile.

You can also download your personal health records. For this, on the Patient Details page, click Blue Button to download your health information (a blue button bundle) in the .html format. The Blue Button gives you direct and easy access to your personal health records that you can view online or download in a human-readable format.

The downloaded file can have information on the following items:

• Medical treatment
• Current medication
• Laboratory test results
• Allergies
• Health insurance claims information (financial, clinical, and so on).

You can also download your health information from the FHIR resources by clicking Blue Button FHIR Bundle.

All data received for a specific patient creates a FHIR bundle in the FHIR format that you can download by clicking FHIR Bundle.

The XESModule for FHIR installation contains a preconfigured XEServer profile that implements the Blue Button function. The profile receives 835/837 EDI transaction types, extracts the Explanation of Benefit (EOB) section, and uploads EOB onto a FHIR server. As a result, the EOB section becomes available to a patient on the web portal. The profile is located at $XES Module for FHIRRoot\assets\ProfileImages.

You can also book an appointment with a practitioner (doctor) through the Patient Details page.

1. Next to Send Alert, click Book an Appointment.
2. In the Appointments section, in the Please, select doctor field, select the <YourDoctorName> doctor. When you have selected a certain doctor, his/her time slots defined in the EMR system are available in the time zone of the doctor.
3. In the calendar view, select any available date, and then from the time slots that appear, select a slot for the new appointment, click Book. The appointments are created using the XEServer Da Vinci 1 Scheduling Generic profile. You can sort your appointment notes by dates.



Note The scheduled appointment note in the Appointments section serves only as a reminder. Even when you remove the appointment note from the XES Module for FHIR portal, the appointment still remains in the remote EMR system.

Before you book the appointment, ensure that the connection to the remote EMR system has been established. When the connection has been established, the list of doctors is retrieved through the XEServer Da Vinci 1 Scheduling Generic profile. If there is no connection, refresh the connection. Before you refresh the connection to the remote EMR system, make sure that you run the profile.

Note If connection to a remote location of Electronic medical records (EMRs) cannot be established, the Book an Appointment button is disabled and you cannot select the practitioner.

To send an alert

On the Patient Details page, you can also send a certain patient's data to a provider using alerts that contain a FHIR bundle with the required encounters, conditions, coverages, and so on.

To send an alert to a Provider:

1. On the Patients page, select a patient, and then on the Patient Details page, next to Blue Button, click Send Alert.
2. In the dialog that appears, select the resources you want submitted in the alert, in Event code, specify the purpose of an event or leave the default event code, and then click Send Alert.

The alerts are created and sent through the FHIR Payer Alerts profile.

Coverage Eligibility

The Coverage Eligibility page allows you to view:

• A list of coverage eligibility requests with the details about the patient specified in the request
• Details on response, if it has already been received.

All data received for a specific patient forms a FHIR bundle in the FHIR format. New data received for the same patient is linked to the bundle. If some data is already present in the bundle, it is skipped to avoid duplication. On the Coverage Eligibility page, you can also view the original EDI transaction that was used to form a FHIR resource. For example, you can view a coverage eligibility response in the native format it was received in.

Using the XES Module for FHIR portal, you can also submit a coverage eligibility request (EDI or FHIR).

To submit the coverage eligibility request:

1. In the XES Module for FHIR portal, on the Coverage Eligibility page, click Create Coverage Eligibility Request.
2. Fill in the Create Coverage Eligibility Request form, and then click Submit.

Claims

On the Claims page of the XES Module for FHIR portal, you can view a list of processed claims and submit a new claim. For more information, see Claims Processing.

Providers

On the Providers page of the XES Module for FHIR portal, you can view a list of providers available on the FHIR server. Providers have a unique NPI (national provider identifier). All HIPAA covered organizational and individual healthcare providers must have an NPI. It is an identification number required by HIPAA for use in financial and administrative transactions.

Visualizer

On the Visualizer page of the XES Module for FHIR portal, you can visualize FHIR data. To view the Visualizer page, make sure that you enabled data visualization on the Settings page.

CCD Viewer

On the CCD Viewer page of the XES Module for FHIR portal, you can render complex CCD documents in a format that allows you to view and manage your clinical data.

Interaction Log

On the Interaction Log page of the XES Module for FHIR portal, you can view the requests that XES Module for FHIR sends to the FHIR Server, as well as the actions performed on the FHIR web portal.

You can add a log panel with any system and your log to any of the pages and view the requests and performed actions. On the top of any page, click Log panel or press the Ctrl+~ key combination.

Web Portal Settings

Common Settings

Settings	Descriptions
FHIR Server URL	The path to the standalone HAPI FHIR server preloaded with sample data for use cases.
CCD REST Service	The path to the REST service that displays CCD files on the XES Module for FHIR web portal.
Items Per Page	Records with patients' resources displayed in the Patients section of the XES Module for FHIR web portal.
Auth Type	The type of authorization. The following types are available: Smart Trading Accounts Service: requires you to enter your Smart Trading account credentials. If you do not have a Smart Trading account, on the Edifecs XES Module for FHIR Web portal page, click Create account. For more information, see Create Account. Built-in Database: requires you to enter the Built-in Database credentials you used during the registration on the XES Module for FHIR web portal.

Visualizer

Select On to enable the Visualizer tab on the XES Module for FHIR web portal. To visualize FHIR data through the XES Module for FHIR web portal, you must first install Visualizer Server.

Settings	Descriptions
Visualizer Dashboard Name	A name of the dashboard that you import to Visualizer Server.
Visualizer Data Store Name	A name of the data store that you import to Visualizer Server.
Visualizer Access Token Path	A path to the folder with security tokens. A token archive is generated during the installation of Visualizer Server. The directory with default security tokens is specified during the installation process.

External EMRs Settings

Settings	Descriptions
Cerner Base URL	The path to the Cerner Base with Electronic medical records (EMRs) of the patients that you can import in the Patients section of the XES Module for FHIR web portal.
Epic Base URL	The path to the Epic Base with patient information from a particular organization that you can import in the Patients section of the XES Module for FHIR web portal.
EMR Scheduling URL	The path to the schedule Electronic medical records (EMRs) of the practitioners where time slots are defined to book an appointment in the Patients section, on the Patient Details page of the XES Module for FHIR web portal.
Message Bundle Processing URL	The path to the Restful Web Service through which a request for a message bundle creation is sent.

Logger

Settings	Description
Log refresh interval	The frequency (in seconds) with which you want log pages to be refreshed.
Amount of log records	The maximum number of log records. The default value is 1000.
List of logs	The list of the requests that XES Module for FHIR sends to the FHIR Server, as well as the actions performed on the FHIR web portal. You can view the following System logs: Web Application FHIR Server Log Tomcat log Emr Interaction Apart from the System logs, you can also create your own (user) logs based on your business requirements that are displayed in the Interaction Log section. To do this, click Create new log, and then in the Create new log dialog, in Name, enter an informative name for your log. In Log folder, enter the path to the folder with the required logs. In Log file mask, enter the file name templates by which the required logs are retrieved, and then click Create.

Security

To keep your data safe, you can enhance your security by using an authorization feature - XEConnect Authorization, based on the OAuth 2.0 framework that provides strong authentication. The XEConnect Authorization service allows you to issue JWT tokens used to authorize user requests and to limit user access to resources.

Settings	Description
OAuth2 Server Token Endpoint	The path to the OAuth2 Server token endpoint (Authorization Service) that issues and verifies JWT access token used to authorize user requests and to limit user access to resources.
OAuth2 Client ID	The unique identifier of the XEConnect client registered in Client Management for which the token has been issued. To issue an access token, the OAuth2 service checks: if the client (with the ID) is registered in Client Management, if the grant type, for which the token is required, is permissible for this client.
OAuth2 Client Secret	The secret key used to issue a token and to protect the client identity.
User lookup url	The path to the Restful Web Service, which has the relative path to the deployed web service endpoint, used in the FHIRUserLookup Profile.