In this article, you will learn
- how to upload custom Fixups, and
- where you can find and apply them.
1. Introduction
In order to use custom Fixups in the Workflow, they must first be created with callas pdfToolbox and then uploaded to the Workflow. Two essential components (files) are required to upload a custom Fixup to the Workflow:
-
KFPX file – this file type is generated by callas pdfToolbox. Fixups are created as needed in the desktop application and the profile is then exported as a
.kfpxfile. - XML file – this file contains the textual and structural description of the KFPX file. It defines, among other things, the descriptions of all available variables and controls the appearance of the associated dialog.
Creating Custom Fixups
To learn how to create your own Fixups and what prerequisites are required, please refer to the article Creating Fixups without Variables as well as the follow-up article Creating Parametrizable Fixups.
2. Uploading Fixups to the Workflow
Once both the KFPX file and the associated XML file have been finalized, they must be uploaded to the Workflow. After a successful upload, the Fixups are immediately available for use on Print Items or Article Items.
To upload a custom Fixup to the Workflow, proceed as follows:
- Navigate to Administration > Settings > Preflight / Fixup [1].
- Switch to the tab Custom Fixups [2].
- Click the button Upload [3]. This will open the dialog Upload KFPX- and XML-File.
Figure 1: The tab Custom Fixups with the option to upload user-defined Fixups
- In the first step, upload the KFPX file by either drag and drop it or click the respective button [4].
- Repeat this process for the corresponding XML file [5].
- then click Next [6] to proceed to the second step. In this step, the uploaded files are validated for completeness and checked for a unique key.
Figure 2: The dialog Upload KFPX- and XML-File
- If no errors have occurred, click Save [7] to upload the Fixup to the Workflow.
- If the
automationKeyis already in use, a corresponding error message will be displayed in the Validation Result step. If you want to overwrite the existing Fixup, click Update [8] to upload the new version of the Fixup.
Figure 3: The Validation Result step in the dialog Upload KFPX- and XML-File
3. Accessing Uploaded Fixups
Once a custom Fixup has been successfully uploaded, it becomes available in the Workflow. Custom Fixups can be accessed in two areas within the Workflow:
3.1. Access via the Tab «Data Preparation»
The tab Data Preparation is located in the detail view of an Article, Print Item or Production Job. This section provides an overview of all Fixups available in the Workflow – including those that were custom-created and uploaded Custom Fixups [9]. For a comprehensive overview of how to use and manage Fixups within the Workflow, please refer to the article General.
Figure 4: The display in the tab Data Preparation with selected Custom Fixups
3.2. Access via «Fixup Chains»
Custom Fixups can also be integrated into Fixup Chains and thus be used across various areas of the Workflow. To learn how to create a Fixup Chain and add individual Fixups to it, refer to the article Fixup Chains.
Figure 5: The dialog Edit Fixup Chain displaying the list of all available Fixups
Artikel update: Workflow 1.20.1 – 05/2025