360Works PDF Plugin/Documentation
360Works PDF Plugin User Guide
Plugin for filling out form data in a PDF.
Usage Summary / Quick Start
Use PDFLoad to load a file. This also returns a list of all fields, or "ERROR" if an error occurs.
Use PDFLastError to check for any errors during loading of the PDF File
Use PDFGetFieldValue ( fieldName ) to query for existing field values
Use PDFSetFieldValue ( fieldName ; fieldValue ) to set values
Finally, use PDFSave ( path ) to save the PDF to the hard drive, applying any new PDF form values. Path is optional. This returns the path to the newly saved PDF.
360Works Plugin Setup Guides
See Plugins_101 for Error reporting, installation, registration, and more.
Function Summary
- PDFAddObject ( objectName { ; key1=value1 ; key2=value2 ; ... } ) —
- PDFCreate ( { key1=value1 ; key2=value2 ; ... } ) — Create an empty PDF
- PDFGetFieldValue ( field ) — Returns the value of a named field in the PDF form.
- PDFLastError ( ) — Returns the last PDF-related error which occurred.
- PDFLicenseInfo ( ) — Returns information about the license used.
- PDFListFields ( sourcePDF ) — Returns a list of field names in the PDF.
- PDFListValues ( sourcePDF ) — Returns a list of field values in the PDF.
- PDFLoad ( pdfFile { key1=value1 ; key2=value2 ; ... } ) — Extracts all the form data from a PDF, returns a list of fields.
- PDFPopulateForm ( sourcePDF ; keys ; values ) — Populates a PDF form with data.
- PDFRegister ( licenseKey ; registeredTo ) — Registers the plugin.
- PDFSave ( { path } ) — Creates a new PDF, using any form values set via the {@link #PDFSetFieldValue} function as data.
- PDFSetErrorCapture ( errorCapture ) — Toggles error dialogs on or off.
- PDFSetFieldValue ( field ; value ) — Set the value of a field in the PDF.
- PDFSplice ( pdf ; pageNumbers { ; key1=value1 ; key2=value2 ; ...} ) — Extract some pages from a PDF document into a new PDF.
- PDFVersion ( ) — Returns the version of the plugin which is installed.
Function Detail
PDFAddObject ( objectName { ; key1=value1 ; key2=value2 ; ... } )
PDFCreate ( { key1=value1 ; key2=value2 ; ... } )
Create an empty PDF
args
- optional parameters
PDFGetFieldValue ( field )
Returns the value of a named field in the PDF form.
field
- the name of a field in the form
PDFLastError ( )
Returns the last PDF-related error which occurred. This should be called any time that a plugin function returns "ERROR" to get a user-readable description of the error.
If there are data fields specified which don't match any field in the PDF, PDFLastError will return a list of fields which could not be set.
""
if there was no error.
PDFLicenseInfo ( )
Returns information about the license used.
"ERROR"
on failure.
PDFListFields ( sourcePDF )
Returns a list of field names in the PDF.
sourcePDF
- the PDF
PDFListValues ( sourcePDF )
Returns a list of field values in the PDF.
sourcePDF
- the PDF
PDFLoad ( pdfFile { key1=value1 ; key2=value2 ; ... } )
Extracts all the form data from a PDF, returns a list of fields.
pdfFile
- PDF container or URL
PDFPopulateForm ( sourcePDF ; keys ; values )
Populates a PDF form with data.
Error Handling
If there are data fields specified which don't match any field in the PDF, they will be logged as an error. Call PDFLastError to get a list of fields which could not be set.
If the source PDF cannot be read, or some other critical error occurs, "ERROR" is returned. Call PDFLastError for more info on this.
sourcePDF
- the container/path/url where the PDF to fill out is located
keys
- return-separated list of form field names to fill out
keys
- return-separate list of form field values to enter into the form. There must be the same number of
keys
andvalues
.
PDFRegister ( licenseKey ; registeredTo )
Registers the plugin.
licenseKey
- a valid license key
registeredTo
- the company the plugin is registered to
"ERROR"
on failure.
PDFSave ( { path } )
Creates a new PDF, using any form values set via the PDFSetFieldValue function as data. If no path is specified, the PDF is written to a temporary file.
The default behavior of this function is to return a container
path
- The full path of the file or directory where the new PDF is to be written.
PDFSetErrorCapture ( errorCapture )
Toggles error dialogs on or off. When something unexpected happens, the plug-in will pop up a dialog displaying the error message. This makes it easy to see what went wrong. However, in some cases, you (the developer) may prefer to show your own message to the user, or possibly not show a message at all. In that case, you can call PDFSetErrorCapture with a parameter of true. That will suppress the error dialog from appearing to the user.
errorCapture
- set to true to suppress the default popups.
PDFSetFieldValue ( field ; value )
Set the value of a field in the PDF.
field
- the name of a field in the PDF form
value
- the value to assign to the field when the PDF is saved
PDFSplice ( pdf ; pageNumbers { ; key1=value1 ; key2=value2 ; ...} )
Extract some pages from a PDF document into a new PDF. Pass this function a source PDF and some page numbers to extract and use in the new PDF.
The pageNumbers
parameter should be a comma-separated list of page numbers or page number ranges.
Optional Parameters
- filename
- The name given to the resulting PDF file
- filepath
- destination folder/path for the resulting file
- ownerPassword
- The password used to encrypt the PDF file
Set Variable [ $newPDF ; PDFSplice ( myTable::myContainer ; // sourcePDF "1, 10, 20-30" ; // pageNumbers "filename=SplicedResult.pdf" // optional filename parameter ) ]
sourcePDF
- The original PDF
pageNumbers
- The page numbers to take from the original PDF when assembling the new PDF.
args
- optional parameters
pageNumbers
from the sourcePDF
.
PDFVersion ( )
Returns the version of the plugin which is installed.
"ERROR"
on failure.