Projection Mapper Block
Embed a projection mapper view showing how model entities transform to target representations. Readers can trace field lineage from source through transformation to target.
Projection mapper blocks embed transformation visualisations directly into your documentation pages. Each mapper shows source entities on the left and target entities on the right, with connector lines tracing how individual fields map from source to target. Readers can follow the lineage of any field through the transformation, seeing exactly where each target property originates and what changes were applied.
When to Use
Block Properties
| Property | Required | Description |
|---|---|---|
| Projection Path | Yes | Path to the projection whose mapper view should be displayed |
| Title | No | Optional title displayed above the mapper |
Mapper Layout
Interactive Features
| Feature | Description |
|---|---|
| Hover Highlighting | Hovering over a source or target property highlights its connector line and the linked property on the opposite side |
| Property Detail | Clicking a property shows its full configuration including type, constraints, and transformation rules |
| Override Indicators | Properties that override inherited values from the source show a visual indicator distinguishing them from pass-through mappings |
| Theme Adaptation | Connector lines and entity panels adapt to the active dark or light theme |
Projection Mapper vs Data View Block
| Capability | Projection Mapper Block | Data View Block |
|---|---|---|
| Focus | Source-to-target field transformation | Entity structure and relationships |
| Layout | Left-right with connector lines | Graph layout with entity nodes |
| Field Lineage | Full source-to-target tracing | Not shown |
| Best For | Understanding how data transforms | Exploring entity structures |