Transact

⌘K
  1. Home
  2. Transact
  3. Features and Functions
  4. Administrator Role and Fe...
  5. Modules and Plugins
  6. Export Module
  7. Tabbed PDF Plugin

Tabbed PDF Plugin

Available: on-premises, cloud

This plugin is used to merge all multi-page PDFs to form a single-tabbed PDF file based on a placeholder. This plugin creates bookmarked PDF files in the configured export folder by merging all multi-page PDFs.

Configuration

Steps for configuring the plugin

Select the Export module and navigate to TABBED_PDF plugin configuration page as shown below:

You can edit the above settings as per your requirements.

Configurable Properties

Following are the configurable properties available for the TABBED_PDF plugin:

Configurable property Type of value Value options Description
Tabbed PDF Switch List of values
  • ON
  • OFF
Determines whether the plug-in will run or not.Default OFF.
Tabbed PDF Export Folder String(Folder path) Example:

C:\Ephesoft\SharedFolders\tabbed-pdf-export-folder

Folder in which the output tabbed PDF and multi-page tiff file (if created) will be stored
Tabbed PDF Placeholder List of values
  • YES
  • NO
  • If this switch is set to YES, this plugin will create the document map by order or priority of document types defined in the export-script.properties file. In this case a tab will be created in document map for each document type and load the error PDF if the document is not present in batch.xml.
  • If this switch is set to NO, this plugin will create a document map on the basis of documents present in batch.xml. Tabs will be created only for documents that are present in batch.xml.

By default, this option is set to NO.

Tabbed PDF Property file String(File path) Example:

C:\Ephesoft\SharedFolders\property\export-script.properties

This property file has document types and their priority in a predefined format.
Tabbed PDF Creation Parameters String Example:

 -q -dBATCH -dNOPAUSE -sDEVICE=pdfwrite
These parameters will be used by ghost script at the time of PDF creation.
Tabbed PDF Optimization Parameters String Example:

 -q -dNODISPLAY -P- -dSAFER -dDELAYSAFER -- pdfopt.ps
These parameters will be used by ghost script at the time of PDF optimization.
PDF Optimization switch List of values
  • ON
  • OFF
Determines whether the PDF optimization will be performed or not.Default ON.

Property File Configuration

The property file is located at:

[Ephesoft_Directory]/WEB-INF/classes/META-INF/dcma-tabbed-pdf/dcma-tabbed-pdf.properties

Configurable property Type of value Value options Description
tabbed_pdf.ghost_script_command String
  • gswin64c
  • gswin32c
Ghost script command for Linux and Windows.
tabbed_pdf.unix_ghost_script_command String gs Ghost script command for Unix.

Steps of execution

  1. This plugin uses the batch.xml file, multi-page PDF files, and multi-page tiff files inside batch instance folder.
  2. The batch.xml is updated with the processing results.
  3. All multi-page PDF files are combined to create single PDF document and copied to the tabbed-pdf-export-folder inside SharedFolders. The PDF filename uses the following format:

<name of batch folder>_<batch instance identifier>.pdf

For example, BC1_BI3.pdf

  1. The first multi-page TIFF is copied to the tabbed-pdf-export-folder inside SharedFolders and the remaining multi-page TIFF files will be lost.

Dependency

The plugin assumes that multipage PDFs are created by batch preprocessing. So create multi page files plugin should be in workflow of batch class because create multi page files plugin is responsible for creating multi page PDFs. Besides this export-script.properties file should be at right place with correct information.

Troubleshooting

Following are few common error messages received due to mal-functioning of the plugin:

S no. Error message Possible root cause
1. {folderPath} is not a Directory. Folder path configured by user is not valid.
2. Property file for documents not valid. Same priority is defined for more than one document type.
3. File does not exist. File Name=”{file-name}” Invalid PDF file name is mentioned in batch xml.
4. Error in writing pdfMarks file. Some error occurred while processing.
5. Enviornment Variable GHOSTSCRIPT_HOME not set GHOSTSCRIPT_HOME is not set in environment variable or in startup.bat file inside the [Ephesoft_Directory]\JavaAppServer\bin folder.
6. No ghostcript command specified in properties file. Either the dcma-tabbed-pdf.properties file is not present, or properties are missing in properties file.
7. Sample PdfMarks file not provided. pdfmarks.dat is not present at specified location.

Note: If the tabs of the exported PDF are not arranged by Acrobat Reader DC (v.2018.009.20050) according to the priority specified in export-script.properties, you have to manually change the following setting:

  1. In Adobe Acrobat Reader DC, click Edit from the top menu and select Preferences
  2. In the General tab, select Basic Tools.
  3. Check the box Enable PDF thumbnail previews in Windows Explorer, and wait for the Windows to configure Adobe Acrobat DC.

Now, the PDF tabs will be shown in the correct order.