Fergus Booking Forms

Let customers attach files to a Fergus booking

4 min read Fergus booking form

Attachments lets the customer add files to the booking. Once the job exists in Fergus, Formpiece sends each file to the Fergus record you choose.

Before you start

  • Attachments are a Business feature. On the Free plan the page says "Files and attachments is part of the Business plan.", every control is disabled, and the form does not ask for files. Your settings are kept and used when you upgrade.

Step by step

  1. Open your form from Forms. On the Settings tab, open Attachments under Form display.
  2. Switch on Allow attachments.
  3. Set Attachment field label if you want something other than "Attachments".
  4. Set Minimum Qty - set to zero for optional attachments and Maximum Qty. The defaults are 0 and 3.
  5. Set Maximum file size (MB) - Fergus accepts files up to 20 MB.
  6. Under Attach the files to, pick The job, The job phase, The site or The customer.
  7. To ask for files on some services only, pick them under Services for displaying attachments - leaving blank will request attachments for all services.
  8. Click Save.

The job phase is only offered while the form creates a phase on each job, switched on under Booking Job Type. If the form has no phase, files for the phase go on the job.

Save stays off with "The maximum quantity has to be at least one and no less than the minimum, and the file size has to be between 1 and 20 MB." until the numbers fit those rules.

The page has no setting for file types.

How the files get to Fergus

The files do not travel with the booking. When the customer sends it, the form is given a place to upload each file, and the customer's browser uploads them straight there. Formpiece makes the booking in Fergus first. Once the job exists, a separate step sends each file to Fergus against the record you chose. A file that arrives before the job exists waits for it.

The Files column on the form's Bookings tab shows "1 of 3 sent" while files are on their way. The booking page lists each file with its size and status.

Fergus refuses a file over 20 MB. Formpiece enforces the smaller of your limit and 20 MB when the booking arrives, and refuses the booking with "Please check the attachments." if the count or size is out.

An auth link booking asks for no files, because its job already exists in Fergus.

When it goes wrong

The customer sees "Your booking was made, but 1 file could not be uploaded"

The booking is saved and in Fergus. The file did not upload from the customer's browser, so Formpiece has nothing to send. The message ends "Please send it to us another way." With several files it reads "2 files could not be uploaded. Please send them to us another way."

The booking shows "Sent, files not sent"

The job was made but Fergus refused a file, or something failed on the way. The reason is on the booking row, such as "The file is larger than the 20 MB Fergus accepts." Fix the cause and click Send again on the row. Only the files that did not arrive are sent again, and the job is not created twice.

The booking shows "Sent, files stopped" or "Sent, files not received"

  • Sent, files stopped: a file was sending for more than ten minutes, which means the step that was sending it died. Send again sends it again.
  • Sent, files not received: a file was never picked up an hour after the booking. If the customer's browser never finished uploading it, there is nothing to send and Send again does nothing.

The booking is refused with "Please check the attachments."

The number of files is below the minimum or above the maximum, or a file is over the size limit.

FAQ

Do the file names appear in the Fergus job?

Only if you want them to. Tick Attachments under a destination on Notes to write the file names into the job description, a job note or the calendar event.