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.
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..