Choose which emails an inbox processes and how duplicates, files and sites are handled
Rules holds the settings that apply to every work order an inbox reads, whatever the work order says. Everything is optional. One Save at the bottom saves the whole page, and the page says "Inbox rules saved."
Accepted emails
These two settings decide whether an inbox processes an email at all. They are checked before anything is parsed or metered.
Only process emails whose subject takes a choice and one or more texts. Type a text and press Enter to add it.
| Choice | What matches |
|---|---|
| Contains | Any of the texts appears in the subject. |
| Is exactly | The subject is one of the texts, once any "Fwd:", "Fw:" or "Re:" at the front is ignored. |
Capitals and extra spaces are ignored. With no text, every subject is accepted.
Only accept emails from takes email addresses, or a whole domain written like @example.com. With
none, anyone can send to the inbox. An address has to match in full. @example.com matches addresses
ending in @example.com and does not match @mail.example.com.
Also accept an email forwarded on from one of these addresses appears once an address is listed. When it is on, a sender shown inside a forwarded email counts too. Formpiece looks for "From:", "Sender:" and "Reply-To:" lines in the body, and inside an email attached whole. When it is off, the email has to come directly from a listed address.
An email that fails either check is kept as a record on the Dashboard with the reason as its status, for example "Skipped: the email is not from an address the inbox accepts. It is from someone@example.com." Nothing is created. The subject is checked before the sender.
Existing jobs
Tick Check existing jobs for Order Number / Customer? (Simpro) or Check for an existing job? (Fergus) to look for a job the work order already made.
For Simpro, the check looks for a job with the same order number for the inbox's default customer. A parser that makes quotes looks for a quote. A work order with no order number never finds one, and a new job is made.
For Fergus, A job already exists when it has the same has three ticks: Order number (the job's customer reference), Customer and Site. Every tick has to match. The customer is the one from Fergus Defaults or a condition. A site Fergus does not have yet matches no job.
- Nothing ticked means no job is treated as existing.
- Order number needs the work order to have one.
- With Order number unticked, any job for that customer or site matches, so tick Site as well as Customer.
Then choose what to do under When a job with the same Order Number is found (Simpro) or When an existing job is found (Fergus):
| Action | What it does |
|---|---|
| Create a new job | Makes a new job anyway. For a Fergus quote parser it reads Create a new job with a quote. |
| Update the existing job | Changes the existing job. |
| Add a quote variation to the existing job | Fergus quote parsers only. Makes a variation under the existing job, with a draft quote. |
| Add a new phase to the existing job | Fergus job parsers only. Adds a phase for this work order and leaves the job as it is. |
| Keep the existing job and add the files to it | The default. Adds the attachments the settings below ask for and changes nothing else. |
| Ignore the work order (Simpro) or Skip the work order (Fergus) | Nothing is made or changed, no files are added and no Workflow Tools sequences start. |
Update the existing job on Simpro sends the same values a new job gets, apart from the job type. The inbox's default status, stage, tags, salesperson and manager overwrite what is on the existing job. On Fergus it changes the job's title, description and site, and adds the job note.
On Fergus, Add a new phase to the existing job? appears with the update action, and Phase title appears with either phase option. Blank uses the job title.
Addresses listed under When a duplicate job is found, below, are emailed whichever action is chosen, ignore included.
Attachments
| Setting | What it does |
|---|---|
| Include email as attachment? | Adds the whole email to the job as workorder.eml. |
| Add all email attachments to job? (project on Simpro) | Adds every attachment that is not a PDF. The PDF the parser read is attached anyway. |
| Make attachments public? | Simpro only. Marks the attachments public in Simpro. |
A Fergus attachment over 20 MB is not attached, and "... is larger than the 20 MB Fergus accepts, so it was not attached." is recorded on the Dashboard record.
Sites and contacts
| Setting | What it does |
|---|---|
| Make site contact the primary site contact. (main contact on the site on Fergus) | Marks the work order's site contact as the primary contact of the site. On an existing Simpro site, the contact is updated to primary. |
| Transform new site names to uppercase. | Applies to a site the import creates. |
| Transform new site addresses to uppercase. | Applies to the address of a site the import creates. |
The Site address format below them decides how the address is written. See Locations.
Dates
Simpro inboxes only.
Generate Date Issued date from when email is received (new jobs only). When the work order has no date issued, a new job or quote gets the day the import ran.
Generate Due Date from Response Time (a response time must be mapped). Adds the response time's days to the Date Issued, or to the day of the import when there is none, and replaces any due date the parser read. It applies to jobs. The response time has to come from Response Times, because one set by a condition is applied after the due date is worked out.
Notification emails
Type an address and press Enter. Text that isn't an email address is not added, and the page doesn't say so.
| Setting | When it is sent |
|---|---|
| When a work order was not processed | Something was refused while the import wrote to Simpro or Fergus, such as the job, a site, a contact or a file, or a parser's guard rules skipped the work order. |
| Attach the original PDF (or email) | Sends the original with the not processed email. The label follows the parser's type. |
| When a new site is created | A new site was made. It gives the site's name, address and ID. |
| When a duplicate job is found | Appears once the check is on. A matching job was found, whatever the action. |
The not processed email doesn't go out when the import stops before it writes anything, for example when the inbox has no default customer. That failure is on the Dashboard record.
What a Fergus enquiry uses
A Fergus parser that makes enquiries uses only Accepted emails, the Attachments settings, Transform new site addresses to uppercase, the Site address format and When a work order was not processed. An enquiry has no site, job or phase, so the rest of the page does nothing for it.
When it goes wrong
Emails from the right sender are skipped
An address has to match in full, and a domain entry has to start with @. An email forwarded from a
colleague needs Also accept an email forwarded on from one of these addresses. The Dashboard
record names the address the email came from.
The duplicate check made a second job anyway
On Simpro, the work order had no order number. On Fergus, a ticked match had no value on the work order, or Create a new job is the chosen action.
Files were not added to an existing job
The action has to be Keep the existing job and add the files to it, Update the existing job or a phase option. Include email as attachment? or Add all email attachments to job? has to be ticked for anything beyond the work order PDF.