Troubleshooting

In this chapter…

… we present a collection of hints and tips for working with FDFMerge Pro. If you are having
trouble with the software, consult this list of issues for a possible solution.

Common Error Checklist

  • When using FDFMerge Pro in a script, be sure to use full path names for all files and
    applications accessed from within the script. If you cannot get your script to work, make
    sure that you can run FDFMerge Pro from a command line.
  • If you find your files are not working as you had expected try re-saving them in Acrobat as
    Optimized.
  • Have the command-line options been entered properly (make sure options -l <logfile>
    and -o <output file> have filenames specified after them)?
  • Make sure to use the -o <output file> option.
  • Do all of your files have the correct path name? Check to make sure that the directory that
    you’re working from is the one you think it is. You may have inadvertently changed
    directories.
  • Even if you are running FDFMerge Pro in its own directory, enter the command with the
    dot-slash in front: ./fdfmergepro to tell your system that the application is in the
    current directory. (This is more important for Unix than for Windows.)
  • FDFMerge Pro cannot read any password-protected PDF file. Make sure none of the files
    have encryption.
  • Make sure you have full permission to write to the output directory.
  • In the FDF file, double check:
    1. Are all the Form Field names correct (capitalization and spelling)?
    2. Are the paths and filenames correct for template files?
    3. Are all the objects and dictionaries nested properly?

 

Cleaning Up PDF Documents

Not all PDF files are created equal. The way in which a PDF document is generated makes a difference, and PDFs generated by third party tools in particular can vary in quality. PDF documents can also become corrupted.

To check how the file was created:

  • In Acrobat X, XI and DC select File > Properties… and click Description. Under Advanced, look at PDF Producer.

If the PDF Producer field is blank, consider the file suspect.

Making a Clean PDF

If you are having problems with a specific PDF, try to create “clean” version of your document. There are two ways of doing this using Adobe Acrobat. If you use other PDF manipulation software, check the documentation for functions that may be equivalent to those found in Adobe Acrobat.

Method 1: “Optimize” your PDF

  • In Acrobat X, XI and DC > File Menu > Save As > Optimized PDF

If saving as optimized does not work, distill the document by following the steps below.

Method 2: Distilling PDF Documents

Distilling a document will remove all comments and form-fields from the PDF. If the PDF contains these items and you wish to preserve them, you must save them before Distilling.

To save existing comments

  • In Acrobat X, XI and DC select Comments > Comments List > click the Options icon > Export All to Data File… In the Export Comments dialog box, select a name and location for the Forms Data File (.fdf), and click Save.

See the additional step below for saving form fields (if any):

Delete all comments:

  • In Acrobat X, XI and DC select all the comments in the Comments List pane and press the Delete key.

To save form fields (if any):

  • Save a copy of the original file. You will copy and paste the form fields from the original file into the new file after the distilling procedure.

Distilling the document

To distill a PDF document do the following:

  • In Acrobat X and XI select File > Save As > More Options > PostScript. Choose a name and location for the file and click Save.
  • In Acrobat DC select File > Export to > PostScript. Choose a name and location for the file and click Save
  • Open Acrobat Distiller > select File > Open… In the Open PostScript File dialog, locate the PostScript file created in the previous step and click Open.

The distiller will create a new PDF file with the same name and location as the PostScript file.

Restoring comments

To restore the comments:

  • In Acrobat X and XI, select Comments > Comments List > click the Options icon > Import Data File… In the Import Comments dialog box, locate the Forms Data File (.fdf) previously saved and click Select. In the next pop-up box, click Yes. The comments are restored.
  • In Acrobat DC, select Tools > Comments > Comments List > click the Options icon > Import Data File…In the Import Comments dialog box, locate the Forms Data File (.fdf) previously saved and click Select. In the next pop-up box, click yes. The comments are restored

Restoring form fields

To restore form fields:

  • Open the original PDF file that includes form fields.
  • In Acrobat X and XI select Tools > Forms > Edit Form)
  • In Acrobat DC > select Tools > Prepare Form > Form fields will automatically appear
  • The form fields will appear, do a Control-A to select all the form fields.
  • Open the new distilled PDF file which has no form fields.
  • Do a Control-V to paste all the form fields onto the page.

You may need to reposition the fields by selecting them again with the Select Object Tool and moving them to the correct position. For multi-page forms you must do this for each page separately.