Welcome to the official training repository for the FHIR Workshop for Ready 2025. This workshop is designed to guide developers through practical exercises using FHIRPath and FHIR SQL Builder in a locally hosted FHIR development environment.
To follow the exercises, you need to set up a local development environment.
You’ll need the following tools:
- Docker
- VS Code
- Python
- Jupyter Notebooks
- IRIS for Health Community Edition 2025.1 (with a pre-configured FHIR server and sample patients)
For setup instructions, refer to:
Clone this repository into your development directory:
git clone https://github.com/intersystems/Ready2025.git
Make sure your Docker container is running. Verify that the FHIR server is operational:
GET http://127.0.0.1:8080/csp/healthshare/demo/fhir/r4/metadata
If a CapabilityStatement is returned, you're good to go!
Navigate to the Jupyter notebook:
FHIRPath/Fhirpath1.ipynb
Ensure your FHIR server is running (
docker ps
and check metadata endpoint).
Note:FHIRPath/Fhirpath2.ipynb
is optional.
http://127.0.0.1:8080/csp/fhirsql/index.html
- Username:
_SYSTEM
- Password:
ISCDEMO
-
Create a Repository Configuration
- Host:
127.0.0.1
- Port:
52773
- Repository URL:
/csp/healthshare/demo/fhir/r4
- Credentials: Use
_SYSTEM / ISCDEMO
- Host:
-
Launch Analysis Task
- Analyze 100% of ~70K resources
-
Create Transformations
pt_transform
:
"ID", "BirthDate", "FirstName", "Gender", "LastName", "LastUpdated", "MaritalStatus", "PatientBirthPlaceCity"
allergy_transform
:
"ID", "AllergyCode", "AllergyDisplay", "LastUpdated", "PatientReference"
-
Create Projections
pt_transform
→ SQL Package:sql1
allergy_transform
→ SQL Package:sql2
-
View SQL Tables
Access via Management Portal:http://127.0.0.1:8080/csp/sys/exp/%25CSP.UI.Portal.SQL.Home.zen?$NAMESPACE=DEMO
📺 Watch the step-by-step video: https://bcove.video/4iRIDN8
Open the notebook:
FHIRAnalytics/AlllergyInterolerance.ipynb
- Learn to query the projected FHIR data using the InterSystems Python db-api driver.
- Perform data analysis and exploration.