Processing server errors

• 1 minute to read

Although the Preflight Tool can handle most commercial printing PDF files, there is a small chance that a user uploads a PDF file that may cause some server-side issues. For example, it may be extraordinarily huge or corrupted. In this case, the user either receives an error message, or the file processing takes a very long time. The ordering process will be interrupted.

If you prefer the user to proceed with the order anyway, even if the PDF file potentially does not meet your requirements, you may enable a special mode as explained below.

Error ignore mode

To tackle the issues explained above, the Preflight Tool widget config includes the mode section, which has two parameters.

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

The ignoreServerErrors parameter specifies whether to skip the errors received from the server. The requestTimeout specifies how long it should wait (in seconds) before it decides that it is necessary to interrupt the PDF processing. If the ignoreServerErrors parameter is set to true, then this timeout error will be ignored as well.

Error types

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

• Read and analyze a PDF file.
• Fix issues in a PDF.
• Generate a preview and/or a final processed PDF.

How are they handled when you enable the ignore mode?

• If it fails when a PDF is being analyzed, the backend reports that the file is "correct".
• If it fails when fixing issues in accordance with the rules, it reports that the problem is "fixed".
• If it fails during rendering, the original file is returned.