Add and Manage EHRs

The LifeOmic Platform integrates several EHRs. The following procedures are for a general EHR integration. For a Cerner or Epic EHR integration, see the SMART on FHIR App article.

To get more information on a specific EHR, including how to obtain API credentials, refer to their API documentation.

• BCDA API Documentation
• Cerbo API Documentation
• InBody API Documentation

Configure a Cerbo, InBody, or BCDA EHR

1. From any page in the app, click the logo at the top of the page.
2. From the home page, click the Account Info tile.
3. Click the EHRs tab.
4. Click Add to display the EHR Details dialog.
5. For Status, choose Enabled.
6. For EHR Name, enter a specific name.
7. For EHR Type, pick a listed EHR ingestion type, such as BCDA.
8. For API Base URL, obtain the URL endpoint to use for the ingestion of FHIR data from the EHR vendor. For example, https://api.bcda.cms.gov.
9. For API Auth Type, choose from the listed options, such as BCDA Backend Service. Listed options are specific to the EHR type.
10. For API Key, use the credential supplied by your EHR for your account. Note: Contact your EHR for the process to obtain your credentials. You may generate the credentials on their portal or obtain it directly from their team.
11. For API Secret, obtain this credential from the EHR vendor.
12. For Ingestion Model:
    • Choose Asynchronous for large data ingestions that can take several hours. Asynchronous allows ingestion in the background.
    • Choose Synchronous for small data ingestions. Synchronous pauses the system until the ingestion completes.
13. For Delay (in Seconds) Between Records, use the controls to set a desired interval or leave unset for no delay. Three seconds is a general guideline.
14. Leave the Additional Configuration section blank and click Save.
15. To start an ingestion, click the Ingestions tab and Start Ingestion or set up a Scheduled Ingestion.
16. To confirm a successful ingestion, log into the app, click the Subjects tab on the left side, and find the patient's name. Patients appear in Subjects after the subject record import. For more information, see Subjects.

Manage EHRs with the LifeOmic Platform App

1. From any page, click the logo at the top of the page.

2. From the home page, click the Account Info tile.

3. Click the EHRs tab to list the currently integrated EHRs.

   

4. To remove an EHR, click the delete icon.

5. To examine the details of an EHR, click the details icon on the EHR row. From the EHR Detail view, you have several options.

   1. From the default Project Connectors tab view, click Update EHR to display and configure the EHR details.

   2. Click the delete icon on the Project row to remove the connector.

   3. Click Add Project Connector to display the Add Project Connector dialog and use the drop down to select a project and click Save.

   4. From the Ingestions tab, mouse over a row to reveal the menu controls.

   5. Click the Rerun Ingestion icon to kick off an ingestion.

   6. Click the to display the details of an ingestion.

      

   7. From the Scheduled Ingestions tab, click Schedule Ingestion to display the Start Ingestion dialog.

   8. On the Start Ingestion dialog, under Connectors, select a connector or multiple connectors.

   9. Select Consume Pending Updates to ingest any data already in the queue.

   10. Under Records, leave unselected to ingest all records. Click Add Record and select PATIENT or DOCUMENT for a specific record. For the PATIENT ID or DOCUMENT ID, use the ID from the EHR source, such as Cerner or Epic.

   11. Under Schedule, select day or hour and the time of day in the Coordinated Universal Time (UTC) zone.

   12. Click Add.