Troubleshooting

Introduction

This chapter describes what you can do if you do not get the results you expect when you run APSplit:

  • Review the troubleshooting checklist
  • Clean suspect PDF files.  If you cannot solve the problem, refer to Support to find out how to contact customer support.

Reviewing the Troubleshooting Checklist

This troubleshooting checklist describes common problems. It is the first place to look for a possible solution to your problem.

All platforms

Are you trying to retrieve information from one or more secured files?

You must specify the -d option, followed by the Owner password, as in the following example. (The Owner password is also called the Master password or the Permissions password.)

-d myownerpass

You can only specify one Owner password. Therefore, all of the secured files you include on the command line must have the same Owner password. If you want to split secured files that have different Owner passwords, run a separate command for each Owner password.

Are you using any options that require a file or directory name (-o, -l)?

The file or directory name must immediately follow the option, as in the following examples. If a text string other than a file or directory name follows the option, APSplit will recognize that text string as the file name. APSplit will also recognize a directory name as a file name if it does not end with a slash.

Windows Examples

-o C:\Appligent\APSplit\samples\myoutput.pdf
-o C:\Appligent\APSplit\samples\outdirectory\
-l C:\Appligent\APSplit\mylogfile.txt

UNIX/Macintosh Examples

-o /Appligent/APSplit/samples/myoutput.pdf
-o /Appligent/APSplit/samples/outdirectory/
-l /Appligent/APSplit/mylogfile.txt

Are all file and path names correct?

The best practice is to use full path names for all files. That includes input files, output files, and log files. Also make sure that all directory names end with a slash (back slash in Windows, forward slash in UNIX/Macintosh).

Is each input file a PDF document?

APSplit can only split PDF files. If you are using wildcards, include the pdf suffix (for example, *.pdf) to help prevent you from accidentally attempting to open a non-PDF file.

Are you using APSplit in a script?

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 APSplit from a command line.

Are you getting unexpected results from one or more PDF files?

There might be something wrong with the file. See Cleaning up PDF Documents below.

UNIX only

Did you get a “command not found” error? 

If you get a command not found error when running APSplit in its own directory, enter the command with the dot-slash in front of it, as in the following example:

./apsplit -o /Appligent/APSplit/outPDFDirectory/Appligent/APSplit/samples/inPDFFile

This tells your system that the application is in the current directory.

Do the application files have the execute permissions set?

If they don’t, you must set them.

You have completed the distillation process. Try using the distilled PDF file with APSplit. If you experience problems, see Support.

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.