QL Property Components — Data Model & Screen Reference¶
Relevant to: the Component Replacement Request (CRR) form, which reads component data from QLPrtyCm_Components.
What Are Property Components?¶
Property components in QL Housing are records attached to specific properties that represent physical parts (e.g. central heating, tiled roof, windows). They are used for: - Planned maintenance scheduling and costing - Rent point calculation - Condition surveys and maintenance history - Component replacement workflows (the CRR form)
Screen: QL Housing → Maintenance → HGM General Module → HGM Property Maintenance → Prop Comps
Component Fields (Main Info Tab)¶
| Field | Description |
|---|---|
| Comp Ref | Component reference — look up via ... search (the component library) |
| Location | Physical location of the component on the property. Important: when updating a component via a SOR item, the location on the SOR item must match exactly, otherwise a NEW component is added instead of updating the existing one |
| Condition | Condition code for the component |
| Failure Effect | Code describing the effect if this component fails |
| Last Survey Date | Date of last survey. Not linked to the cycle's "Last Date" — these are independent |
| Installation Date | Date the component was installed. When set, QL offers to auto-update the cycle dates |
| Quantity | Must be ≥ 1 for the component to be "Live". Set to 0 when removing a component |
| Sub Component | Tick to attach sub-components (e.g. a pump as a sub-component of a boiler) |
| Unit of Measure | Unit of measure for the component |
| Surveyor | Name of person who undertook the survey |
| DHS Code | Decent Homes / SSHQ / WHQS failure code (PASS/FAIL) |
| Other Codes 1–4 | Spare free-text codes |
Cycle Dates¶
Each component can have maintenance cycles attached (e.g. replace, inspect). Cycle dates (Last Date, Next Date, planned dates, lifespan) are set on the cycle, not on the main component record. Double-click a cycle line to edit it.
More Info Tab¶
Contains additional free-text fields for supplementary information. The Extra Asbestos Info tab is used only for asbestos components.
Component History and Actions¶
From the Property Components Maintenance screen, additional buttons allow:
| Button | Function |
|---|---|
| Photo/Plan/Doc | Add/update/delete photos, plans, or documents for the component |
| History | View the maintenance history of the component |
| Add / Edit (cycle section) | Add or edit maintenance cycles (replacement, inspection, etc.) |
| Notes | Free-text notes (check the Notes box) |
Hiding Historical Components¶
By default, removed components (Quantity = 0) are hidden. Uncheck Hide Historical Components to show them in the grid.
Copying Components¶
Use the Copy Property Components function to copy a set of components from one property to another. Useful for bulk-setup when properties share the same component profile.
Sub-Components¶
A sub-component is a child record attached to a parent component. Sub-components do not get updated when the main component is updated via a SOR item completion — they must be updated separately.
Relevance to the CRR Form¶
The Component Replacement Request form uses the QL data group QLPrtyCm_Components to populate a grid of components for the selected property. Key fields read from this group:
- Component reference and description
- Installation date (InstallDate)
- Lifecycle / lifespan fields
- Last and next planned dates
- Cost (added in v80 as QLPrtyCy_cost)
When a user selects a row in the grid, these field values auto-populate the form items. The "Other" mode allows manual entry when the component is not in QL.
See also: forms/component-replacement-request.md for the full CRR form implementation detail.