Available on Pro and Enterprise
A form you’ve built can reach a job in three ways: automatically for a work type, automatically for a job type, or by hand on one job when you need it. This guide covers all three, with the step-by-step for adding a form to a single job, what a field operative sees on the phone, and how to update a form on a job to its latest version.
You need a published form of your own first. See Create your own form.
Three ways a form reaches a job
| Way | What happens | Set it in |
|---|---|---|
| Work type | Every new job for that work type gets the form | The form’s Use on (New form) or Settings tab, under Work types |
| Job type | Every new job of that type gets the form, whatever the product | The form’s Use on (New form) or Settings tab, under Job types |
| By hand | Your office adds the form to the jobs that need it | Ad hoc (New form or the Settings tab), then Add a form on the job |
Installation types are now called work types: the same list, such as EV charger, Solar PV or Boiler service, under a new name.
The first two apply to jobs created from then on. installHUB’s own forms are attached by installHUB. You choose where your own forms are used.
Let your office add a form by hand
- Open Forms and open your form.
- Choose the Settings tab.
- Under Where this form is used, switch Ad hoc on. Your office can now add this form to any job, from the job page. The change saves as you make it.
- Publish the form if you haven’t yet. A form that hasn’t been published can’t be added to a job.
Add the form to a job
- Open the job from Jobs.
- On the Information tab, find the job’s forms and choose Add a form.
- Pick the form. The list shows your published forms that are set to Ad hoc. If the one you want isn’t there, switch on Show all my published forms.
- Choose Add form.
The form is added to this job only, at its published version. A later change to the form doesn’t alter the copy on this job. The job’s forms now list it, with an “Added by” line that names the colleague who added it.
The Add a form button shows for people who can edit the job. It doesn’t show on a job that another company owns and has shared with you. If the form is already on the job, installHUB tells you.
What a field operative sees on the phone
- The form arrives when the installHUB app next syncs. Opening the job also brings it in.
- It shows a New pill on the job, with “Added by” and your colleague’s name, so the field operative knows it wasn’t there before.
- The New pill clears once they open the form. The Added by line stays.
- Answers a field operative has already entered on the job aren’t touched when a form is added.
Update a job’s form to the latest version
A job keeps the version of each form it started with. When a newer version of a form is published, the job shows it next to the form’s version, with an update icon beside it.
- On the job, choose the update icon next to the form’s version (Update to version and the new number).
- The update dialog shows What changes: fields added, fields removed and fields whose options or type changed. It tells you whether any answers would be lost.
- For an answer that wouldn’t carry over, choose a field in the new version under Keep answer in, or leave it on Discard. Notes and photos on fields move with their answers.
- Choose Review update. Under When you update you see the answers kept, moved and discarded, any new required fields left empty, and the documents that are regenerated or removed.
- Choose Update form. The update can’t be undone. The job’s History records it, with who did it and how answers were kept.
The update icon can’t be used while a visit for the job is booked today, while a customer or contractor request on the form is open, or on a completed or archived job. Hover over it to see why.
Examples
A commissioning sign-off on some installs. Build a “Commissioning checklist” form and switch Ad hoc on. When a charger install needs a witnessed commissioning, your office opens the job, chooses Add a form and picks the checklist. The field operative sees it, marked New, on their next sync.
A risk assessment for every job of one type. Create “Site risk assessment” and set Job types to the type that needs it, such as heat pump installs. Every new job of that type carries it from creation, so nobody has to remember to add it.
An extra form for one customer. A customer asks for an extra declaration on their job only. Add the form to that job by hand, and no other job is affected.
