Configuration parameters - Configuration parameters - You can add configuration parameters to the imagenowforms.xml file or the embedded URL. The examples that appear in the following table show a format for the configuration parameter in the XML file and in the URL. - Perceptive Content - Perceptive Forms Server Installation and Setup Guide - Perceptive-Content/Perceptive-Forms-Server-Installation-and-Setup-Guide/Foundation-26.1/Perceptive-Forms-Server-Installation-and-Setup-Guide/Appendix-B-Forms-Configuration-files/About-Data-and-Configuration-parameters/Configuration-parameters - Foundation 26.1 - Foundation 26.1

Perceptive Forms Server Installation and Setup Guide

Platform
Perceptive Content
Product
Perceptive Forms Server Installation and Setup Guide
Release
Foundation 26.1
License
ft:lastPublication
2026-05-11T13:42:00.157853
ft:locale
en-US

You can add configuration parameters to the imagenowforms.xml file or the embedded URL. The examples that appear in the following table show a format for the configuration parameter in the XML file and in the URL.

Config Parameter Value Description
attachmentsActions Any combination of the following action names separated by a comma: save, reset, print, or attachments

Specifies the action the system performs when a user clicks the button. A button can perform multiple tasks. For example, the Attachments button can launch the attachments dialog and then save the form. The default value is attachments.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsActions" value="attachments,save"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsActions=attachments,save
attachmentsBorderColor CSS color name or an RGB value

Specifies the border color of the Attachments button that appears on the button bar at the bottom of the form. The default value is #C8C8C8.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsBorderColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsBorderColor=red
attachmentsColor CSS color name or an RGB value

Specifies the color for the Attachments button that appears on the button bar at the bottom of the form. The default value is #F0F0F0.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsColor=red
attachmentsMaximumCount Any non-negative 32-bit integer

Specifies the maximum number of files that can be attached to the form, and must be equal to, or larger than, attachmentsMinimumCount. This does not include any PDFs sent as attachments when the saveTransformAsAttachment parameter is set to true. The default is no limit.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsMaximumCount" value="5"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsMaximumCount=5
attachmentsMaximumSize Any non-negative 32-bit integer

Specifies the maximum file size for each attachment, in kilobytes. This does not include any PDFs sent as attachments when the saveTransformAsAttachment parameter is set to true. The default is no limit.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsMaximumSize" value="2147483646"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsMaximumSize=2147483646
attachmentsMinimumCount Any non-negative 32-bit integer

Specifies the minimum number of files that must be attached to submit the form, and must be equal to, or smaller than, attachmentsMaximumCount. This does not include any PDFs sent as attachments when the saveTransformAsAttachment parameter is set to true. The default is no limit.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsMinimumCount" value="1"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsMinimumCount=1
attachments Position An integer between 1 and 4

Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by 1, while 4 represents the last. The default value is 4.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsPosition" value="1"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsPosition=1
attachmentsText Any text

Specifies the text for the Attachments button that appears on the button bar at the bottom of the form.

Note: If you remove all text from the button, an icon appears to represent the attachments action.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsText" value="AddFile"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsText=Add%20File
attachmentsTextColor CSS color name or an RGB value

Specifies the color for the text on the Attachments button that appears on the button bar at the bottom of the form. The default value is #F0F0F0.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsTextColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsTextColor=red
attachmentsTooltip Any text

Specifies the text that appears when a user places the pointer over the Attachments button. The default value is Attachments.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsTooltip" value="Add Files"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsTooltip=Add%20Files
attachmentsTypes File type extension

Specifies the file extensions permitted for attachments, separated by commas. Do not include a leading period.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsTypes" value="pdf,jpg,png"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsTypes=pdf,jpg,png
attachmentsVisible

TRUE

FALSE

Specifies if the Attachments button appears on the button bar at the bottom of the form. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="attachmentsVisible" value="FALSE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsVisible=FALSE
barColor CSS color name or an RGB value

Specifies the color of the button bar that appears at the bottom of the form. The default color is #888888.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="barColor" value="green"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&barColor=green
displayStatus

TRUE

FALSE

Determines whether the system displays the form information at the bottom of the screen. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="displayStatus" value="FALSE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&displayStatus=FALSE
error Any text

Specifies the error message displayed when an error occurs submitting a form.

Note: If the error is from the Perceptive Content Server, the custom text from Forms Server does not appear.

Example:

  • <ConfigParams><ConfigParam name="error" value="Error%20submitting%20form"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&error=Error%20submitting%20form
fullScreenSuccess

TRUE

FALSE

Determines if the confirmation message after you submit a form is displayed on a new screen. If the value is FALSE, the message appears on the button bar of the submitted form. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="fullScreenSuccess" value="TRUE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&fullScreenSuccess=TRUE
height Pixels or percentage

Supplies the height of the web application within the parent web page. You can use either pixels or percentages for the value. For pixels, an example is width=250px. For percentage, an example is height=50%25. The %25 is the URL escape code for %.

Note: Scaling the application size larger can make the buttons inaccessible outside of the viewing area.

Examples:

  • <ConfigParams><ConfigParam name="height" value="250px"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&height=250px
printActions Any combination of the following action names separated by a comma: save, reset, print, or attachments

Specifies the action the system performs when a user clicks the button. A button can perform multiple tasks. For example, the Print button can print and then save the form. The default value is print.

Examples:

  • <ConfigParams><ConfigParam name="printActions" value="print,save"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printActions=print,save
printBorderColor CSS color name or an RGB value

Specifies the color for the Print button that appears on the button bar at the bottom of the form. The default value is #C8C8C8.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="printBorderColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printBorderColor=red
printColor CSS color name or an RGB value

Specifies the color for the Print button that appears on the button bar at the bottom of the form. The default value is #F0F0F0.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="printColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printColor=red
printPosition Any integer between 1 and 4

Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by 1, while 4 represents the last. The default value is 3.

Examples:

  • <ConfigParams><ConfigParam name="printPosition" value="1"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printPosition=1
printText Any text

Specifies the text for the Print button that appears on the button bar at the bottom of the form.

Note: If you remove all text from the button, an icon appears to represent the print action.

Examples:

  • < ConfigParams><ConfigParam name="printText" value="PrintForm"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printText=Print%20Form
printTextColor CSS color name or an RGB value

Specifies the color for the text on the Print button that appears on the button bar at the bottom of the form. The default value is black.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="printTextColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTextColor=red
printTooltip Any text

Specifies the text that appears when a user places the pointer over the Print button. The default value is Print Form.

Examples:

  • <ConfigParams><ConfigParam name="printTooltip" value="Print"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTooltip=Print
printTransform

TRUE

FALSE

Determines whether the system generates and opens a PDF in a new browser window when a user initiates a print action.

Note:
  • If the PDF file does not generate successfully, the Print dialog box appears in order to complete the print action.
  • PDF files display in a new browser window. To view, you must disable pop-up blockers.

Examples:

  • <ConfigParams><ConfigParam name="printTransform" value="TRUE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTransform=TRUE
printVisible

TRUE

FALSE

Specifies if the Print button appears on the button bar at the bottom of the form. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="printVisible" value="FALSE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&printVisible=FALSE
prompt Any text

Specifies the text in the message that displays when a user attempts to close the window without saving changes to a form.

Note: The promptOnClose parameter must be set to TRUE in order for the prompt parameter’s text to display.

The default message is “The form might contain unsaved data.”

Examples:

  • <ConfigParams><ConfigParam name="prompt" value="Save%20form%20now?"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&prompt=Save%20form%20now?
promptOnClose

TRUE

FALSE

Determines whether the message from the prompt parameter appears when a user attempts to close the window without saving. The default value is FALSE.

Examples:

  • <ConfigParams><ConfigParam name="promptOnClose" value="TRUE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&promptOnClose=TRUE
redirectUrl Any valid URL

After a user clicks the button to save the form, this parameter specifies a URL address to redirect the user. Save must be the last action configured on the button.

Note: The URL must include the “http://” or “https://” preface. You must use encodings to escape special characters.

Examples:

  • <ConfigParams><ConfigParam name= “redirectUrl” value=”http://www.perceptivesoftware.com”/> </ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&redirectUrl=http://www.perceptivesoftware.com
resetActions Any combination of the following action names separated by a comma: save, reset, print, or attachments

Specifies the action the system performs when a user clicks the button. A button can perform multiple tasks. For example, the Reset button can save and then reset the form. The default value is reset.

Examples:

  • <ConfigParams><ConfigParam name="resetActions" value="save,reset"/></ConfigParams>
  • http://localhost:8080/psw-conent-forms-server/fs?form=FormName&resetActions=save,reset
resetBorderColor CSS color name or an RGB value

Specifies the border color for the Reset button that appears on the button bar at the bottom of the form. The default value is #C8C8C8.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="resetBorderColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetBorderColor=red
resetColor CSS color name or an RGB value

Specifies the color for the Reset button that appears on the button bar at the bottom of the form. The default value is #F0F0F0.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="resetColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetColor=red
resetPosition Any integer between 1 and 4

Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by 1, while 4 represents the last. The default value is 2.

Examples:

  • <ConfigParams><ConfigParam name="resetPosition" value="1"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetPosition=1
resetText Any text

Specifies the text for the Reset button that appears on the button bar at the bottom of the form.

Note: If you remove all text from the button, an icon appears to represent the reset action.

Examples:

  • <ConfigParams><ConfigParam name="resetText" value="Clear"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetText=Clear
resetTextColor CSS color name or an RGB value

Specifies the color for the text on the Reset button that appears on the button bar at the bottom of the form. The default value is black.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values separated with commas as an RGB value. For example 255, 255, 255.

Examples:

  • <ConfigParams><ConfigParam name="resetTextColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetTextColor=red
resetTooltip Any text

Specifies the text that appears when a user places the pointer over the Reset button. The default value is Reset Form.

Examples:

  • <ConfigParams><ConfigParam name="resetTooltip" value="Clear"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetTooltip=Clear
resetVisible

TRUE

FALSE

Specifies if the Reset button appears on the button bar at the bottom of the form. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="resetVisible" value="FALSE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetVisible=FALSE
saveActions Any combination of the following action names separated by a comma: save, reset, print, or attachments

Specifies the action the system performs when a user clicks the button. A button can perform multiple tasks. For example, the Save button can print and then save the form. The default value is save.

Examples:

  • <ConfigParams><ConfigParam name="saveActions" value="print,save"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveActions=print,save
saveBorderColor CSS color name or an RGB value

Specifies the color for the Save button that appears on the button bar at the bottom of the form. The default value is #C8C8C8.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example, 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="saveBorderColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveBorderColor=red
saveColor CSS color name or an RGB value

Specifies the color for the Save button that appears on the button bar at the bottom of the form. The default value is #F0F0F0.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example, 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="saveColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveColor=red
savePosition An integer between 1 and 4

Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by 1, while 4 represents the last. The default value is 1.

Examples:

  • <ConfigParams><ConfigParam name="savePosition" value="2"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&savePosition=2
saveText Any text

Specifies the text for the Save button that appears on the button bar at the bottom of the form.

Note: If you remove all text from the button, an icon appears to represent the save action.

Examples:

  • <ConfigParams><ConfigParam name="saveText" value="SaveForm"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveText=Save%20Form
saveTextColor CSS color name or an RGB value

Specifies the color for the text on the Save button that appears on the button bar at the bottom of the form. The default value is black.

You can supply any CSS color name or RGB value recognized by the browser. For example, white, (255, 255, 255), #FFFFFF.

Forms Server recognizes any three decimal values, separated with commas, as an RGB value. For example 255,255,255.

Examples:

  • <ConfigParams><ConfigParam name="saveTextColor" value="red"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveTextColor=red
saveTooltip Any text

Specifies the text that appears when a user places the pointer over the Save button. The default value is Save Form.

Examples:

  • <ConfigParams><ConfigParam name="saveTooltip" value="save and submit"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveTooltip=save%20and%20submit
saveTransformAsAttachment

TRUE

FALSE

Determines whether the system sends a PDF as an attachment to Perceptive Content when a user performs a save action.

Examples:

  • <ConfigParams><ConfigParam name="saveTransformAsAttachment" value="TRUE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveTransformAsAttachment=TRUE
saveVisible

TRUE

FALSE

Specifies if the Save button appears on the button bar at the bottom of the form. The default value is TRUE.

Examples:

  • <ConfigParams><ConfigParam name="saveVisible" value="FALSE"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&saveVisible=FALSE
success Any text

Specifies the text message that displays when a form is successfully submitted.

Examples:

  • <ConfigParams><ConfigParam name="success" value="Success!"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&sucess=Success!
width Pixels or percentage Specifies the width of the web application within the parent web page. You can use either pixels or percentages for the value. For pixels, an example is width=250px. For percentage, an example is width=50%25. The %25 is the URL escape code for %.
Note: Scaling the application size larger can make the buttons inaccessible outside of the viewing area.

Examples:

  • <ConfigParams><ConfigParam name="width" value="250px"/></ConfigParams>
  • http://localhost:8080/psw-content-forms-server /fs?form=FormName&width=250px