bisUnitsPolicy

bisUnitsPolicy: "preferSchema" | "preferBundled"

Controls which provider is consulted first and wins ties.

  • "preferSchema" (default): primary is authoritative; bundled BIS units are fallback.
  • "preferBundled": bundled BIS units win; primary is consulted only for units not in the bundled set. Use when the iModel's schema may be stale.

Affects findUnit, findUnitByName, and getConversion (first-consulted wins or falls through). getUnitsByFamily always merges both providers — the first-consulted provider wins name collisions.

Has no effect when primary is omitted — the returned provider is a plain BasicUnitsProvider.

Defined in

Last Updated: 01 May, 2026