Skip to main content

Import Sample Test Data

Introduction​

In this document, we provide instructions for importing sample data into the Helios FHIR Server.

We use Synthea, an open-source tool developed by The MITRE Corporation. Synthea is a Synthetic Patient Population Simulator. Synthea can output synthetic, realistic (but not real), patient data and associated health records in a variety of formats, including HL7 FHIR R4.

Prerequisites​

Synthea​

Download Synthea from GitHub using git.

git clone https://github.com/synthetichealth/synthea.git

Let’s generate 1000 simulated patients and data and examine the output.

cd synthea
./run_synthea -p 1000
cd output/fhir
[...Examine some of the FHIR output...]

Enable Additional FHIR Resources and Search Parameters (Optional)​

The Helios FHIR Server Enterprise Edition ships with the following set of enabled FHIR Resources required by Synthea.

  • AllergyIntolerance
  • Bundle
  • CarePlan
  • CareTeam
  • Claim
  • Condition
  • Coverage
  • Device
  • DiagnosticReport
  • DocumentReference
  • Encounter
  • Endpoint
  • ExplanationOfBenefit
  • HealthcareService
  • ImagingStudy
  • Immunization
  • Location
  • Medication
  • MedicationAdministration
  • MedicationRequest
  • Observation
  • Organization
  • Patient
  • Practitioner
  • PractitionerRole
  • Procedure
  • Provenance
  • RelatedPerson
  • ServiceRequest
  • SupplyDelivery
  • AuditEvent
  • CapabilityStatement

No Search Parameters are enabled by default for any Resources

Should you wish to enable additional FHIR Resources or Search Parameters:

  • Login to the Helios FHIR Server User Interface http://localhost:8181/ui
  • Username: admin@heliossoftware.com
  • Password: admin
  • Select Resources then select the Resource you wish to use and select Enable.
  • Additionally, on that same page, you may also select individual Search Parameters

Using the Karaf console, monitor the startup log and wait until all resources have finished starting up using the log:tail command.

Import the Sample Data​

Build and run the fhir-importer using Java 21.

git clone https://github.com/HeliosSoftware/fhir-importer.git
cd fhir-importer
mvn clean install

The fhir-importer jar will reside in the /target folder.

Run the following command to import the generated data.

java -jar [path to fhir-importer]/fhir-importer-0.0.1-SNAPSHOT.jar -directory [path-to-output/fhir] -regex ".*.json"

If all goes well you should see a progress bar as follows:

Status: 43% [========____________]