Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Figure 1: Merge PDF Button in Datalist

Getting Started

Steps

1. You can obtain the jar file by the latest release at https://github.com/jogetoss/merge-pdf-datalist-action/releases.

...

Name

Description

Label 

Datalist button label.

Form *

Form that contains the file upload field.

Field *

File Upload field that the PDF is uploaded to.

Record Id Column 

If not set, default value will be the primary key of the configured binder.

Confirmation Message

Confirmation message before performing action, for example "Are you sure?".

File Name

If not set, default file name will be based on record id field value.

Zip File Name

The file name of the zip file. If not set, default file name will be the button label.

Configure Merge PDF Tool Plugin

Steps for configuring Merge PDF Tool

1. Create a form with two file upload fields to upload PDF files.

Image Added

Figure 12: Add File Upload fields in form


Info

You may upload multiple PDF files into a single File Upload field. In that case, make sure to enable the "Enable Multiple file uploads" option under the UI section in Advanced Options.

Image Added

Figure 13: Enable Multiple Files Upload


2. Add one more file upload field. This field will be used to store the merged PDF generated.

Image Added

Figure 14: File Upload field where the merged PDF file is stored


3. Configure Post Form Submission Processing

  • In Settings →  Advanced → Post Form Submission Processing, select Merge PDF Tool as the post-processing tool.

Image Added

Figure 15: Post Form Submission Processing


Image Added

Figure 16: Configure PDF Merge Tool


NameDescription
Source File

Header Field.

Choose Form (Source File) Select the form containing the PDF files you want to merge.
Choose Fields (Source File)

Select one or more File Upload fields that store the PDF files to be merged.
Use the ➕ button in the grid to add multiple fields.

Output File

Header Field.

Choose Form (Output File)

Select the form where the merged PDF file will be stored.

Choose Field (Output File)

Select the target File Upload field where the merged PDF will be stored.

Rename File

Set the name for the merged PDF file. Use plain text for a fixed name, {fieldid} to insert values from form fields, or Hash Variable

For multiple files, uses the first file's name or set a custom name in the configuration.


4. Save the Configuration and Generate CRUD for the form

Image Added

Figure 17: Generate CRUD for the Form

Steps to run the Tool plugin

1. At runtime, go to "Manage Merge PDF Tool Form" and click New. Upload PDF files into the File Upload fields and save the form.

Image Added

Figure 18: Manage Merge PDF Tool Form


2. After submission, click Edit on the record to open the form and download the merged PDF file stored in the Merged PDF field.

Image Added

Figure 19: Merged PDF file stored in the "Merged PDF" field after form submission

Source Code and Plugin Download

You can obtain the jar file by the latest release at https://github.com/jogetoss/merge-pdf-datalist-action/releases.

Demo App Download

View file
nameAPP_kb_dx8_MergePDFDatalistActionSampleApp.jwa
height250
Download the demo app from https://github.com/jogetoss/merge-pdf-datalist-action (.jwa file).