handle Ord

A handle Ord is a unique reference to a component that persists throughout the lifecycle of the component in a station.

A BOrd property is often used to reference a component in the station. It may use the slot path Ord, for example, something like station:|slot:/Home/Schedules/FirstFloorWeekly. When you add a component to the station, the framework assigns a unique handle Ord, a shorthand reference, which might be something like h:c24. You can rename the component, move the component to another location, or rename a parent and the handle Ord remains the same even though the slot path Ord changes.

Consider these weekly schedules with components nested under folders in a location called Home > Schedules. A bql query (bql:select slotPath, handleOrd from schedule:WeeklySchedule) displays the current slot path Ord and handle Ord for each weekly schedule component.

Figure 1. Slot Path and Handle Ord


If you rename the parent folder from Schedules to WeeklySchedules, the slot path Ords change for each of the weekly schedule components, but the handle Ords remain the same.