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
The target profile is part of the translation request. Together with sourceProfile, it selects the exact registered route and therefore the translation direction.
The service does not translate "Patient to Patient". It translates a registered source profile to a registered target profile, for example:
BgZ-Patient -> nl-core-PatientBgZ-Patient -> patient-eu-coreBgZ-Patient -> patient-eu-epsBgZ-Patient -> xib-PatientACP-Patient -> ACP-Patient in PZP 2020patient-eu-eps -> BgZ-Patientnl-core-Patient -> patient-eu-coreDifferent target families have different profile rules, extensions, slicing, and terminology expectations.
| Family | Meaning | Examples |
|---|---|---|
nl-core |
Dutch R4 output based on installed nl-core 2020 profiles |
nl-core-Patient, nl-core-Problem, nl-core-Procedure-event |
eu-base |
European R4 base/core profile output | patient-eu-core, condition-eu-core, procedure-eu-core |
| EPS | European Patient Summary resource profiles or document Bundle | patient-eu-eps, condition-obl-eu-eps, bundle-eu-eps |
| PZP 2020 ACP | Matching R4 ACP target for PZP 2017 ACP input | ACP-Patient, ACP-AdvanceDirective, ACP-TreatmentDirective |
| XIB | Local draft R4 profile family generated by this project; accepted as source only through explicit xib-to-logical maps |
xib-Patient, xib-Problem, xib-AdvanceDirective |
| base R4 | Plain R4 target when no implemented family profile exists | Appointment, MedicationDispense, Provenance |
| Choose | When |
|---|---|
nl-core |
the receiver expects Dutch-profile-first output |
eu-base |
the receiver expects European base/core output |
| EPS resource profile | the receiver expects a Patient Summary resource profile |
| EPS document Bundle | the receiver expects a Patient Summary document |
| PZP 2020 ACP | the source is a supported PZP ACP profile and the receiver expects the matching ACP target |
| XIB | the receiver expects the local draft XIB target family while preserving the supported logical-model data points |
| base R4 | the route exists but there is no implemented profile-family target |
After choosing the family, check Translation Matrix. The exact pair must be listed.
| Source family | Typical targets |
|---|---|
| BgZ package-local profiles | nl-core, eu-base, EPS, XIB, or base R4 depending on concept |
| BgZ exchange dependent Dutch STU3 profiles | nl-core, eu-base, EPS, XIB, or base R4 depending on concept |
| PZP 2017 ACP profiles | matching PZP 2020 ACP, supported generic parent targets, selected EU Base targets, selected EPS targets, and XIB |
| PZP 2020 ACP R4 profiles | XIB, matching PZP 2020 ACP, supported generic parent targets, selected EU Base targets, and selected EPS targets |
| R4 source profiles | Dutch STU3 targets for reverse routes, or supported R4 target families for R4-to-R4 routes |
| PZP ACP QuestionnaireResponses | extracted PZP 2020 resources in an R4 Bundle |
ACP-Procedure can target nl-core-Procedure-event, but not EU Base or EPS Procedure in the current public route index because those targets require performed timing and the PZP Procedure profiles keep it optional.xib-to-logical maps and registry routes exist.Validation uses the same target profile selected for translation.
That means:
nl-core output is validated against the requested nl-core profileeu-base output is validated against the requested EU profilenl-core or PZP; supported NL/PZP data points outside the selected parent are explicit XIB slices or local XIB extension definitions.