[djkene70]

Documentation only, no behaviour change. Follows up on OpenIntegrationEngine/engine#417, where @tonygermano pointed out that ${maps.get('key')} already reads a dotted key and asked for the documentation rather than a code change, once the wiki move had landed. It has, so here it is.

What it adds

A Keys that contain dots section to docs/engine/velocity_variable_replacement.md:

• a . inside ${...} is Velocity property navigation, so ${db.warehouse.url} looks for an object db, not a key of that name;
• use ${maps.get('db.warehouse.url')};
• the caveat that goes with maps.get — it reads the first loaded map, so it returns the lowest-priority match;
• the failure mode, because it is what a reader will be searching for: an unresolved reference stays in the field as literal text, so the error reads No suitable driver found for ${db.warehouse.url} and points at the connector rather than at the key.

It also links the ${maps.get('key')} row of the utility variable table to the new section.

Notes

• No new file, so .vitepress/config.mts needs no change.
• I did not add the log warning that was the other half of #417. That idea is dropped — it would be noise for anyone passing ${...} through on purpose.

🤖 Generated with Claude Code

[djkene70]

Reopening to re-run the ECA check; the Eclipse account is now signed and linked.

[tonygermano]

I appreciate you following up here with the documentation improvement. I left an inline comment I'd like you to verify before we merge.

This is non-blocking, but you could also mention that using underscores (db_warehouse_url) or camel case (dbWarehouseUrl) can help avoid this problem.