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. You do not need to add the parameter to both places. If you add a parameter to the XML file and to the URL, the configuration parameter takes priority over the URL value unless you add a URL override parameter to the imagenowforms.xml file. - Perceptive Content - Form Designer - Perceptive-Content/Form-Designer/Foundation-26.1/Form-Designer-User-Help/Form-Designer-User-Help/Configure-Form-Designer/Configuration-parameters - Foundation 26.1

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. You do not need to add the parameter to both places. If you add a parameter to the XML file and to the URL, the configuration parameter takes priority over the URL value unless you add a URL override parameter to the imagenowforms.xml file.

attachmentsAction
Description: 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 box and then save the form. The default value is “attachments.”
Value: Any combination of the following action names separated by a comma: save, reset, print, or attachments.
Examples: <ConfigParams><ConfigParam name="attachmentsActions" value="attachments,save"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsActions=attachments,save

attachmentsBorderColor
Description: Specifies the border color for 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="attachmentsBorderColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsBorderColor=red

attachmentsColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="attachmentsColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsColor=red

attachmentsMaximumCount
Description: 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 saveTransformAsAttachments parameter is set to true. The default is no limit.
Value: Any non-negative 32-bit integer
Examples: <ConfigParams><ConfigParam name="attachmentsMaximumCount" value="5"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsMaximumCount=5

attachmentsMaximumSize
Description: Specifies the maximum size for each attachment, in kilobytes. This does not include any PDFs sent as attachments when the saveTransformAsAttachments parameter is set to true. The default is no limit.
Value: Any non-negative 32-bit integer
Examples: <ConfigParams><ConfigParam name="attachmentsMaximumSize" value="2147483646"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsMaximumSize=2147483646

attachmentsMinimumCount
Description: 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 saveTransformAsAttachments parameter is set to true. The default is no limit.
Value: Any non-negative 32-bit integer
Examples: <ConfigParams><ConfigParam name="attachmentsMinimumCount" value="1"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsMinimumCount=1

attachmentsPosition
Description: Specifies the placement of the button in regards to the other buttons. The first button in a row is represented by the number 1, while 4 represents the last button in the row. The default value is 4.
Value: An integer between 1 and 4
Examples: <ConfigParams><ConfigParam name="attachmentsPosition" value="1"/></ConfigParams>; http://localhost:8080/psw-content-forms-server /fs?form=FormName&attachmentsPosition=1

attachmentsText
Description: 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.
Value: Any text
Examples: <ConfigParams><ConfigParam name="attachmentsText" value="AddFile"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsText=Add%20File

attachmentsTextColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="attachmentsTextColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsTextColor=red

attachmentsTooltip
Description: Specifies the text that appears when a user places the pointer over the Attachments button. The default value is “attachments.”
Value: Any text
Examples: <ConfigParams><ConfigParam name="attachmentsTooltip" value="Add Files"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsTooltip=Add%20Files

attachmentsTypes
Description: Specifies the file extensions permitted for attachments, separated by commas. Do not include a leading period.
Value: File type extension
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
Description: Specifies whether the Attachments button appears on the button bar at the bottom of the form. The default value is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="attachmentsVisible" value="FALSE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&attachmentsVisible=FALSE

barColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="barColor" value="green"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&barColor=green

displayStatus
Description: Determines whether the system displays the form information at the bottom of the screen. The default is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="displayStatus" value="FALSE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&displayStatus=FALSE

error
Description: Specifies the error message that displays when there is an error submitting a form. However, if the error is from Perceptive Content Server, the text from the Forms Server text does not appear.
Value: Any text
Examples: <ConfigParams><ConfigParam name="error" value="Error%20submitting%20form"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&error=Error%20submitting%20form

fullScreenSuccess
Description: Determines whether the configuration message displays on a new screen after you submit the form. If the value is FALSE, the message appears on the button bar of the submitted form. The default is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="fullScreenSuccess" value="TRUE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&fullScreenSuccess=TRUE

height
Description: 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.
Value: Pixels or percentage
Examples: <ConfigParams><ConfigParam name="height" value="250px"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&height=250px

printActions
Description: 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.”
Value: Any combination of the following action names separated by a comma: save, reset, print, or attachments.
Examples: <ConfigParams><ConfigParam name="printActions" value="print,save"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printActions=print,save

printBorderColor
Description: Specifies the color of the Print button that appears at the bottom bar of the form. The default color 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="printBorderColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printBorderColor=red

printColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="printColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printColor=red

printPosition
Description: Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by the number 1, while 4 represents the last. The default value is 3.
Value: An integer between 1 and 4
Examples: <ConfigParams><ConfigParam name="printPosition" value="1"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printPosition=1

printText
Description: 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.
Value: Any text
Examples: <ConfigParams><ConfigParam name="printText" value="PrintForm"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printText=Print%20Form

printTextColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="printTextColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTextColor=red

printTooltip
Description: Specifies the text that appears when a user places the pointer over the Print button. The default value is Print Form.
Value: Any text
Examples: <ConfigParams><ConfigParam name="printTooltip" value="Print"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTooltip=Print

printTransform
Description: 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 to complete the print action. Also note that the PDF files display in a new browser window. To view the file, you must disable pop-up blockers.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="printTransform" value="TRUE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printTransform=TRUE

printVisible
Description: Specifies whether the Print button appears on the button bar at the bottom of the form. The default value is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="printVisible" value="FALSE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&printVisible=FALSE

prompt
Description: Specifies the text in the message that displays when a user attempts to close the window without saving changes to a form. The default message is “The form might contain unsaved data.”
Note: The promptOnClose parameter must be set to TRUE for the prompt parameter’s text to display.
Value: Any text
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
Description: Determines whether the message from the prompt parameter appears when a user attempts to close the window without saving. The default is FALSE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="promptOnClose" value="TRUE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&promptOnClose=TRUE

redirectUrl
Description: After a user clicks the button to save the form, the 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://” preface. You must use encodings to escape special characters.
Value: Any valid URL
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
Description: 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.”
Value: Any combination of the following action names separated by a comma: save, reset, print, or attachments.
Examples: <ConfigParams><ConfigParam name="resetActions" value="save,reset"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetActions=save,reset

resetBorderColor
Description: 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 #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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="resetBorderColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetBorderColor=red

resetColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="resetColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetColor=red

resetPosition
Description: Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by the number 1, while 4 represents the last button in the row. The default value is 2.
Value: An integer between 1 and 4
Examples: <ConfigParams><ConfigParam name="resetPosition" value="1"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetPosition=1

resetText
Description: 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.
Value: Any text
Examples: <ConfigParams><ConfigParam name="resetText" value="Clear"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetText=Clear

resetTextColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="resetTextColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetTextColor=red

resetTooltip
Description: Specifies the text that appears when a user places the pointer over the Reset button. The default value is Reset Form.
Value: Any text
Examples: <ConfigParams><ConfigParam name="resetTooltip" value="Clear"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetTooltip=Clear

resetVisible
Description: Specifies whether the Reset button appears on the button bar at the bottom of the form. The default value is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="resetVisible" value="FALSE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&resetVisible=FALSE

saveActions
Description: 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.”
Value: Any combination of the following action names separated by a comma: save, reset, print, or attachments.
Examples: <ConfigParams><ConfigParam name="saveActions" value="print,save"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveActions=print,save

saveBorderColor
Description: Specifies the border 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="saveBorderColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&asaveBorderColor=red

saveColor
Description: 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, For example, 255, 255, 255.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="saveColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveColor=red

savePosition
Description: Specifies the placement of the button in regard to the other buttons. The first button in a row is represented by the number 1, while 4 represents the last button in a row. The default value is 1.
Value: An integer between 1 and 4
Examples: <ConfigParams><ConfigParam name="savePosition" value="2"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&savePosition=2

saveText
Description: 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.
Value: Any text
Examples: <ConfigParams><ConfigParam name="saveText" value="SaveForm"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveText=Save%20Form

saveTextColor
Description: 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.
Value: CSS color name or an RGB value
Examples: <ConfigParams><ConfigParam name="saveTextColor" value="red"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveTextColor=red

saveTooltip
Description: Specifies the text that appears when a user places the pointer over the Save button. The default value is Save Form.
Value: Any text
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
Description: Determines whether the system sends a PDF as an attachment to Perceptive Content when a user performs a save action.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="saveTransformAsAttachment" value="TRUE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveTransformAsAttachment=TRUE

saveVisible
Description: Specifies whehter the Save button appears on the button bar at the bottom of the form. The default value is TRUE.
Value: TRUE or FALSE
Examples: <ConfigParams><ConfigParam name="saveVisible" value="FALSE"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&saveVisible=FALSE

success
Description: Specifies the text message that displays when a form is successfully submitted.
Value: Any text
Examples: <ConfigParams><ConfigParam name="success" value="Success!"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&sucess=Success!

width
Description: 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.
Value: Pixels or percentage
Examples: <ConfigParams><ConfigParam name="width" value="250px"/></ConfigParams>; http://localhost:8080/psw-content-forms-server/fs?form=FormName&width=250px