Cumuluz Translate Implementation Guide
0.1.0 - ci-build
Cumuluz Translate Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://fhir.cumuluz.org/OperationDefinition/bgz-transform | Version: 0.1.0 | |||
| Draft as of 2026-07-11 | Computable Name: Stu3R4Transform | |||
System-level operation for translating a supported Dutch STU3 source resource or bundle into a supported R4 target profile.
Url: [base]/$transform
| Gebruik | Naam | Scope | Kardinaliteit | Type | Binding | Documentatie |
| IN | source | 1..1 | Resource | The STU3 source resource or STU3 Bundle to translate. | ||
| IN | sourceProfile | 0..1 | canonical | Canonical URL of the supported STU3 source profile. Single-resource requests should provide it explicitly; bundle entries can carry their own source profile in meta.profile. | ||
| IN | targetProfile | 0..1 | canonical | Canonical URL of the supported R4 target profile. Single-resource requests should provide it explicitly; bundle entries can override it with the translation-target-profile extension on Bundle.entry.request. EPS document requests use bundle-eu-eps as the top-level targetProfile. | ||
| IN | validationMode | 0..1 | code | Validation behavior for the produced R4 output: enforce, report, or none. Defaults to enforce. | ||
| IN | returnLogical | 0..1 | boolean | When true, include the intermediate logical model as a Binary resource. | ||
| OUT | result | 1..1 | Resource | The translated R4 resource or Bundle. | ||
| OUT | targetProfile | 0..1 | canonical | Canonical URL of the target profile route used by the translation. | ||
| OUT | translationReport | 1..1 | Parameters | FHIR-shaped translation governance report with mapped, changed, added, and deleted value groups. | ||
| OUT | logical | 0..1 | Binary | The intermediate logical model serialized as FHIR JSON. | ||
| OUT | outcome | 0..1 | OperationOutcome | Validation output for enforce and report modes. |