Create a document parser and choose what it reads and where it imports to
Properties is the first page of a parser, and the only page a new parser has. It sets the name, what the parser reads, which system it writes to and what it creates there. Once you click Save, the document type, the platform and the object are fixed for the life of the parser. The rule pages appear in the left menu at the same moment.
Before you start
Creating a parser needs a subscription. Without one the Create Document Parser button on the Document Parsers page is greyed out and the page says "A subscription is required before you manage document parsers."
Step by step
- Open Parse in the Work Order Import menu and click Create Document Parser.
- Type a Parser Name. The label asks for at least 5 characters, and the field is required.
- Under Document type, choose PDF or Email.
- Under Imports to, choose Simpro or Fergus.
- Under Simpro object or Fergus object, choose what the parser creates.
- Click Save.
After the first save the page address changes to the parser's own, and PDF Parser or Email Parser, Field filters, Field mapping and Templates appear in the left menu. A Fergus parser also gets Destination fields.
| Setting | What it does | After saving |
|---|---|---|
| Parser Name | The name you pick the parser by in an inbox and on the parser list. | Can be edited. |
| Document type | PDF reads the PDFs attached to an email, one work order per PDF. Email reads the body of the email. | Locked. |
| Imports to | Simpro or Fergus. | Locked. |
| Simpro object or Fergus object | What the import creates. See below. | Locked. |
Changing Imports to on a new parser puts the object back to Jobs, because the two systems offer different objects.
What each object creates
| Platform | Choice | Creates |
|---|---|---|
| Simpro | Jobs | A job. |
| Simpro | Quotes | A quote. |
| Fergus | Jobs - a Fergus job, of the job type set in the inbox | A Fergus job, of the job type set on the inbox's Fergus Defaults. |
| Fergus | Quotes - a Quote job in Fergus with a draft quote on it | A Fergus job of type Quote, with a draft quote on it holding one section called Work order. |
| Fergus | Enquiries - a Fergus enquiry, made without a customer or site | A Fergus enquiry. It holds a name, an email, a phone number, a description and an address, so most of what a parser reads is left out. |
An inbox and a parser have to be for the same platform. An inbox only offers parsers of its own platform.
How it maps to Fergus
A Fergus job takes a title, a description, a customer reference, a customer and a site, so a Fergus parser can only use what those hold. The values a parser reads are hidden from the field pickers on a Fergus parser when Fergus has nowhere to put them. Destination fields lists every one.
When it goes wrong
The platform, type or object can't be changed
They are locked once the parser is saved, and the radio buttons are greyed out. Create a new parser with the right choices. Document parsers covers exporting and importing the rules of an existing one.
A Fergus enquiry is missing the site
An enquiry is made without a customer or a site, whatever the parser reads. Choose Jobs if the work order needs a site on it.
Site details not mapped
A parser that has no site name and no site address rule shows Site details not mapped beside its name. A PDF parser needs a rule for one of them. An email parser needs a text rule for one of them or a link to a PDF parser that has a site address. See PDF parser rules and Email parser rules.
Save says "Could not save document parser. Please try again."
The save to your account failed. Nothing was written. Check that you are still signed in and try again.