pdfFlattenFile Step

Use this step to flatten a PDF document

Last published at: May 17th, 2024


This step flattens a PDF document. When you flatten a PDF, you merge previously separated contents into one. Flattening a PDF means that interactive elements in PDF forms, such as checkboxes, text boxes, radio buttons, and drop-down lists, are no longer fillable.



  • inputFilePath - Input File Path
  • outputFilePath – Output file path
  • pdfVirtualPath – PDF Virtual file path



  • True – step executed successfully
  • False – step failed to execute 
  • Error - step execution error 






Let’s build and execute the pdfFlattenFile example.                             

  • Create a new definition called “pdfFlattenFileDef”
  • Select the definition and click the “design” button
  • Drag  the “pdfFlattenFile” step to the canvas
  • Connect the dots between the start and the step, as shown in the above image 
  • Define a few variables/globals to store the file path result after execution
  • Click the "pdfFlattenFile" step to configure its "Settings" properties. Give the step a name. Provide the source file path on the application server. Provide the variable references to hold the Output and Virtual PDF file paths. Click the Save button to confirm. 
  • The “Logging” setting configuration is necessary for documentation and also measures the workflow progress and the percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.
  • Save the process definition, create a new instance, and execute. Render the process instance. Click on the “pdfFlattenFile” process step to view the properties. The step is to make a copy of the PDF by flattening the document and thus reducing the size. Copy and paste the pdfVirtualPath variable value into a browser window to view the PDF file.