Skip to content

Add and Manage EHRs

PHC 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.

Configure a Cerbo, InBody, or BCDA EHR

  1. From any page in PHC, click the logo at the top of the page.
  2. From the home page, click the Account Info tile. Account
  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. EHR Details
  15. To start an ingestion, click the Ingestions tab and Start Ingestion or set up a Scheduled Ingestion. EHR Start Ingest
  16. To confirm a successful ingestion, log into PHC and click the Subjects tab on the left of PHC and find the patient's name. Patients appear in Subjects after the subject record import. For more information, see Subjects.

Manage EHRs with the PHC Web App

  1. From any page in PHC, click the logo at the top of the page.
  2. From the home page, click the Account Info tile. Account
  3. Click the EHRs tab to list the currently integrated EHRs.

    EHRs Navigation

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

  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 project 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.
      EHR Connectors

    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.

      EHR Ingestions

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

    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.

      EHR Ingestions


Last update: 2022-02-03
Created: 2022-02-02