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

Structure Maps

Structure Maps

Purpose

StructureMaps are the visible mapping rules for the translator.

They are used for:

• source profile to logical model mapping
• R4 source profile to logical model mapping for explicit reverse routes
• logical model to R4 target profile mapping
• logical model to STU3 target profile mapping for explicit reverse routes
• QuestionnaireResponse normalization and extraction decisions
• shared datatype and whole-resource copy groups

Directory Guide

Directory	Contents
src/main/resources/mappings/structuremaps/bgz2017-to-logical	BgZ package-local source maps
src/main/resources/mappings/structuremaps/zib2017-to-logical	dependent Dutch STU3 zib source maps
src/main/resources/mappings/structuremaps/nlcore2017-to-logical	dependent Dutch STU3 nl-core source maps
src/main/resources/mappings/structuremaps/pzp2017-to-logical	PZP 2017 ACP source maps
src/main/resources/mappings/structuremaps/eafspraak2017-to-logical	appointment source map
src/main/resources/mappings/structuremaps/nlcore-to-logical	R4 nl-core reverse source maps
src/main/resources/mappings/structuremaps/r4-to-logical	base R4 and EU Base reverse source maps
src/main/resources/mappings/structuremaps/logical-to-nlcore	nl-core target maps
src/main/resources/mappings/structuremaps/logical-to-eubase	EU Base target maps
src/main/resources/mappings/structuremaps/logical-to-eps	EPS target maps
src/main/resources/mappings/structuremaps/logical-to-pzp	PZP 2020 target maps
src/main/resources/mappings/structuremaps/logical-to-r4	base R4 target maps
src/main/resources/mappings/structuremaps/logical-to-bgz2017	logical model to registered Dutch STU3 reverse target maps
src/main/resources/mappings/structuremaps/pzp-questionnaire	QuestionnaireResponse extraction maps
src/main/resources/mappings/structuremaps/shared	reusable copy groups

How To Review A Route

1. Find the exact source and target pair in Translation Matrix.
2. Open the source-to-logical map for the source family.
3. Open the logical model for the route concept.
4. Open the logical-to-target map for the requested target family.
5. Check Concept Translation for code translations used by the route.

For reverse routes, read the selected R4-to-logical source map and then the logical-to-BgZ/STU3 target map. Forward maps are not executed backwards.

Boundary

The .map files use FHIR StructureMap syntax and are parsed by HAPI, but the service executes them with its local deterministic StructureMap runtime.

Read them as the mapping assets for this translator. Running them unchanged in another engine may require equivalent logical models, ConceptMaps, source parser context, and target materialization behavior.