Description:
This step populates the Form fields in the PDF document.
Inputs
- pdfFormFile – Choose PDF Form File as a file template
- pdfOutputFileVarGlobal – Variable / Global to hold the output PDF file
- pdfVirtualFileVarGlobal -- Variable / Global to hold the output PDF virtual file path
- outputFileReadOnly -- Set output PDF as Read-Only (for fields that were set)
- pdfFieldMap -- PDF form field mappings with respective values
Returns
- True – step executed successfully
- False – step failed to execute
Usage :
Example:
Let’s build and execute the “setPDFFormFieldsDef” example.
- Create a new definition called “setPDFFormFieldsDef” and open the definition in designer mode.
- Drag a “setPDFFormFields” step to the canvas.
- Connect the dots between the “Start” and “setPDFFormFields” steps, as shown above.
- Click the “setPDFFormFields” step to configure its “Required” properties. Provide a name for the step. Select the PDF file from the drop-down list. Provide a variable or global reference to store the PDF output file. Provide a variable or global reference to store the virtual path of the PDF output file. Click the button to complete the field mappings. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description.
- Click the "PDF Form file" button. Choose and upload the PDF file from the local folder. Note: The PDF file should include editable text fields.
- Click the Field Mappings button. A configuration pop-up window appears. Click the Add Row button to insert an empty row. Select the PDF field names from the drop-down list. Provide the variable or global reference that holds the value. You may insert multiple field mappings by using the Add Row button. Click the Save button.
- Click the “setPDFFormFields” step to configure its “Optional” properties. Select “On” to set the output PDF file to read-only. Click the Save button.
- The “Logging” configuration is necessary for documentation and also measures workflow progress and 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 it. Render the process instance. Click the process step to view its properties. The step should retrieve the virtual file URL path.
- The PDF file in this example contains the following field structure (for reference).
Configure:
This workflow step requires manual configuration of its data type. As an admin user, navigate to Administration > Data Types > Auto Detect. Select the data types for this step and configure them for your FlowWright environment, as shown in the graphic below.
As an admin user, go to Administration > Steps > Auto Detect. Select and configure the step for your FlowWright environment, as shown in the graphic below.
Definition Sample:
You may download the sample definition(s) from the link here and later import them (drag-and-drop) to your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.
Note: Please verify and complete the process steps for any missing configurations, such as file path references and database connections, after the import. Then, save the definition to confirm the changes.
Click here to download the sample file.