FH05 — Reference into a scalar without getReferenceKey()

Group: Selector (schema-driven) · Severity: warning · Needs: lint --package

A scalar column’s selector lands on a Reference element directly. A Reference is a complex element; to get a stable, joinable value the SQL on FHIR v2 spec provides getReferenceKey().

Example

Patient.managingOrganization is a Reference; this triggers FH05:

{
  "resource": "Patient",
  "select": [{ "column": [{ "name": "org", "path": "managingOrganization" }] }]
}

warning [FH05] (org): selects a Reference element directly; use getReferenceKey()
to extract a stable key, or navigate to a primitive such as .reference

Fix

Use managingOrganization.getReferenceKey() for a stable key (optionally typed, e.g. getReferenceKey(Organization)), or navigate to a primitive such as managingOrganization.reference.