Read the Dashboard to see what each emailed work order became
The Dashboard has three panes. Inbox folders sit on the left, the list of records received sits in the middle, and the record you pick opens on the right. Every email that reaches an inbox gets a record, whether it was imported, skipped or failed.
Before you start
The Dashboard shows nothing until the account has a Work Order Import subscription and a credential:
- "A subscription is required before you can use Work Order Import." with Manage subscription.
- "Connect your Simpro or Fergus integration before importing emails." with Open settings.
- "Inbox could not load" with Try again, when the page could not read your inboxes.
The three panes
Inbox folders. All inboxes shows every record. Each inbox below it is a folder, with the Simpro or Fergus icon for the platform it imports to. Click Refresh to check for new records. With no inboxes the pane says "No inboxes yet." and links to New inbox.
Record list. Records are newest first. Each shows the sender, the subject ("(no subject)" when there is none) and when it arrived: the time for today, the date for anything older. Under All inboxes a circle with the inbox's initials also shows. A record that failed or was skipped has an Error badge. Hover over it to read the messages. With no records the pane says "No records yet."
Message pane. The subject, sender, the address it was sent to and the time it arrived, then two tabs, Results and Email. Until you pick a record it says "Please select a message."
The Results tab
A record that is still being processed shows "Email still processing". While it is open, the Dashboard checks again every five seconds for up to five minutes. After that it stops, and you need to click Refresh.
If the whole email failed, the reason shows in a red box at the top. Below it there is one block per PDF for a PDF parser, or one block for an email parser. The block is headed with the PDF's name.
For a Simpro inbox the block holds:
- Simpro results: Simpro job and Simpro site, each with the ID and name and a badge. New means this email created it. Updated means it was already there. Duplicate ignored means the inbox is set to ignore a work order for a job that already exists, so nothing was made or changed.
- Extracted fields: everything the parser read, one line each.
- Integration errors: what Simpro refused, as its message followed by the field in brackets.
For a Fergus inbox the block holds:
- Fergus results: Fergus enquiry for an enquiry. For anything else Fergus job, Variation of job and Fergus job phase when they apply, Fergus draft quote when the parser creates quotes, Fergus customer and Fergus site.
- Extracted fields and Integration errors, as above.
- Not written to Fergus: values the parser read that Fergus has no field for. The table says "Fergus has no field for these values, so they were read but not saved." These are the date issued, due date and time, response time, site contact department and notes, cost centre totals, and any custom field.
A record with no blocks and no errors says "Nothing was created from this email."
A Simpro quote import has no job ID, so Simpro job shows a dash. The quote number isn't shown on this page. Open Simpro to find it.
The Email tab
The Email tab is there once the record has results. It shows the email as it was received, and a download button for each attachment, with its name and size. An email with no content says "Empty email."
When a record failed
You can't run a record again from the Dashboard. Read the message, fix its cause, then send the work order to the inbox again. The second email becomes a new record and counts towards Usage like any other.
If the first attempt got as far as making the job, the second can make another one. Turn on Check existing jobs for Order Number / Customer? (Simpro) or Check for an existing job? (Fergus) under Rules first. See Rules.
"Skipped: ..."
The inbox's subject or sender rules refused the email, or the parser's guard rules decided the PDF or email wasn't a work order. The message says which text or address didn't match. The record shows Error on the Dashboard, and Reports counts it as Skipped.
"No PDF Attachments in email"
A PDF parser only reads attachments that are PDFs. A PDF pasted into the body, or a different file type, isn't read.
"No fields were extracted from this PDF. Check the parser settings."
The parser ran and found nothing. The same message for an email says "from this email". Open the parser and test it against this work order.
"No Simpro credential has been chosen under Settings."
Choose one under Settings, Simpro Credentials. A Fergus inbox says "No Fergus credential has been chosen under Settings." A Simpro import also reports "Work Order Import has no settings. Open Settings and connect Simpro.", "The Simpro credential chosen under Settings was not found.", "Inbox not found." and "Document parser not found." the same way. A Fergus inbox whose parser imports to Simpro says "The inbox parser does not import to Fergus."
The record stays on "Email still processing"
Some Fergus failures that happen before the work order is read are only logged and are never written to the record. Check that the credential under Fergus Credentials works, and that the inbox's parser imports to Fergus, then send the work order again.