Processing server errors

• Last updated on October 31, 2025
• •
• 1 minute to read

The Preflight Tool is designed to process most commercial printing PDF files. However, there's a small chance that a user may upload a PDF file that causes server-side issues—for example, if the file is unusually large or corrupted. In such cases, the user may receive an error message, or the file processing may take an unusually long time, interrupting the ordering process.

If you want users to proceed with their order even if the PDF file doesn't meet your requirements, you can enable a special mode as described below.

Error ignore mode

To address these issues, the Preflight Tool configuration includes a mode object with two parameters:

{
    "mode": {
        "ignoreServerErrors": true,
        "requestTimeout": 20
    },
    ...
}

• ignoreServerErrors: Specifies whether to skip server-side errors.
• requestTimeout: Specifies the maximum time (in seconds) to wait before interrupting PDF processing. If ignoreServerErrors is set to true, timeout errors are also ignored.

Error types and handling

The Preflight Tool may encounter server-side issues during the following operations:

• Reading and analyzing a PDF file.
• Fixing issues in a PDF.
• Generating a preview or final processed PDF.

When you enable the ignore mode, the tool handles errors as follows:

Operation	Behavior in Ignore Mode
PDF analysis fails	Reports the file as "correct."
Fixing issues fails	Reports the problem as "fixed."
Rendering fails	Returns the original file.

Troubleshooting

Error: "Failed to insert uploaded files in product. File exists"

Cause: This error occurs when the C:\Windows\Temp folder on the server is full. It can happen if too many temporary files accumulate, preventing new files from being saved.

Solution: Clear the contents of the C:\Windows\Temp folder on the server. Ensure that the account running the Preflight Tool has write permissions for this folder.