Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width800px

Checking the Save PDF option for a form/flow saves a a PDF image of the form/flow in the 

Frevvoproduct
' submission repository. This generated snapshot is a basic PDF rendering of the form/flow.  You can generate additional PDFs' as part of your form/flow, if required. For Example, new employees hired by a company are typically asked to fill out federal forms such as a W-4 or an I-9. 
Frevvoproduct
' Pixel Perfect PDF generation feature allows you to design a form/flow with fields that capture the information needed and integrate the data from the e-form controls to an acroform PDF.
Frevvoproduct
adds all generated PDF forms to the document set of a completed form/flow. See Submissions for more details.


 

Column
width350px

On This Page:

Table of Contents
maxLevel4

...

Functions for buttons and images on this page are listed below:

FunctionDescription
Done ButtonClick this button when mapping is complete or you wish to exit back to the PDF Generated Forms Screen. Field mappings are saved to the in-memory form/flow as they are performed. Mappings are not persisted until the form/flow is saved.
Clear ButtonClicking this button clears all mappings for the whole PDF. All fields are then displayed as not mapped (colored yellow and cleared of all text).
PDF Page thumbnail ImageThumbnail images are displayed for each page found in the PDF with no limit. The HTML element containing the PDF page thumbnails will be scrollable if there are a large number of pages and all cannot fit in the displayable area. Click the thumbnail image for the page in the acroform where you want to map fields. When clicked, that page is selected for mapping and it is displayed along with any previous mappings filled into the fields.

In the flow designer, steps in the flow are shown as top level elements in the tree. The image shows four steps in the Employee On Boarding flow as they appear in the Mapping Form Outline.

...

Functions for buttons in the PDf Mapping dialogue box are listed below:

ActionDescription
more>> less<< linksUsed to hide and show more details about the PDF field being mapped, including Type, selectable values and the name of the field in the acroform. This information is useful when trouble shooting. Selecting more>> shows the details and changes the link to less<<. Selecting less<< hides the details.
Clear MappingClears the mapping (if any). Any selected radio button is cleared. Changes take place immediately.
Selection Radio ButtonsThe first column consists of radio buttons for each mapping choice. Click the radio button corresponding to the Live Form control to map it to the field in the pdf. Radios may not be de-selected. Live Form fields are unmapped using the clear button or by selecting another e-form field.
Index Edit BoxesFor repeating Live Form fields, the 1-based index is used to select the field to be mapped. The value must be ≥ 1. The default is 1. Changes take effect immediately upon tabbing/clicking off the the index field. The index field is disabled for non-repeating Live Form fields.
Search Text BoxUse this to search for mapping choices for the pdf field that was clicked. Entering filter text causes the possible mapping selections to change. Only those matching the filter text will be shown. If the name, label or form name (flows) is either a partial or full match of the filter text (case insensitive), then the field is shown in the list of candidate fields selectable for mapping. E-form fields that are incompatible with the PDF field are not shown in the list . Search will find special mapped items such as Signed Section signature, date signed as well as the single select comment field. Use option control values to search for selection control options.
PDF FieldThe name of the field in the acroform is displayed here.

For example, let's say you want to map the Employee Signature on the W - 4 to the signature control on the Confirmation step of the Employee On Boarding flow.

...

  • The horizontal columns represent the acroform field types and the vertical rows represent the Live Forms control types.
  • Blank cells indicate that mapping is not possible. E-form fields will not be made available for mapping for those types of  acroform fields.
  • An acroform check box is a single check box and does not correspond one to one to a Live Forms check box.
  • An acroform radio button is a single radio button and does not correspond one to one to a Live Forms radio control.
  • Checkbox, radio and dropdown options are included in the mapping select controls in the PDF (according to the table below). They will be listed as ControlName.OptionName?.
  • Live Forms manual signatures are treated as images. They can be mapped to text fields. The image is linearly scaled to fit within both the vertical and the horizontal dimensions of the text field without any distortion.  
E-Form Field Typesacroform Field Types
CheckboxChoice/Combobox (Single select)ListRadio ButtonTextPush ButtonSignature
CheckBoxMapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. See NOTE below.Select one item in choice/combo corresponding to selected checkbox options. Equate items/options by the value/option, not label. Only single select supported in some cases (depends on if field is set to multi).Select items in list corresponding to selected checkbox options. Equate items/options by the value/option, not label. If list box is single select only one option is selected.Select one item in radio corresponding to selected checkbox options. Equate items/options by the value/option, not label. Only single select supported.Yes. The label text of the selected option(s) will be comma separated and used.
  


CheckBox OptionYes. If option selected, check box will be selected.
   



Yes. If selected, then option label text used.
  


CheckBox Comment
    




Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF).
  


RadioMapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. Select item in choice corresponding to selected radio option. Equate items to options by the value, not label.Select items in list corresponding to selected radio option. Equate items to options by the value, not label.Select one item in radio corresponding to selected radio option. Equate items/options by the value/option, not label. Only single select supported.Yes. The label text of the selected option will be used.
  


Radio OptionYes. If option selected, check box will be selected.
   



Yes. If selected, then option label text used.
  


Radio Comment
   
 




Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF).
  


DropdownMapping is done by option value. If the value of any of the selected option(s) on the e-form control matches the 'on' value of the check box, then it is selected. Otherwise it is unchecked. Select item in choice corresponding to selected dropdown option. Equate items to options by the value, not label.Select item in list corresponding to selected radio option. Only select one by definition. Equate items to options by the value, not label.Select one item in radio corresponding to selected dropdown options. Equate items/options by the value/option, not label. Only single select supported.Yes. The label text of the selected option will be used.
  


Dropdown OptionYes. If option selected, check box will be selected.
   



Yes. If selected, then option label text used.
  


Dropdown Comment
  
  




Yes. Only if comment is enabled. Multiple lines will be concatenated (new lines not carried over to PDF).
  


Text & Text Area
  
  




Yes. Simple text transfer.
 
 Yes. Use


Date, Time, DateTime
    




Yes. Use formatted date/time.
  


Email, Phone
    




Yes.
  


Money, Quantity, Number
    




Yes.
  


T/FYes
   



Put a 'true' or 'false' in as appropriate.
  


Image
       







Signature/Signed Section
    




Yes
 

Yes
Upload
    




Yes
  


Combobox
    




Yes
  


In general, all the

Frevvoproduct
controls listed, can be mapped to an acroform text field. Selection controls are mostly handled by mapping the option values as indicated above.

...

Of course, you can always click the icon to save your form/flow when the mapping completed, then click on the  Test icon to run the form/flow and submit it. When you get to the form with the Form Viewer control, be sure to check the generated Pixel Perfect PDFs such as the W - 4 etc.

...

Troubleshooting

Large PDFs with MySQL

Submitting a form/

...

workflow with a large

...

Image Removed

...

mapped PDF while using MySql may generate an error message like the one below. The default value of max_allowed_packet configuration parameter may not be large enough. See this documentation for the solution.

Image Added

PDF Will Not Load for Mapping

When you click Map Fields, you will initially see the message “Please wait while the PDF is loaded and prepared for mapping.” If the form fails to load at this point, you may also see an error in the logs similar to 

Code Block
"Application error processing /frevvo/web/tn/...
java.lang.RuntimeException: javax.servlet.ServletException: java.lang.ClassCastException: org.icepdf.core.pobjects.Reference cannot be cast to java.lang.Number

The PDF may appear normal, but it does not work with frevvo's ICEPDF library. To resolve this, please upload the PDF to a tool like pdf escape, then save and download it. You may notice the version is larger than the original. Upload the new version to frevvo and proceed to map the fields.