UTA PDF Parser - Configuration Instructions

From SmartWiki
Revision as of 14:46, 14 August 2013 by Arthur Lathrop (talk | contribs)

Jump to: navigation, search

Template:UnderConstruction

SmartSimple's UTA PDF Parser allows for fillable forms in PDF format to be downloaded from SmartSimple, completed offline and then re-uploaded to create records within SmartSimple.

The settings page for the UTA PDF Parser is accessed through the Global Settings page, under the Business & System Configuration section.
A walkthrough of the steps end users will take to utilize a fully-functional UTA PDF Parser are available at this page: UTA PDF Parser.
A video describing the PDF Parser functionality has also been prepared and is available here: UTA PDF Parser - Video

Detailed configuration instructions are as follows:

Create a UTA PDF Parser in Global Settings

To create a new type of UTA PDF Parser, go to the Global Settings page. Under the Business & System Configuration section, click on the hyperlink for UTA PDF Parser.
Click on the "New Parser" button at the top of the page.

UTAPDFParserEditPage.png

The settings on this New Parser page are as follows:

  • Prefix - The Prefix you set in this field serves to differentiate different types of UTA PDF Parsers. The file name of the PDF template used in conjunction with this parser must begin with the "prefix" you specify.
  • Active - The Active switch exists so that you can enable or disable UTA PDF Parsers. The default for new types of parser is "disabled" ("Active" is not selected).
  • Configuration - This section contains the XML code that maps the field names in the stored PDF document to the fields for the SmartSimple record to be created.
  • Error - This non-editable section contains a timestamped log of all files uploaded to the system using the UTA PDF Parser. This section can be cleared by clicking the "Clear Error" button at the bottom of the page.

Enter XML details in Configuration Section of UTA PDF Parser

The example below illustrates the XML syntax required to automatically create Level 2s in SmartSimple from an uploaded PDF.

Header
<?xml version="1.0" encoding="UTF-8"?>
<utaparser>
<leveltwo>
File Locations
<docid>DID</docid>
<appid>102587</appid>
<attachfieldid>1371520</attachfieldid>
<parentid>Parentid</parentid>
Key Fields
<keyfields>
<typename>{32588}</typename>
<description>DID</description>
<eownerid>@userid@</eownerid>
<objectid>Parentid</objectid>
<objecttype>{23}</objecttype>
<subject>@userid@</subject>
<startdate>Date</startdate>
</keyfields>
Form Fields/Field Mapping
<formfields>
<cf_1371451>Q1</cf_1371451>
<cf_1371453>Q2</cf_1371453>
<cf_1371454>Q3</cf_1371454>
<cf_1371456>Q4</cf_1371456>
<cf_1371460>Eli-1</cf_1371460>
<cf_1371462>Eli-2</cf_1371462>
<cf_1371464>Eli-3</cf_1371464>
<cf_1371465>Eli-4</cf_1371465>
<cf_1371469>Eli-5</cf_1371469>

<cf_1371472>Eligibility_Comment</cf_1371472>
<cf_1371496>Score_FocusArea</cf_1371496>
<cf_1371498>Score_Eligibility</cf_1371498>
<cf_1371519>Reviewer</cf_1371519>
<cf_1371521>Date</cf_1371521>
<startdate>Date</startdate>
</formfields>

Footer
</leveltwo>
</utaparser>

Header

The Header section will always contain the XML coding as shown: 

<?xml version="1.0" encoding="UTF-8"?>
<utaparser>
<leveltwo>

File Locations

The XML tags in the File Locations sections must contain values as follows:

  • docid - contains the value "DID"
  • appid - contains the application ID of the UTA to which the new Level 2s will be created.
  • attachfieldid - contains the custom field ID of the single file or multiple file upload field to which the PDF to be parsed will be uploaded.
  • parentid - contains the value "Parentid"

Key Fields

Form Fields/Field Mapping

Footer

Create a Fillable PDF Form

  • Fillable PDFs can be created using:
  • Adobe LiveCycle
  • Adobe Acrobat
  • Any other software that allows for the modification of form XML

See Also

Retrieved from ‘https://wiki.smartsimple.com/index.php?title=UTA_PDF_Parser_-_Configuration_Instructions&oldid=17615’