Skip to content

Work on a job: documents, photos and notes

Use the job's tabs and Overview quick adds to read records, add photos, post progress and follow the work safely on site.

For crewLast reviewed
On this pageRead the job header

Open a job to see its records and actions. Owners, admins, dispatchers and office staff land on Edit when the job is still open; see Edit a job from the Edit tab. Everyone else, and anyone opening a finished or archived job, lands on Overview, where you can see what needs attention, today's reports, progress, quick adds and a short job summary. Working jobs also have editable schedule and crew controls in Work.

Read the job header

The header keeps the job identity together: use All jobs to go back, then read the job number, status, priority, title, customer, site, dates and crew. A site is shown only when one exists. Due and Trade are in Job details, which also shows the job's Site: the label when it has one, with the address under it. If a job has no site yet, that card says No site yet. Under the site, Site contact shows the contact's name and phone number whenever one was entered on the job, for every role that can open the job. Select the number to call it; the row is left out when the job has neither. To add a site, see Set a site on the job.

The lifecycle is the single progress track below the identity. Completed steps are solid, the current step includes its percentage when available, and future steps are muted. Work, Safety and Files show counts when records are present. In Job details, Customer PO appears only when the owner or an admin has recorded a customer purchase order for the job. If there is no customer PO data, the row is omitted.

On a working job, the bottom of the Overview main column can show Nothing yet with + Variation, + Purchase order, + Material used and + Form. Only actions available to your role and this job appear. Assigned crew can use + Material used to request materials and add receipts; the owner and admins can use + Purchase order for the customer's paperwork. Finished or archived jobs do not show this row.

Set a site on the job

A job's site is where the work happens, and it has to be one of the job's customer's sites. Owners, admins, dispatchers and office staff can set it. Techs, contractors and site supervisors can see the site but cannot change it.

  1. In Job details, select Set site. If the job already has a site, the link reads Change site instead.
  2. Pick one of the customer's sites. Each shows its label, when it has one, and its address.
  3. Select Save site.

To clear the site, select Change site, then Remove site.

If the site you need is not in the list, select Add a new site, enter its Site label (optional) and Address, and select Add site. ONYX1 adds the site to the customer and sets it on this job in one step. Select Cancel to go back to the list without adding it.

A finished job (Completed, Ready to invoice or Invoiced) or an archived job keeps the site it has, and the site controls do not show. Reopen a finished job first (see Reopen a finished job). Only an owner or admin can restore an archived job.

If you move a job to another customer in Edit details, type part of the name into Search customers or scroll the full customer list, then choose the new customer. ONYX1 clears the job's site, because the old site belongs to the previous customer. Select Set site afterwards to choose one of the new customer's sites. Adding a site to a customer does not put it on that customer's existing jobs.

Find the record you need

Use the job tabs to keep each kind of information together:

  • Overview shows needs-attention items, today's reports, progress and the job summary.
  • Work shows the schedule and crew summary, scope, phases, photos, progress notes, site notes, variations, materials, purchase orders, parts and customer sign-off.
  • Safety shows safety documents, approval status, forms, incidents and report recipients when your role allows them.
  • Money shows quotes, invoices, purchases, costs and expenses for business roles. Field roles do not see this tab.
  • Files collects job documents and report PDFs.
  • History shows the activity record for business roles.

Records are shown as rows or cards once they exist. An empty section is one line with an Add action on a working job. Select it to open a side panel on a computer or a bottom sheet in the app. Android uses a Material bottom sheet with a handle; iPhone keeps the iOS sheet treatment. Nothing is lost by leaving a sheet unfinished.

Edit the schedule and crew

The Schedule and crew card keeps the current booking and assigned people together. It shows the booked dates, start time, projected start when one exists, each person's work window and the team leader.

  1. On a working job, select Edit schedule to change the start date, start time or optional end date. Select Clear to remove the booked dates. A projected start can be saved or cleared in the same sheet while the job is not booked.
  2. Select Edit crew to search the field crew and tick the people assigned to the job. Select Show office staff when an office person also needs to be assigned.
  3. For each ticked person, set From and To when they are only working part of the job. Choose the Team leader, then select Save crew.

The existing safety, compliance and scheduling checks still apply when you save. A finished job is read-only: the card shows "This job is finished. Reopen it from More to make changes." and does not show these edit buttons.

To change the job title, customer, dates such as Due or Follow-up, or the customer sign-off rule, open Edit details. The sign-off rule is in that sheet under Customer sign-off before invoicing.

Safety documents and forms

Open Safety to read the job's SSSP, Rescue Plan and other PDFs. Select View or Download on a document. Adding, replacing or removing documents, and owner approval, are covered in Job safety documents and owner approval.

Safety forms are also under Safety. Select Fill in to open a form sheet, complete the fields and select Sign off. A saved form appears as a record, including who approved or signed it and when. A form field upload has its own error and retry control, separate from queued job photos.

Add a photo

  1. Open Work, then Photos, and select Add photo. On a phone, select + and then Photo.
  2. Choose Take photo or Choose from library. The library picker can add more than one photo.
  3. Add a Caption if you want one, then select Add photos. When the job's photos are shared with the customer, a line under the caption box says so: the customer sees the caption too.

ONYX1 prepares each photo before it uploads. If a photo cannot be prepared or a live upload is refused, the notice names it and gives the reason. Select Retry for a temporary upload failure, or use a smaller or supported copy for a permanent failure. With no signal, the photo stays on the device and queues through the normal upload path.

Only an owner or admin can remove a site photo. Select the ✕ on a photo to remove it without a confirmation step.

Share a job's photos with your customer

Whether a new job shares its photos starts from your company setting Share site photos with customers by default (see Security settings). It is off until an owner or admin turns it on.

To change it for one job, open Work, then Photos, and turn Share photos with the customer on or off. While it is on, a customer who has portal access to that job sees its site photos and each photo's caption. Form and report photos, receipts and signatures are never shared. A photo is marked unverified on upload only while Flag photos that carry no camera information is on, and a photo marked unverified is never shown to customers. Turn the switch off and the photos disappear from the customer's portal. The owner, admins, dispatchers and office staff can change it; nobody else sees the switch. A switch-off you make now is recorded, so a later company-wide apply leaves that job off.

Moving a job to a different customer turns sharing off. It does not reapply the company default as part of the move, so the new customer sees no photos until sharing is chosen after the move.

Post a progress update

  1. Open Work, then Progress, and select Add update. On a phone, select + and then Progress note.
  2. Write what you got done and add a % complete if you want one.
  3. Select Add update.

An empty update is refused with "Write a short update." A percentage outside 0 to 100 is refused with "% must be 0–100." Once posted, an update cannot be edited or removed. When the job has phases, their percentages set overall progress. Without phases, the latest update with a percentage sets it; an update without a percentage does not change the figure.

How the progress figure is worked out

A job has one progress figure. Overview shows it under Progress, and Work shows it as Overall, with the phases or above the progress notes. While the job is On site, the lifecycle shows it on that step too.

  • A job that is Completed, Ready to invoice or Invoiced always shows 100%, even when an earlier phase or update had a lower percentage.
  • Otherwise, if the job has phases, the figure is the average of their percentages, rounded to a whole number. A percentage on an update does not change it.
  • Otherwise, if the job has no phases, the figure is the percentage on the most recent update that has one. An update without a percentage leaves it as it was.
  • Otherwise there is no figure yet, and Overview shows None yet.

Customers who can see the job in the client portal see this figure unless the owner or an admin has turned off Show job progress to customers. The portal shows Updated with a date when one is available. For a job that is not done and has phases, the date is the latest time a phase percentage changed, so renaming or reordering a phase does not move it. If it has no phases, the date is the latest progress update with a percentage. A done job uses its completion date or, if there is none, its invoice date. If both are missing, the portal shows no Updated line. Customers never see the text of an update, the phase names or who posted an update.

Crew progress updates are written by people. ONYX1 Office cannot read or add them. Private job notes are a separate owner/admin-only record; Office notes in that record show the ONYX1 Office label and the role that wrote them, and staff cannot edit or remove those automated notes.

Site notes

A site note records something about the place that the next crew should know, such as where the water isolation valve is or which gate the ladders go through. A note belongs to the site, so other jobs at that site can show it to anyone allowed to read it. Customers never see site notes: they do not appear in the customer portal, in customer emails or in reports.

Who can use them:

  • The owner, admins, dispatchers, office staff and site supervisors can read notes on any job and add them to any job that is not archived.
  • Technicians and contractors can read a note that was written on a job they are assigned to. They can also read every note at a site while they are assigned to an active job there. An active job is one that is not archived and not Completed, Ready to invoice or Invoiced. When a technician or contractor has only finished or archived jobs at a site, they see only the notes written on those jobs.
  • Technicians and contractors can add a note to a job they are assigned to, without clocking in.

Add a note

  1. Open the job, select Work, find Site notes and select Add note. On a phone, you can also select + and then Site note.
  2. Write the note in the Site note box. Keep it to the place and the work, not personal details about people.
  3. Select Add note to save. After a successful save, the box clears and the sheet closes.

A note can be up to 2000 characters. The count under the box turns amber at 2000 and red above it, and a longer note is refused with "Site notes must be 2000 characters or fewer." You can add up to 60 notes an hour; after that ONYX1 shows "You have added a lot of notes in the last hour. Try again later."

The note appears at the top of the list with your name and the New Zealand date and time. Site notes need a connection. If saving fails, ONYX1 shows "Could not save the note. Check your connection and try again." and keeps what you typed, so select Add note again when you are back online.

When ONYX1 Office adds a site note, it appears with the ONYX1 Office label and the role that wrote it. People who can read the site's notes can read it, but staff cannot edit or remove automated notes.

A job lists its latest 100 site notes. When there are more, the list starts with "Showing the latest 100 site notes" and the older ones are not listed.

How notes follow the site

  • A note stays with the site of the job where it was written. Another job at that site, earlier or later, shows it to people who can read it, with a line such as "From JOB-0001 Harbour wash preparation".
  • Notes follow the site record, not the address text. A different site with the same address does not share them.
  • A note takes the job's site at the moment it is written. If the job has no site then, the note stays on that job, even if you set a site afterwards.
  • If you change a job's site, the job keeps the notes written on it and starts showing the notes of its new site. Notes written at the old site stay with that site.

Edit or remove a note

  • Select the three-dot menu beside your own note, then Edit or Remove. After you change the text, select Save changes. The note then shows "edited".
  • Remove takes effect straight away. ONYX1 does not ask you to confirm, and a removed note does not come back.
  • Only the owner, admins and office staff can remove someone else's note. Nobody can edit another person's note.
  • You can edit or remove your own note only while you can still read it. If you are taken off the job and have no active job at that site, the note disappears from your view. A page that is still open refuses the change with "That note is not available." The owner, admins and office staff can still remove it.

Finished and archived jobs

A finished job (Completed, Ready to invoice or Invoiced) still takes site notes. On a phone, + on a finished job offers only Site note.

An archived job does not take new notes: Add note is not shown, and a note that was being written when the job was archived is refused with "This job is archived and read-only." You cannot edit a note whose original job is archived. You can still remove a note you are allowed to remove while you can read it.

Move a phase along

If the job has named phases, open Work and update a phase's percentage. It saves as soon as you release the control. Adding, renaming, reordering or removing a phase is for your manager.

Start today's reports

On a working job, select + Start a report on Overview to see each report's status for today. Choose Start report for a new report or Continue report for a draft. The report opens in a sheet, and your answers save as a draft as you work.

On a phone, the same list is under +. It also includes Expense or receipt, Form, Incident or near miss and Safety check. Each action opens its existing workflow and keeps the same clock-in and offline rules. In Work, Materials & receipts is for crew requests and receipts for materials. In Money, Add expense is for recording a cost against the job.

Finished jobs do not show report-start actions, but their existing reports, PDFs and history stay available. A report that is already waiting for approval can still be approved or sent back by a user who has that permission.

Clock in and out

Use Clock in or Clock out in the job header on a computer, or the bottom bar in the app. Finished jobs cannot be clocked into until the office reopens them. The clock-in gate and location handling are unchanged. See Clock in and out for breaks, long shifts and required safety forms.

Once a job is Completed, Ready to invoice or Invoiced, there is no more field work to log against it: Clock in and Add photo no longer appear in the header.

Reopen a finished job

The owner, admin, dispatcher, office or site supervisor can open More and select Reopen job on a completed or ready-to-invoice job. ONYX1 shows a confirmation before it changes the job, and reopening clears its finished status and returns it to On site, so the schedule and crew can be changed again.

An invoiced job can only be reopened once its invoice has already been voided, and only the owner, admin, dispatcher or office can do it (not a site supervisor). Once the invoice is void, More shows Reopen to Ready to invoice instead; confirming it returns the job to Ready to invoice, which needs invoicing again.