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-09-23 | 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. Bundle sources cannot be combined with returnLogical. | ||
| 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. A supplied |version must exactly match an installed StructureDefinition.version. | ||
| 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. A supplied |version must exactly match an installed StructureDefinition.version. | ||
| IN | validationMode | 0..1 | code | Validation behavior for the produced R4 output: enforce, report, or none. Defaults to enforce. | ||
| IN | returnLogical | 0..1 | boolean | Only valid for a single resource source; Bundle sources are rejected when returnLogical is true. | ||
| 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 | Direction-specific R4 Parameters report with exact route/version, manifest/artifact identity, stage evidence, conformance mode, applicable loss decisions/use contexts, and mapped/changed/added/deleted values. | ||
| 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. |