Available: on-premises, cloud
This page describes how to configure the Create Multipage Files plugin in Ephesoft Transact. These steps are intended for Transact administrators.
Overview
The Create Multipage Files plugin is a default plugin in the Export module. This plugin generates multipage PDF and TIF files for each document type of a batch inside the final drop folder. This final drop folder path can be configured in the Copy Batch XML plugin.
This plugin also generates colored, searchable, and optimized PDFs depending on your chosen configurations.
Prerequisites
To configure and use the CREATEMULTIPAGE_FILES plugin, the following configurations must be in place:
- You will need a batch class with a document type configured. For detailed steps, refer to Add New Document Type.
Note: You don’t need to add this plugin to the Export module, as it is included by default.
Configuring the Create Multipage Files Plugin
This section provides information on how to configure the Create Multipage Files plugin. This plugin only needs to be configured once per batch class.
To navigate to the plugin:
- From the Batch Class Management page, select and open your batch class.
- Go to Modules > Export > CREATE_MULTIPAGE_FILES.
Figure 1. CREATE_MULTIPAGE_FILES Plugin Configuration
- Configure the required fields according to your workflow needs. Use the table below as a reference.
Configurable Property | Options | Description |
Use EText Original Pages When Available |
|
This property determines whether Transact will use the originally uploaded PDF when a text layer is detected, or use a transformed image. |
PDF Optimization switch |
|
This switch enables or disables PDF optimization.
Note: PDF optimization cannot be applied If the Multipage File Export Process is set to GRAPHIC_MAGICK or IMAGE_MAGICK. |
Multipage File Export Process |
|
This property determines the export process to create multipage files. |
Colored Output PDF |
|
This property determines whether the generated PDF will be color or grayscale.
|
Searchable Output PDF |
|
This property determines whether the output PDF will be created with a searchable text layer or not. |
PDF Creation Parameters | N/A | Use this field to provide the parameters for creating multipage files. |
PDF Optimization Parameters | N/A | Use this field to define Ghostscript parameters for creating optimized PDFs. |
Multipage File Creation Type |
|
This property determines the file extension of the output multipage files. |
IText Searchable PDF Type |
|
This property determines the PDF type when the Multipage File Export Process is set to ITEXT-SEARCHABLE.
|
Compression switch |
|
This switch enables or disables compression of the output PDF. |
Compression Factor |
|
This property determines the compression factor of the output PDF file, with 0.25f being the most compressed, and 0.75 being the least.
For example, 0.50 would not decrease the export file by half, instead it will compress the contained images by the defined compression factor. If the size of the image is X MB and the compression factor is 0.50, the file is compressed to X*0.50 in dimension. Note: This does not compress any output TIFF files. |
Output PDF Version |
|
This property determines the Adobe PDF version of the output file. |
Configuring the Property File
Additional configurations can be made in the imagemagick.properties file. This file is located at [Ephesoft_Directory]\WEB-INF\classes\META-INF\dcma-imagemagick.
Refer to the table below for descriptions and examples of configurable properties.
Configurable Property | Data Type | Sample Value | Description |
imagemagick.tif_compression | string | LZW | Defines the compression mode used when creating multipage Tiff files. |
imagemagick.pdf_quality | integer | 100 | Defines the quality of PDF files, which can vary from 0-100. |
imagemagick.colored | string | True | Defines whether multipage Tiff files will have colored or grayscale images. |
imagemagick.pdf_compression | string | LZW | Defines the compression mode used when creating multipage PDF files. |
imagemagick.display_image_output_parameters | string | -colorspace gray +matte | Defines the ImageMagick and GraphicMagick output parameters used when generating multipage Tiff files. |
imagemagick.max_files_processed_per_gs_cmd | integer | 75 | Defines the maximum number of files Ghostscript can process to generate multipage PDFs. |
imagemagick.height_for_pdf_page | integer | 792 | Defines the height of PDF pages when generating PDFs using iText |
imagemagick.width_for_pdf_page | integer | 612 | Defines the width of PDF pages when generating PDFs using iText |
imagemagick.max_files_processed_per_im_cmd | integer | 100 | Defines the maximum number of files ImageMagick or GraphicsMagick can process to generate multipage Tiffs. |
Dependency
The CREATEMULTIPAGE_FILES plugin requires an hocr.xml file to create searchable PDFs. As such, this plugin has a dependency on the RECOSTAR_HOCR (Windows) or TESSERACT_HOCR (Linux) plugins.
Troubleshooting
Error Message | Possible Root Cause |
IM4JAVA_TOOLPATH is not set for converting images using ImageMagick. | Environment variable for ImageMagick is not set. |
GM4JAVA_TOOLPATH is not set for converting images using GraphicMagick. | Environment variable for GraphicMagick is not set. |
Environment Variable GHOSTSCRIPT_HOME not set. | Environment variable for GhostScript is not set. |
Conclusion
This completes an overview of how to configure the Create Multipage Files plugin in Ephesoft Transact.