Electrical Certification Forms Suite¶
A brand-new suite of electrical compliance forms added to Versaa as of the 27/05/2026 export (all at v0 — newly created). These cover the full lifecycle of electrical compliance certification at LHP.
Forms in the Suite¶
| Form | Version | Purpose |
|---|---|---|
Electrical Cert AdHoc |
v0 | Ad-hoc electrical certificate for unplanned/non-scheduled work |
Electrical Cert Unscheduled |
v0 | Unscheduled electrical certificate |
Electrical Cert Search |
v0 | Property search/lookup entry point for all electrical cert work |
Electrical danger notification |
v0 | Notification form for electrical hazards/danger situations |
Electrical fire inspect report |
v0 | Fire detection system periodic inspection report |
Electrical fire install |
v0 | Fire system installation record |
Electrical lighting periodic |
v0 | Periodic emergency lighting inspection |
Electrical Edit DataList |
v0 | Backend support form — edit/maintain electrical reference data lists |
Electrical Edit Defaults Fire |
v0 | Edit default values for fire inspection reports |
Electrical Edit Defaults Light |
v0 | Edit default values for lighting inspections |
Electrical Edit Dft Light Inst |
v0 | Edit defaults for lighting installation |
Electrical Edit My Defaults |
v0 | User-specific defaults editor |
Electrical Edit User Defaults |
v0 | User defaults editor |
Electrical PV maint |
v0 | Photovoltaic (solar) system maintenance |
Electrical Part P |
v0 | Part P electrical compliance form |
Electrical reassign review |
v0 | Reassign/review form for electrical tasks |
Electrical smoke alarm maint |
v0 | Smoke alarm maintenance |
Electrical vent sys checklist |
v0 | Ventilation system checklist |
Workflow¶
| Workflow | Version | Purpose |
|---|---|---|
Electrical render documents |
v2 | Renders electrical compliance certificates as PDFs |
Form Details¶
Electrical Cert Search (entry point)¶
The search form is the recommended entry point. It:
- Accepts house number and street name inputs
- Fires a GetPropertyAddress message to populate property details
- Auto-populates address fields via GetSelectedItemValue formulas
- Routes the user to the appropriate certificate form based on work type
Electrical Cert AdHoc / Unscheduled¶
Both certificate forms share a similar structure:
- Property Id (mandatory) — QL property reference
- Address fields (populated from search or property lookup)
- CertificateSerialNumber — auto-generated from creation datetime in yyyyMMddHHmmss format if not already set
Formula pattern for CertificateSerialNumber:
$formItem.CertificateSerialNumber
? $formItem.CertificateSerialNumber
: new Date($formItem.Form_CreationDate).toISOString().replace(/[-:T]/g,'').slice(0,14)
Note: Formula IDs in any new electrical form XML must be 32 lowercase hex characters, no dashes. Other formats cause "Invalid Formula Element: invalid Id format" on import.
Electrical danger notification¶
- Order Number (from QL)
- IsSubTask option (Yes/No) — supports launch as a sub-task from another form; Resource Id conditional logic adjusts based on this
- Original comments (mandatory) — describe the hazard
- Rejection Reason — populated if not completing
Electrical fire inspect report¶
- Full property address (4 lines + postcode + telephone)
- Inspection Schedules group — mandatory checklist items
- Validation formula that counts failures; blocks submission if any schedule items fail
- Fires
RenderDocumentto generate PDF certificate - Tracks rendered filename as
EleFireInspect_<PropertyId>_
Electrical fire install¶
Similar structure to fire inspect report but for installation records. Includes:
- IsSubTask option for sub-task launch
- Client contact phone (mandatory)
- Address status branch
Electrical lighting periodic¶
Periodic inspection for emergency lighting: - Branch number field (default "000") - Full address + client address fields - Inspection schedule section with mandatory items
Electrical Edit DataList (utility form)¶
This is a backend support form — not end-user facing.
- tasksNotSubmittable="true" — no submission to DW
- Loads Ele*.list reference data files only (filtered)
- Three requests: RefDataSearch, RefDataLoad, RefDataSave
- Used to maintain inspection item codes, findings lists, and default values used by the certificate forms
Key Conventions in Electrical Forms¶
| Convention | Detail |
|---|---|
| All at v0 | Entirely new suite — no prior versions in Versaa |
| Category: Electrical | All forms tagged with Electrical category |
tasksNotSubmittable |
Edit forms set this to true (they don't create DW records) |
| Branch elements | Heavy use of <Branch> elements for conditional section display |
| Validation formulas | Fire and lighting forms include fail-count validation that blocks submission |
| Serial number generation | Cert forms auto-generate serial numbers from creation datetime |
Ele*.list filter |
Edit DataList uses a glob filter to restrict to electrical reference data |
Related¶
- forms/form-xml-conventions.md — formula IDs and XML conventions
- forms/calculated-fields.md — formula patterns
- forms/word-connector-templates.md — document rendering (used by Electrical render documents workflow)
- workflows/how-to-create-a-workflow.md — workflow structure