✎ best practices - create a pdf that can be filled out submitted and auto-uploaded into the application [WorkXpress]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Create a PDF that can be filled out, submitted and auto-uploaded into the Application ======

A special URL exists in all installations that allows specially crafted PDF's to post their data to this URL, and as such "upload themselves" into an installation.

The requirements are this: 

1. Create a PDF with a Form in it.

2. On that form, you need 4 required, and 1 optional field.  These fields should be Hidden, or the Visible box un-checked for them.  These fields are: 

**Required:**
  * sourceFieldId - The WX Item ID for the Field that contains the empty PDF that you're going to fill.  Usually this will be the field where the client downloaded the PDF from.from.  
  * sourceRecordId - The WX Item ID for the Record that contains the empty PDF that you're going to fill.  Usually this will be the record where the client downloaded the PDF from.from.  
  * destinationFieldId - The WX Item ID for the Field where the new PDF should be uploaded.
  * destinationRecordId - The WX Item ID for the Record where the new PDF should be uploaded.

**Optional:**
  * newPDFName - The name you want the destination PDF to have.  If you don't end it with .pdf, we will add it.  If you put a space in it, it will be converted to an underscore.  If you don't provide it at all the new pdf will be called new_pdf.pdf

3. Add a Submit Button - You also need to add a button that submits the form, via HTML/POST to a special URL.  It should submit to https://YOURAPPURL.workxpress.com/tps/pdf/receive.php using HTML and choosing POST.

Here's an example of what this looks like from the PDF I setup using Nuance Power PDF: 

{{ ::pdf_save_button1.png?nolink |}}

And when you edit the Submit a Form action:

{{ ::pdf_save_button2.png?nolink |}}

The recommended setup is this: 

Setup a Source PDF that has the form fields mentioned above, and the fields that you want the user to fill out.  Upload this to your WX App.

Then, when you're ready to "setup a PDF to be filled out" onto a record for the occurrence.. like "Bob's Tax Form"... you do a Fill PDF action to setup the field ID's and record ID's into the Source PDF.. and save it onto a record that represents Bob's Taxes for 2016.  Then, have Bob download this PDF.

Bob downloads it, fills out the fields (tested in Acrobat Reader), and clicks submit.. then in your WX app, and the dest field on Bob's Tax Form record is filled in.

Happy Building!