FHIR Transform
Category: Healthcare Standards
Node id: fhir-transform
Standards: HIPAA, GDPR, SOC2
Transforms FHIR resources between types using predefined or custom field mappings
What it does
- Predefined transformations: Patient-to-Practitioner, Observation-to-DiagnosticReport, MedicationRequest-to-MedicationStatement, Encounter-to-EpisodeOfCare
- Custom field mappings via JSON configuration
- Nested path extraction and assignment (dot-notation)
- Automatic metadata injection (lastUpdated, generated ID)
- FHIR resource type validation
Use cases
- Transform patient records into practitioner resources for role-based workflows
- Convert observations into diagnostic reports for clinical decision support
- Map EHR data between FHIR resource types during migration
Runtime
- Performance tier:
fast - Effect:
read
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
resource | json | Yes | Source FHIR resource to transform |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
result | json | No | Transform result (resource, resourceType, source_type, target_type) |
success | boolean | No | Whether the transformation succeeded |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Source Type | source_type | string | Yes | Source FHIR resource type | ||
| Target Type | target_type | string | Yes | Target FHIR resource type | ||
| Transformation | transformation | string | No | Predefined transformation name (e.g., patient-to-practitioner) |
Advanced
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Source Field | source_field | string | No | resource | Input field name containing source data | |
| Custom Mappings | mappings | json | No | Custom field mappings (target_field -> source_path) |
Errors
| Code | Description |
|---|---|
MISSING_SOURCE_TARGET | source_type and target_type are both required |
INVALID_RESOURCE_TYPE | Source or target is not a valid FHIR resource type |
UNSUPPORTED_TRANSFORMATION | Named predefined transformation is not recognized |
MAPPINGS_REQUIRED | Custom transformation requires mappings configuration |
Runtime notes
- result.resource is the transformed FHIR resource with a generated ID and lastUpdated meta — wire to a FHIR client node for storage
- Custom mappings use dot-notation paths (e.g. 'name.0.family') for both source extraction and target assignment
- Predefined transforms: patient-to-practitioner, observation-to-diagnostic-report, medication-request-to-medication-statement, encounter-to-episode-of-care
- The source_field config defaults to 'resource' — change it if your upstream node outputs data under a different key
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Something unclear? Send documentation feedback by email.