FHIR to OMOP
Category: Data
Node id: fhir-to-omop
Standards: OMOP-CDM-5.4, EHDS
Transforms FHIR R4 resources into OMOP CDM 5.4 table structures (24 tables, 16 resource types supported). Vocabulary mapping is deferred (concept_id=0, source_value preserved).
What it does
- Maps 16 FHIR resource types to 24 OMOP CDM 5.4 tables
- Deterministic Person ID generation via SHA-256 from FHIR Patient ID
- Automatic routing of Observations to measurement vs observation tables by category
- Derived table computation: observation_period, condition_era, drug_era, dose_era
- Multi-source input support: merges resources from parallel query nodes
- FHIR Bundle unwrapping with entry-level resource extraction
- Context cancellation support for large dataset processing
Use cases
- Convert EHR FHIR exports into OMOP CDM for observational research
- Populate OHDSI analytics databases from clinical FHIR data
- Enable cross-institutional data harmonization using OMOP as common model
- Support EHDS compliance by transforming FHIR to standardized research format
Runtime
- Performance tier:
medium - Effect:
read
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
resources | json | No | Array of FHIR resources or a FHIR Bundle |
data | json | No | Alternative input: array of FHIR resources |
bundle | json | No | Alternative input: FHIR Bundle resource |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | OMOP CDM result: omop_tables (24 tables), mapping_stats, unmapped_resources |
success | boolean | No | Whether all resources were mapped without errors |
Errors
| Code | Description |
|---|---|
EMPTY_RESOURCES | No FHIR resources found in any input port |
INVALID_RESOURCE | Input element is not a valid FHIR resource map |
CONTEXT_CANCELLED | Processing cancelled via context (e.g., timeout) |
Runtime notes
- result.omop_tables contains 24 tables as arrays of row objects — each table key matches the OMOP CDM 5.4 table name
- concept_id fields are always 0 (vocabulary mapping deferred) — source_value fields preserve the original FHIR codes
- Observations with category 'vital-signs' or 'laboratory' route to measurement table; all others go to observation table
- Accepts FHIR Bundles, resource arrays, or individual resources from any input port — multiple ports are merged
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.